Index of every page on this site: llms.txt
All skills
google avatar

/adk-agent-builder

@37de74d
by googlegoogle/adk-python22k stars
4,392
Run it yourself

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`).

Use this Skill: https://skilld.dev/gh/google/adk-python/adk-agent-builder

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈190 tokens for metadata: the name and description. ≈683 when used: this file. ≈24k more on demand in 17 files.

Description uses 9.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈761 characters, or 9.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.14.0. If a symbol is missing at runtime, read the source under src/google/adk/ rather than guessing a neighbouring name.

Start here

Task Reference
First agent, environment, adk CLI getting-started.md
Which import path is the canonical one import-paths.md
The rules that cause most runtime failures best-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

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts3d3 checks · Risk SAFE
  • Gen Agent Trust Hub3d

    This skill provides comprehensive documentation and reference materials for building agents using the Google Agent Development Kit (ADK). It covers workflow orchestration, tool integration, testing, and development best practices. No security issues were identified during the analysis.

  • Socket3d

    No alerts

  • Snyk3d

    Risk: LOW · No issues

Signed by skilld at 37de74d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 4 days ago

README badge

README badge for google/adk-python/adk-agent-builder