adk-fundamentals
Foundational knowledge for creating ADK (Agent Development Kit) agents including environment setup, project structure, and basic agent scaffolding. MUST BE USED for: new ADK agent creation, ADK project setup, environment configuration, AdkApp initialization, and understanding core ADK architecture.
npx skills add majiayu000/claude-skill-registry --skill adk-fundamentals --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# ADK Fundamentals: Agent Scaffolding and Setup ## Core Principles The Google Agent Development Kit (ADK) is an open-source Python framework for building production-grade AI agents with Vertex AI integration. ADK provides structured patterns for tool creation, state management, and multi-agent orchestration. ## Environment Setup (Required Pattern) ### Step 1: Create Python Environment with uv ADK requires Python 3.13+ and modern dependency management. Use `uv` for fast, reliable environment setup: ```bash # Install uv if not already installed curl -LsSf https://astral.sh/uv/install.sh | sh # Create new project directory mkdir my-agent-project cd my-agent-project # Initialize Python 3.13 project uv init --python 3.13 # Install ADK uv pip install google-adk # Install supporting libraries uv pip install pydantic>=2.12 python-dotenv asyncio ``` ### Step 2: Configure Vertex AI Environment Create a `.env` file for Vertex AI configuration: ```bash # .env GOOGLE_CLOUD_PROJECT=your-gcp-project-id GOOGLE_CLOUD_LOCATION=us-central1 GOOGLE_GENAI_USE_VERTEXAI=True # Optional: Authentication GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json ``` Load environment variables in your c
- Core Principles
- Environment Setup (Required Pattern)
- Step 1: Create Python Environment with uv
- Step 2: Configure Vertex AI Environment
- Basic Agent Structure (Canonical Pattern)
- Minimal ADK Agent
- Agent with Tools (Production Pattern)
- Project Directory Structure (Recommended)
- Key ADK Concepts
- 1. LlmAgent vs WorkflowAgent
- 2. Session State
- 3. Memory Service
- Anti-Patterns to Avoid
- ❌ Blocking I/O in Tools
Install uv if not already installed curl -LsSf https://astral.sh/uv/install.sh | sh Create new project directory mkdir my-agent-project cd my-agent-project Initialize Python 3.13 project uv init --python 3.13 Install ADK uv pip install google-adk Install supporting libraries
What does the adk-fundamentals skill do?
Foundational knowledge for creating ADK (Agent Development Kit) agents including environment setup, project structure, and basic agent scaffolding. MUST BE USED for: new ADK agent creation, ADK project setup, environment configuration, AdkApp initialization, and understanding core ADK architecture.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill adk-fundamentals --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.