Back to skills

Agent Skill

Google Agents Cli Adk Code

google-agents-cli-adk-code

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

GoogleAI/MLPythonAdkAgent-development-kitAgentsCoding-agentGeminiGemini-enterprise-agent-platformGenerative-aiGoogle-cloud
github.com/google/agents-cli/tree/main/skills/google-agents-cli-adk-code

287K installs

•

google/agents-cli

•

by Google

Score

8.5

/ 10

Installs

287K

Repo Stars

6.0K

Last Updated

4d ago

Fresh

Quality Ratio

95%

Description

Verified

Language

Python

First Published

Apr 2026

Summary

The Google Agents Cli Adk Code agent skill provides immediate Python code patterns and API guidance for developing AI agents with Google's Agent Development Kit (ADK), covering agent creation, tool definitions, callbacks, and state management. It is essential for Python developers working with Google's ADK who need quick access to established agent development patterns and best practices. This agent skill is a skill with 3K installs, indicating a solid user base within the ADK ecosystem. It directly offers Python snippets for creating `Agent` instances, defining basic `FunctionTool`s, and implementing simple `CallbackContext` for state initialization. The skill also provides critical operational advice, such as verifying model availability before changing an agent's model and outlining when to consider the experimental ADK 2.0 Workflow API for complex pipelines. A notable limitation is its current restriction to Python, with support for other languages indicated as coming soon, and the ADK 2.0 Workflow API being experimental and pre-GA.

Skill Definition

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/. 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> — add --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.

ReferenceLanguageWhen to read
references/samples.mdPythonTopic-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.mdPythonCore 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.mdPythonGraph-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-go.mdGoCore 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.mdGoGraph-based Workflow API: nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology.
examples/GoRunnable upstream programs — the closest thing to a recipe catalog for Go.
curl https://adk.dev/llms.txtPythonDocs index (every page title + URL). Fetch it, then WebFetch the specific page for anything beyond the cheatsheets.
Installed ADK packagePythonExact 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

How to Use

Use in O-mega

Claude Code

npx skills add google/agents-cli google-agents-cli-adk-code