# Google Agents CLI Workflow

Should be used when the user wants to "develop an agent", "build an agent using ADK"...

- Repository: https://github.com/google/agents-cli (6276 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/agents-cli --skill google-agents-cli-workflow -g -a claude-code -y`
Codex: `npx skills add google/agents-cli --skill google-agents-cli-workflow -g -a codex -y`
Cursor: `npx skills add google/agents-cli --skill google-agents-cli-workflow -g -a cursor -y`
Gemini CLI: `npx skills add google/agents-cli --skill google-agents-cli-workflow -g -a gemini-cli -y`

## Description

This skill should be used when the user wants to "develop an agent", "build an agent using ADK", "run the agent locally", "debug agent code", "test an agent", "deploy an agent", "publish an agent", "monitor an agent", or needs the ADK (Agent Development Kit) development lifecycle and coding guidelines. Entrypoint for building ADK agents. Always active, provides the full workflow (scaffold, build, evaluate, deploy, publish, observe), code preservation rules, model selection guidance, and troubleshooting steps for ADK or any agent development.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Agent Development Workflow & Guidelines

**agents-cli** is a CLI and skills toolkit for building, evaluating, and deploying agents on Google Cloud. It works with any coding agent, Antigravity CLI, Claude Code, Codex, or others, and with the agent framework of your choice (the [Agent Development Kit (ADK)](https://adk.dev/) by default). Install with `uvx google-agents-cli setup`.

> **Before writing agent code, make sure a scaffolded project exists (see Phase 2).** Skipping scaffolding loses eval boilerplate, CI/CD config, and project conventions.


> Requires: google-agents-cli ~= 1.12.0
> If version is behind, run: uv tool install "google-agents-cli~=1.12.0"

> Check version: agents-cli info
> [Install uv](https://docs.astral.sh/uv/getting-started/installation/index.md) first if needed.

## Session Continuity & Skill Cross-References

Re-read the relevant skill **before** each phase, not after you've already started and hit a problem. Context compaction may have dropped earlier skill content. If skills are not available, run `uvx google-agents-cli setup` to install them.

The rest: https://github.com/google/agents-cli/blob/HEAD/skills/google-agents-cli-workflow/SKILL.md