google-agents-cli-adk-code — Claude Code skill: ADK and setup
A reference skill for building ADK agents with tools, callbacks, state, and workflows. Use it when an agent project needs concrete API patterns or code examples.
npx skills add google/agents-cli --skill google-agents-cli-adk-code -a claude-codeWhat google-agents-cli-adk-code does
google-agents-cli-adk-code supports ADK coding after a project has been prepared. It covers agent types, tool definitions, orchestration, callbacks, state, artifacts, and multi-agent systems. Python references include the core API, graph workflows, and live agents. Go references cover the core API, graph workflows, and runnable upstream examples.
The workflow starts with agents-cli info to check the project. Create a new project with agents-cli scaffold create --agent adk --deployment-target , or enhance an existing one with agents-cli scaffold enhance .. The metadata lists uv tool install google-agents-cli for installing agents-cli. This skill is for writing ADK code, while scaffolding and deployment use separate skills.
Install it when you are implementing an ADK agent and need patterns to check against. Skip it for a task limited to project creation or deployment.
What it helps with
- define an agent with ADK
- add a tool or callback
- manage state across agent steps
- build sequential, parallel, or loop workflows
- find a Python or Go reference recipe
Example prompts for the agent
- Build a Python ADK agent with a data-handling tool.
- Add a callback and user state to this existing ADK project.
- Show a graph workflow with fan-out/fan-in, then check the project with `agents-cli info`.
How to install google-agents-cli-adk-code
1Skills CLI (Vercel)
npx skills add google/agents-cli --skill google-agents-cli-adk-code -a claude-code2Manually: put the files in place
~/.claude/skills/google-agents-cli-adk-code/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/google-agents-cli-adk-code/
1Skills CLI (Vercel)
npx skills add google/agents-cli --skill google-agents-cli-adk-code -a codex2Manually: put the files in place
.agents/skills/google-agents-cli-adk-code/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add google/agents-cli --skill google-agents-cli-adk-code -a cursor2Manually: put the files in place
.cursor/skills/google-agents-cli-adk-code/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install google/agents-cli google-agents-cli-adk-code2Manually: put the files in place
.github/skills/google-agents-cli-adk-code/SKILL.md1Skills CLI (Vercel)
npx skills add google/agents-cli --skill google-agents-cli-adk-code -a gemini-cli2Platform CLI
gemini skills install https://github.com/google/agents-cli --path skills/google-agents-cli-adk-codeManually: put the files in place
.devin/skills/google-agents-cli-adk-code/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add google/agents-cli --skill google-agents-cli-adk-code -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set7
The whole set →Similar
Questions about google-agents-cli-adk-code
How do I install google-agents-cli-adk-code in Claude Code?
Run npx skills add google/agents-cli --skill google-agents-cli-adk-code -a claude-code. The skill file is placed at ~/.claude/skills/google-agents-cli-adk-code/SKILL.md.
What does google-agents-cli-adk-code do?
It provides API references and code examples for ADK agents, tools, callbacks, state, orchestration, and graph workflows. The references cover Python and Go.
What should I do before writing ADK code?
Check the project with agents-cli info first. For a new project, use agents-cli scaffold create --agent adk --deployment-target ; for an existing project, use agents-cli scaffold enhance ..
Source text
SKILL.md · Apache-2.0
---
name: google-agents-cli-adk-code
description: >
This skill should be used when the user wants to "write agent code",
"build an agent with ADK", "add a tool", "create a callback", "define an agent",
"use state management" — in a project that needs ADK (Agent Development Kit) API
patterns and code examples.
It provides a quick reference for agent types, tool definitions, orchestration
patterns, callbacks, state management, the graph Workflow API, and reference
recipes to study.
Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment
(use google-agents-cli-deploy).
metadata:
author: Google
license: Apache-2.0
version: 1.11.0
requires:
bins:
- agents-cli
install: "uv tool install google-agents-cli"
---
# ADK Code Reference
Activate `/google-agents-cli-workflow` first for required development phases and scaffolding steps.
## 1. Study Recipes (No Project Needed)
**Python — read the topic index in `references/samples.md` before answering "how do I build X".**
Worked implementations exist for: sandboxed/per-user code execution, agent-loadable `SKILL.md`
skills, cross-session memory, approval gates before risky actions, tool guardrails, per-user
credentials, and scheduled/event-driven runs.
**Go — read the upstream [`examples/`](https://github.com/google/adk-go/tree/main/examples).**
clone the repo and read the one matching the capability you need before implementing it.
## 2. Prerequisites for Writing Code
Do NOT write agent code until a project is scaffolded.
1. Verify project: run `agents-cli info` (proceed if config exists).
2. New project: run `agents-cli scaffold create <name> --agent adk --deployment-target <target>` — use `--agent adk_go` for Go.
3. Existing code: run `agents-cli scaffold enhance .`.
## Quick Reference — Most Common Patterns
See `references/adk-python.md` and `references/adk-go.md` for Python and Go code examples, respectively.
---
## References
Use the cheatsheets for common patterns. For deep knowledge, fetch the docs index or inspect the
installed package.
| Reference | Language | When to read |
|------|------|-------------|
| `references/samples.md` | Python | **Topic-indexed catalog of ADK reference recipes.** Read in workflow Phase 1 — before scaffolding and before writing code — maps a capability to the recipe that implements it. |
| `references/adk-python.md` | Python | Core ADK API: `Agent`, tools, callbacks, plugins, state, artifacts, multi-agent systems, `SequentialAgent` / `ParallelAgent` / `LoopAgent`, custom `BaseAgent`, `ManagedAgent` (server-hosted first-party agents), A2A protocol, A2UI. Default for most agents. |
| `references/adk-python-workflows.md` | Python | Graph-based Workflow API (ADK Python 2.0): nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology. |
| `references/adk-python-live.md` | Python | Live and voice agents: `Runner.run_live`, `LiveRequestQueue`, model and regional availability, voice/`speech_config`, VAD, session limits, `/run_live` serving. Use for real-time voice or video agents. |
| `references/adk-go.md` | Go | Core ADK Go API: `llmagent`, tools, callbacks, plugins, state, artifacts, multi-agent systems, sequential/parallel/loop agents, custom agents, the runner, serving over HTTP, A2A protocol, and ambient triggers. Default for most agents. |
| `references/adk-go-workflows.md` | Go | Graph-based Workflow API: nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology. |
| [`examples/`](https://github.com/google/adk-go/tree/main/examples) | Go | Runnable upstream programs — the closest thing to a recipe catalog for Go. |
| `curl https://adk.dev/llms.txt` | Python | Docs index (every page title + URL). Fetch it, then `WebFetch` the specific page for anything beyond the cheatsheets. |
| Installed ADK package | Python | Exact signatures and symbols — inspect the source (see "Inspecting ADK Source Code" in `references/adk-python.md`). |
## Related Skills
- `/google-agents-cli-workflow` — Development workflow, coding guidelines, and operational rules
- `/google-agents-cli-scaffold` — Project creation and enhancement with `agents-cli scaffold create` / `scaffold enhance`
- `/google-agents-cli-eval` — Evaluation methodology, dataset schema, and the eval-fix loop
- `/google-agents-cli-deploy` — Deployment targets, CI/CD pipelines, and production workflows
© Google · Apache-2.0 · google/agents-cli