Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add google/agents-cli --skill google-agents-cli-adk-code -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/google-agents-cli-adk-code/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/google-agents-cli-adk-code/

From the same set7

The whole set →

Similar

caveman-compress JuliusBrussee Rewrites CLAUDE.md and todo files into terse caveman-speak so the model reads fewer input tokens. The source gets overwritten; a readable backup stays out of tree. Claude Code CX Codex Cursor +1 410,300installs caveman-stats JuliusBrussee Displays recorded output and cache-read tokens for Claude Code sessions or points to host native usage stats. Useful for tracking raw token consumption. Claude Code CX Codex Cursor +1 356,700installs karpathy-guidelines multica-ai Guidelines that cut typical LLM coding mistakes: less overcomplication, surgical edits, verifiable outcomes. Claude Code CX Codex Cursor +1 42,500installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. Claude Code Claude.ai 414,180installs writing-for-agents Matt Pocock Guidance for writing skills and agent-facing documents. Use it when editing AGENTS.md, CLAUDE.md, or reference files reached from them. Claude Code 466,719installs media-use heygen-com Finds or generates media for HyperFrames videos, including voiceovers, music, cutouts, and color grades. Stores files locally in assets. Claude Code CX Codex Cursor +1 1,100,000installs mcp-builder official anthropics This skill walks through building an MCP server in TypeScript or Python, from reading the protocol spec to writing tests and evaluation questions. Claude Code Claude.ai 130,949installs subagent-driven-development Jesse Vincent This skill runs an implementation plan through fresh subagents for independent tasks and reviews each result. Use it for multi-step work in one session. Claude Code CX Codex 237,746installs

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

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor