Back to Skills

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", or needs ADK (Agent Development Kit) Python API patterns and code examples. Part of the Google ADK skills suite. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, and state management. Do NOT use for creating new projects (use google-agents-cli-scaffold) or deployment (use go

2,079stars246forksUpdated 5/6/2026

Security Assessment

Low Risk(75/100)

Detected risks:

Secret Exposure([references/adk-python.md] secret=)
Sensitive File Access([references/adk-python.md] .env)
Security Score75/100

About google-agents-cli-adk-code

The `google-agents-cli-adk-code` skill provides developers with a focused reference for building and managing AI agents using the Google ADK (Agent Development Kit) Python SDK. It is specifically designed to guide users in writing agent code, defining agents, adding tools, creating callbacks, and managing state without the need to scaffold new projects or handle deployment tasks. By offering concise code examples and patterns, this skill helps developers streamline the process of implementing functional AI agents while adhering to best practices within the ADK ecosystem.

Key features of this skill include templates for agent creation, standard patterns for integrating tools, and examples of simple callbacks for state initialization. It emphasizes Python-based development and provides guidance on correct imports, model selection, and handling common errors such as model availability issues. Additionally, it includes references to experimental ADK 2.0 workflow APIs for advanced users who need graph-based orchestration, parallel processing, and conditional routing of tasks. The skill also points users to reference files covering the broader ADK API, including agents, tools, plugins, state management, context caching, and session rewind.

This skill is ideal for AI developers, data scientists, and software engineers who are already working within a scaffolded ADK project and need a quick, reliable reference for coding agents. It is particularly useful for those building intelligent assistants, tool-integrated workflows, or multi-step pipelines requiring structured state management and optional experimental workflow orchestration. By focusing on Python and practical code examples, it serves as a go-to resource for accelerating agent development while minimizing errors and ensuring consistency with Google ADK standards.

FAQ

Do I need to scaffold a project before using this skill?

Yes, you must have an existing scaffolded project. You can create one with `agents-cli scaffold create <name>` or enhance an existing project with `agents-cli scaffold enhance .`. Writing agent code without scaffolding is not supported.

Which programming languages are supported?

Currently, this skill supports Python only. Support for additional languages is planned for future releases.

Can I use this skill to deploy agents?

No, deployment is not handled by this skill. Use `google-agents-cli-deploy` for deployment tasks.

What should I do if a Gemini model returns a 404?

A 404 error usually indicates a `GOOGLE_CLOUD_LOCATION` issue. Verify model availability using the listing command before changing the model parameter.

Is the ADK 2.0 Workflow API recommended for general use?

No, it is experimental and pre-GA. Only suggest it to users who understand graph-based workflows and want to proceed with opt-in testing.

All Files

3 files
SKILL.md5.0 KB
View
references/adk-2.0.md19.3 KB
View
references/adk-python.md28.1 KB
View

Install google-agents-cli-adk-code

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill