google/agents-cli

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, state management, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or…

All-time #262 Trending #50 Hot #7 First seen Apr 21, 2026
8-week activity · all time api

Installation

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

Summary

  • Quick reference for ADK Python patterns: agents, tools, callbacks, and state management.
  • Covers agent creation with model and instruction configuration, basic tool definition via FunctionTool, and callback patterns for state initialization and lifecycle hooks Includes built-in tool imports, agent orchestration (SequentialAgent, ParallelAgent, LoopAgent), and state management through CallbackContext ADK 2.0 Workflow API available as opt-in experimental feature for graph-based pipelines with conditional routing and parallel processing; requires Python 3.11+ and explicit user consent before use Requires an existing scaffolded project; use agents-cli scaffold create or scaffold enhance before writing agent code

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed May 19, 2026

This skill serves as a comprehensive technical reference and cheatsheet for the Google Agent Development Kit (ADK). It provides developers with code patterns, configuration examples, and CLI commands for building AI agents. All referenced packages, tools, and documentation links are part of the official vendor ecosystem.

snyk MEDIUM

Analyzed May 19, 2026

[MEDIUM] W011: Third-party content exposure detected (indirect prompt injection risk).

socket Score 0.9000 · 0 alerts

Analyzed May 19, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from google/agents-cli.

npx skills add google/agents-cli

Browse all from google/agents-cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 5.9K
License LICENSE
Default branch main
Open issues 30
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.5.0
LicenseApache-2.0
More metadata
author
Google
license
Apache-2.0
version
1.5.0
requires
{"bins":["agents-cli"],"install":"uv tool install google-agents-cli"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,937 B
  • docs SUMMARY.md 576 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 164,400 installs

SKILL.md

ADK Code Reference

Activate /google-agents-cli-workflow first for required development phases and scaffolding steps.

1. Study Recipes (No Project Needed)

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.

The index only gives you a name; the recipe is the code. Clone it and read its AGENTS.md before you implement anything it covers. Hand-writing a Docker or E2B sandbox wrapper, a skill loader, a moderation callback or a memory store — for a capability the index lists — means you stopped at the name.

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>.
  3. Existing code: run agents-cli scaffold enhance ..

Language Support: This reference covers the Python ADK SDK. Support for other languages coming soon.

Quick Reference — Most Common Patterns

from google.adk.agents import Agent

def get_weather(city: str) -> dict:
    """Get current weather for a city."""
    return {"city": city, "temp": "22°C", "condition": "sunny"}

root_agent = Agent(
    name="my_agent",
    model="gemini-3.7-flash",
    instruction="You are a helpful assistant that ...",
    tools=[get_weather],
)

References

Use cheatsheets for common patterns. For deep knowledge, fetch the docs index or inspect the installed package.

Reference When to read
references/samples.md 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 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-workflows.md Graph-based Workflow API (ADK 2.0): nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology.
curl https://adk.dev/llms.txt Docs index (every page title + URL). Fetch it, then WebFetch the specific page for anything beyond the cheatsheets.
Installed ADK package 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