google avatar

Google Agents Cli Adk Code

This is your reference when you're actually writing ADK agent code in Python, not scaffolding or deploying. It covers the practical stuff: defining agents with models and instructions, creating FunctionTools, wiring up callbacks for state management, and importing ADK's built-in tools correctly. One smart choice here is the explicit warning about ADK 2.0's Workflow API, which gates experimental graph-based orchestration behind user opt-in since it's pre-GA and needs Python 3.11+. The skill also includes a clever gatekeeper that checks for an existing project before letting you write code, and a helpful debug command for dealing with Gemini 404 errors caused by region misconfigurations. Works best alongside the workflow and scaffold skills from the same suite.

skills.sh installs
560.7K
GitHub stars
6.3K
last updated
Aug 21, 2026

Install

$ npx -y skills add google/agents-cli --skill google-agents-cli-adk-code --agent claude-code

Installs into .claude/skills of the current project.

Files

ADK Code Reference

Activate /google-agents-cli-workflow first.

1. Study Recipes (No Project Needed)

Python — read the topic index in references/recipes.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. No project: load /google-agents-cli-workflow and agree the spec with the user (its Phase 0) before you scaffold.
  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

Sponsors

Details

Repository
github.com/google/agents-cli
Categories
Backend & APIs, DevOps & CI/CD, AI & Agent Building, Release Management, Automation & Workflows, Python, CLI & Terminal
First seen
May 16, 2026

More from google/agents-cli

All 7
1google avatargoogle-agents-cli-evalgoogle/agents-cliThis skill should be used when the user wants to "run an evaluation", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval r558.9Kskills.sh installs
2google avatargoogle-agents-cli-observabilitygoogle/agents-cliThis skill should be used when the user wants to "set up tracing", "monitor my ADK agent", "configure logging", "add observability", "debug production traffic",558.7Kskills.sh installs
3microsoft avatarazure-upgrademicrosoft/azure-skillsAssess and upgrade Azure workloads between plans, tiers, or SKUs, or modernize Azure SDK dependencies in source code. WHEN: upgrade Consumption to Flex Consumpt555.8Kskills.sh installs
4xixu-me avataruse-my-browserxixu-me/skillsUse when work depends on the user's live browser session or visible rendered state rather than static fetches, especially for browser debugging contexts or DevT519Kskills.sh installs
5xixu-me avatarxgetxixu-me/skillsUse when tasks involve Xget URL rewriting, registry/package/container/API acceleration, integrating Xget into Git, download tools, package managers, container b517.1Kskills.sh installs
6larksuite avatarlark-maillarksuite/cli飞书邮箱:Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等;use for mail/email intent only. Do not use for docs/sheets/calen479.1Kskills.sh installs