# 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 deployment (use google-agents-cli-deploy).

Source: https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-adk-code
Repository: https://github.com/google/agents-cli
Author: google
License: Apache-2.0
Updated: hace 10 días
Context cost: 136 tok installed, 984 tok once triggered, 16.6k tok with every bundled file
Bundle: 4 files, 65 KB
Permissions requested: none declared

## Install

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

## What it does

- Provee patrones de referencia de la API Python de ADK: tipos de agente, definición de tools, callbacks, orquestación y manejo de estado
- Indexa recetas de referencia en references/samples.md que mapean una capacidad a código de implementación ya trabajado
- Da un cheatsheet rápido de código con el patrón Agent + tools más común

## Use it when

- El usuario quiere "escribir código de agente", "construir un agente con ADK", "agregar un tool", "crear un callback" o "usar state management"
- Se necesita un patrón de API Python de ADK o un ejemplo de código concreto
- Antes de implementar algo, para revisar si existe una receta equivalente en references/samples.md

## Don't bother when

- Para scaffolding de proyectos (usar google-agents-cli-scaffold)
- Para deployment (usar google-agents-cli-deploy)

## What triggers it

- "¿Cómo agrego un tool personalizado a mi agente con ADK?"
- "Escribe el código de un callback de moderación para mi agente"
- "¿Cómo defino un agente con estado usando ADK en Python?"
- "Necesito un patrón de orquestación con SequentialAgent"

## Before you install

- Requiere el binario agents-cli (uv tool install google-agents-cli) y un proyecto ya escafoldado antes de escribir código de agente.

## Files

- SKILL.md — 4 KB
- references/adk-python.md — 36 KB
- references/adk-workflows.md — 17 KB
- references/samples.md — 8 KB

## SKILL.md

Reproduced verbatim from google/agents-cli under Apache-2.0. This section is the upstream document and is in English.

# 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

```python
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.6-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

---

Skills Agentes — https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-adk-code