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 #96 Trending #220 First seen Apr 21, 2026
8-week activity · all time api

Installation

$ npx skills add google/agents-cli --skill google-agents-cli-adk-code
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

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 Reviewed

Analyzed Oct 13, 2026

snyk Reviewed

Analyzed Oct 13, 2026

socket Score 0.9000 · 0 alerts

Analyzed Oct 13, 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