Official agent skill

Adk Agent Builder

by google in google/adk-python

Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between…

OfficialApache-2.0Auto-check passedAgent Workflows

Install Adk Agent Builder

skills CLI
$ npx skills add google/adk-python --skill adk-agent-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install google/adk-python adk-agent-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/google/adk-python.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/adk-agent-builder .claude/skills/adk-agent-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
adk-agent-builder
GitHub stars
22k
Token cost
~879 tokens
SKILL.md length
233 words
Files
18 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between…

  • Asked to create an agent
  • SKILL.md covers Start here, Building blocks, Graph orchestration and Runtime and verification
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Add a tool to one

What it does

Adk Agent Builder is an agent skill from google/adk-python, published by the product's own GitHub organization. Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between agents, human-in-the-loop pauses, and pytest coverage for all of it. Use when asked to create an agent or a workflow, add a tool to one, branch or loop between nodes, run steps in parallel, pause for user approval, or test an agent. Don't use for explaining how ADK works internally or designing its core components (use…

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including reference files (for example `references/advanced-patterns.md`, `references/best-practices.md` and `references/callbacks-and-plugins.md`).

It sits in Agent Workflows, covering Building AI agents, Human-in-the-loop approvals and Unit testing. It works with pytest and Python. The repository describes itself as: An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control. The licence is Apache-2.0.

When your agent uses it

  • Asked to create an agent
  • Add a tool to one
  • Loop between nodes
  • Run steps in parallel

Example prompts

  • “Use the adk-agent-builder skill to build ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent…”
  • “/adk-agent-builder”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 666c26d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Adk Agent Builder loads about 879 tokens when it runs, and up to ~25k if it reads all its reference files. Until then it costs about 190 tokens; SKILL.md has 233 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~190
When it runs · the whole SKILL.md, loaded when a task matches
~879
With references · SKILL.md plus every file in references/, read only if the agent opens them
~25k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from google/adk-python at commit 666c26d, republished under its Apache-2.0 licence (© google). 233 words, ~879 tokens.

Download SKILL.mdSave it as .claude/skills/adk-agent-builder/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
adk-agent-builder
description
Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between agents, human-in-the-loop pauses, and pytest coverage for all of it. Use when asked to create an agent or a workflow, add a tool to one, branch or loop between nodes, run steps in parallel, pause for user approval, or test an agent. Don't use for explaining how ADK works internally or designing its core components (use `adk-architecture`), for an agent that already runs but misbehaves (use `adk-debug`), for authoring a sample under `contributing/` (use `adk-sample-creator`), or for naming, typing, and formatting conventions (use `adk-style`).

ADK Agent Builder

Read only the reference that matches the task. Loading the whole tree costs context and buries the part that matters.

Every API below was checked against google-adk 2.6.2. If a symbol is missing at runtime, read the source under src/google/adk/ rather than guessing a neighbouring name.

Start here

TaskReference
First agent, environment, adk CLIgetting-started.md
Which import path is the canonical oneimport-paths.md
The rules that cause most runtime failuresbest-practices.md

Building blocks

  • tool-catalog.md — function tools, MCP, OpenAPI, Google API toolsets, built-in tools, custom BaseTool and BaseToolset.
  • function-nodes.md — plain functions as nodes: parameter resolution, generators, node_input typing rules.
  • llm-agent-nodes.md — an LlmAgent used as a workflow node: output types, instruction templates, output_schema, auto-wrapping behavior.
  • task-mode.md — mode='task' and mode='single_turn' delegation with schema-validated input and output.

Graph orchestration

  • routing-and-conditions.md — routed edges, dict routing maps, default routes, self-loops, revision loops.
  • parallel-and-fanout.md — fan-out edges, JoinNode fan-in, parallel_worker=True list processing.
  • dynamic-nodes.md — scheduling nodes at runtime with ctx.run_node() and imperative workflow construction.
  • human-in-the-loop.md — RequestInput, resume behavior, resumable vs replayed sessions.
  • advanced-patterns.md — nested workflows, retries, custom BaseNode subclasses, graph validation rules.
  • multi-agent.md — chat-transfer hierarchies, and the deprecated SequentialAgent / LoopAgent / ParallelAgent shells that Workflow replaces.

Runtime and verification

© google, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 17 other files (references) in .agents/skills/adk-agent-builder of google/adk-python.

  • SKILL.md
  • references/advanced-patterns.md
  • references/best-practices.md
  • references/callbacks-and-plugins.md
  • references/dynamic-nodes.md
  • references/function-nodes.md
  • references/getting-started.md
  • references/human-in-the-loop.md
  • references/import-paths.md
  • references/llm-agent-nodes.md
  • references/multi-agent.md
  • references/parallel-and-fanout.md
  • references/routing-and-conditions.md
  • references/session-and-state.md
  • references/state-and-events.md
  • references/task-mode.md
  • references/testing.md
  • references/tool-catalog.md

Open the folder on GitHubat commit 666c26d

Compare with similar skills

Adk Agent Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Adk Agent Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Adk Agent Builder this skillgoogle/adk-python22k—~879Automated safety check: PassApache-2.0
LexGuard MCP Developer GuideSeoNaRu/lexguard-mcp131—~1.1kAutomated safety check: PassCustom licence
AWS Strandshoodini/ai-agents-skills282—~1.4kAutomated safety check: PassNone
Swarms Multi-Agent Frameworkkyegomez/swarms7.2k—~5.5kAutomated safety check: PassApache-2.0
Agent Squad Python Guide2FastLabs/agent-squad7.8k—~4.7kAutomated safety check: PassApache-2.0
Langgraph Human In The Looplangchain-ai/langchain-skills1.3k2 repos~4.1kAutomated safety check: PassMIT

Similar skills

  • LexGuard MCP Developer Guide

    SeoNaRu/lexguard-mcp

    Developer guide for the LexGuard Korean law MCP server: layer rules, adding tools and repositories, JSON-RPC responses, law API handling, answer rules and tests.

    131 GitHub stars~1.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • AWS Strands

    hoodini/ai-agents-skills

    Build AI agents with the Strands Agents SDK - the open-source framework (the agent "brain") for writing agent logic, tools, and multi-agent systems in Python.

    282 GitHub stars~1.4k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Teaches the Swarms Python framework: the Agent class, tools, loops, memory and multi-agent structures such as sequential, concurrent and graph workflows.

    7.2k GitHub stars~5.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Agent Squad Python Guide

    2FastLabs/agent-squad

    Map of the agent-squad Python framework for async multi-agent orchestration: which agent, classifier, storage and tool provider to pick, and the pitfalls to avoid.

    7.8k GitHub stars~4.7k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Langgraph Human In The Loop

    langchain-ai/langchain-skills

    Official

    INVOKE THIS SKILL when implementing human-in-the-loop patterns, pausing for approval, or handling errors in LangGraph.

    1.3k GitHub starsUsed in 2 repos~4.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Deep Agents Core

    langchain-ai/langchain-skills

    Official

    Explains how to build agents with the Deep Agents framework: create_deep_agent, the built-in middleware, the harness, SKILL.md format and configuration options.

    1.3k GitHub starsUsed in 1 repo~3.1k tokens
    AI & LLM EngineeringAuto-check passed

More from google/adk-python

All 13 skills in this repo
  • Adk Verify Snippets

    google/adk-python

    Official

    Checks that every Python code block in a Markdown file actually compiles and runs, by extracting each block to a temporary file, executing it in an isolated subprocess, and writing a pass/fail…

    22k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Adk Sample Creator

    google/adk-python

    Official

    Creates a new sample agent in the ADK Python repository — the sample directory, its agent.py, and its README.md — following the conventions the existing samples already use.

    22k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Adk Unit Guide

    google/adk-python

    Official

    Writes a hands-on developer guide for one ADK code unit — a minimal runnable example, how it works, a configuration-option table, advanced uses, limitations, and links to related samples — to…

    22k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Adk Git

    google/adk-python

    Official

    Writes commit messages and pull request descriptions for the adk-python repository: Conventional Commits types and scopes, subject lines that say why a change was made, and the linked-issue and…

    22k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Adk Setup

    google/adk-python

    Official

    Sets up a local ADK Python development environment in a git clone of the open-source adk-python repository: a uv virtual environment, all dependency extras, pre-commit hooks, and a first unit-test…

    22k GitHub stars~993 tokensUpdated today
    Auto-check: notes
  • Adk Architecture

    google/adk-python

    Official

    Explains how the ADK runtime fits together: the node and graph execution model, Context and Event flow, checkpoint and resume, tracing, and the rules governing the public API surface.

    22k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Adk Agent Builder

What does Adk Agent Builder do?

Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between…. Adk Agent Builder is an agent skill from google/adk-python, published by the product's own GitHub organization. Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between agents, human-in-the-loop pauses, and pytest coverage for all of it.

When should I use Adk Agent Builder?

Adk Agent Builder fits situations like: asked to create an agent; add a tool to one; loop between nodes; run steps in parallel.

How do I install Adk Agent Builder in Claude Code?

Run `npx skills add google/adk-python --skill adk-agent-builder -a claude-code`. Or copy the skill folder (.agents/skills/adk-agent-builder in google/adk-python) into .claude/skills/adk-agent-builder in your project. Claude Code loads it when a task matches its description.

How do I install Adk Agent Builder in Codex?

Run `npx skills add google/adk-python --skill adk-agent-builder -a codex`. Or copy the skill folder (.agents/skills/adk-agent-builder in google/adk-python) into .agents/skills/adk-agent-builder in your project. Codex loads it when a task matches its description.

Can I use Adk Agent Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add google/adk-python --skill adk-agent-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adk-agent-builder, .gemini/skills/adk-agent-builder, .github/skills/adk-agent-builder and .opencode/skills/adk-agent-builder in your project.

What does Adk Agent Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Adk Agent Builder is instructions for the agent only. Our summary lists: Python 3.

Does Adk Agent Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Adk Agent Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Adk Agent Builder use?

Adk Agent Builder is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Adk Agent Builder use?

About 879 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 24k tokens, read only when the agent opens those files.

What are the alternatives to Adk Agent Builder?

Skills that share tags, products or a category with Adk Agent Builder: LexGuard MCP Developer Guide (SeoNaRu/lexguard-mcp, 131 stars), AWS Strands (hoodini/ai-agents-skills, 282 stars), Swarms Multi-Agent Framework (kyegomez/swarms, 7.2k stars) and Agent Squad Python Guide (2FastLabs/agent-squad, 7.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Adk Agent Builder?

google (a GitHub organization, an official publisher) maintains it in google/adk-python, which has 21,729 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 7, 2026.

Source: google/adk-python on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.