SkillAgentSearch skills...

google-adk-python

You are an expert guide for Google's Agent Development Kit (ADK) Python - an open-source, code-first toolkit for building, evaluating, and deploying AI agents.

Install / Use

npx skills add mrgoonie/claudekit-skills --skill google-adk-python

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Category

Automation

Supported Platforms

Universal

Our assessment of google-adk-python

google-adk-python scores 88/100 on our quality scale, 1474th of 2,790 Automation skills we index.

Its SKILL.md is 6.6 KB long, well organised into 35 sections with 10 code examples: a thorough specification that gives an agent plenty to work with.

With 2,218 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
14/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 8 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-10-31 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 82/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

google-adk-python compared with similar skills

All 4 of these similar skills score higher than google-adk-python; compare them before choosing.

SkillScoreStarsUpdatedFormat
google-adk-python (this skill)by mrgoonie882.2k8mo agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md

Frequently asked questions

How do I install google-adk-python?
Run npx skills add mrgoonie/claudekit-skills --skill google-adk-python. The install tabs above show the steps for each supported agent.
Which AI agents does google-adk-python work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is google-adk-python safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 82/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is google-adk-python still maintained?
The repository was last updated about 8 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

Google ADK Python Skill

You are an expert guide for Google's Agent Development Kit (ADK) Python - an open-source, code-first toolkit for building, evaluating, and deploying AI agents.

When to Use This Skill

Use this skill when users need to:

  • Build AI agents with tool integration and orchestration capabilities
  • Create multi-agent systems with hierarchical coordination
  • Implement workflow agents (sequential, parallel, loop) for predictable pipelines
  • Integrate LLM-powered agents with Google Search, Code Execution, or custom tools
  • Deploy agents to Vertex AI Agent Engine, Cloud Run, or custom infrastructure
  • Evaluate and test agent performance systematically
  • Implement human-in-the-loop approval flows for tool execution

Core Concepts

Agent Types

LlmAgent: LLM-powered agents capable of dynamic routing and adaptive behavior

  • Define with name, model, instruction, description, and tools
  • Supports sub-agents for delegation and coordination
  • Intelligent decision-making based on context

Workflow Agents: Structured, predictable orchestration patterns

  • SequentialAgent: Execute agents in defined order
  • ParallelAgent: Run multiple agents concurrently
  • LoopAgent: Repeat execution with iteration logic

BaseAgent: Foundation for custom agent implementations

Key Components

Tools Ecosystem:

  • Pre-built tools (google_search, code_execution)
  • Custom Python functions as tools
  • OpenAPI specification integration
  • Tool confirmation flows for human approval

Multi-Agent Architecture:

  • Hierarchical agent composition
  • Specialized agents for specific domains
  • Coordinator agents for delegation

Installation

# Stable release (recommended)
pip install google-adk

# Development version (latest features)
pip install git+https://github.com/google/adk-python.git@main

Implementation Patterns

Single Agent with Tools

from google.adk.agents import LlmAgent
from google.adk.tools import google_search

agent = LlmAgent(
    name="search_assistant",
    model="gemini-2.5-flash",
    instruction="You are a helpful assistant that searches the web for information.",
    description="Search assistant for web queries",
    tools=[google_search]
)

Multi-Agent System

from google.adk.agents import LlmAgent

# Specialized agents
researcher = LlmAgent(
    name="Researcher",
    model="gemini-2.5-flash",
    instruction="Research topics thoroughly using web search.",
    tools=[google_search]
)

writer = LlmAgent(
    name="Writer",
    model="gemini-2.5-flash",
    instruction="Write clear, engaging content based on research.",
)

# Coordinator agent
coordinator = LlmAgent(
    name="Coordinator",
    model="gemini-2.5-flash",
    instruction="Delegate tasks to researcher and writer agents.",
    sub_agents=[researcher, writer]
)

Custom Tool Creation

from google.adk.tools import Tool

def calculate_sum(a: int, b: int) -> int:
    """Calculate the sum of two numbers."""
    return a + b

# Convert function to tool
sum_tool = Tool.from_function(calculate_sum)

agent = LlmAgent(
    name="calculator",
    model="gemini-2.5-flash",
    tools=[sum_tool]
)

Sequential Workflow

from google.adk.agents import SequentialAgent

workflow = SequentialAgent(
    name="research_workflow",
    agents=[researcher, summarizer, writer]
)

Parallel Workflow

from google.adk.agents import ParallelAgent

parallel_research = ParallelAgent(
    name="parallel_research",
    agents=[web_researcher, paper_researcher, expert_researcher]
)

Human-in-the-Loop

from google.adk.tools import google_search

# Tool with confirmation required
agent = LlmAgent(
    name="careful_searcher",
    model="gemini-2.5-flash",
    tools=[google_search],
    tool_confirmation=True  # Requires approval before execution
)

Deployment Options

Cloud Run Deployment

# Containerize agent
docker build -t my-agent .

# Deploy to Cloud Run
gcloud run deploy my-agent --image my-agent

Vertex AI Agent Engine

# Deploy to Vertex AI for scalable agent hosting
# Integrates with Google Cloud's managed infrastructure

Custom Infrastructure

# Run agents locally or on custom servers
# Full control over deployment environment

Model Support

Optimized for Gemini:

  • gemini-2.5-flash
  • gemini-2.5-pro
  • gemini-1.5-flash
  • gemini-1.5-pro

Model Agnostic: While optimized for Gemini, ADK supports other LLM providers through standard APIs.

Best Practices

  1. Code-First Philosophy: Define agents in Python for version control, testing, and flexibility
  2. Modular Design: Create specialized agents for specific domains, compose into systems
  3. Tool Integration: Leverage pre-built tools, extend with custom functions
  4. Evaluation: Test agents systematically against test cases
  5. Safety: Implement confirmation flows for sensitive operations
  6. Hierarchical Structure: Use coordinator agents for complex multi-agent workflows
  7. Workflow Selection: Choose workflow agents for predictable pipelines, LLM agents for dynamic routing

Common Use Cases

  • Research Assistants: Web search + summarization + report generation
  • Code Assistants: Code execution + documentation + debugging
  • Customer Support: Query routing + knowledge base + escalation
  • Content Creation: Research + writing + editing pipelines
  • Data Analysis: Data fetching + processing + visualization
  • Task Automation: Multi-step workflows with conditional logic

Development UI

ADK includes built-in interface for:

  • Testing agent behavior interactively
  • Debugging tool calls and responses
  • Evaluating agent performance
  • Iterating on agent design

Resources

  • GitHub: https://github.com/google/adk-python
  • Documentation: https://google.github.io/adk-docs/
  • llms.txt: https://raw.githubusercontent.com/google/adk-python/refs/heads/main/llms.txt

Implementation Workflow

When implementing ADK-based agents:

  1. Define Requirements: Identify agent capabilities and tools needed
  2. Choose Architecture: Single agent, multi-agent, or workflow-based
  3. Select Tools: Pre-built, custom functions, or OpenAPI integrations
  4. Implement Agents: Create agent definitions with instructions and tools
  5. Test Locally: Use development UI for iteration
  6. Add Evaluation: Create test cases for systematic validation
  7. Deploy: Choose Cloud Run, Vertex AI, or custom infrastructure
  8. Monitor: Track agent performance and iterate

Remember: ADK treats agent development like traditional software engineering - use version control, write tests, and follow engineering best practices.

Related Skills

View on GitHub
GitHub Stars2.2k
CategoryAutomation
Updated7mo ago
Forks423

Languages

Python

Trust signals

82/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 low