google-agents-cli-workflow

Guides the full ADK agent lifecycle from design through deployment using agents-cli.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/Aki2022/skills --skill google-agents-cli-workflow-aki2022
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-agents-cli-workflow
Source: https://github.com/Aki2022/skills/tree/main/google-agents-cli-workflow
Command: npx skills add https://github.com/Aki2022/skills --skill google-agents-cli-workflow-aki2022

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-agents-cli, and includes references (resource) components.

What problem does it solve? Building production agents with Google's Agent Development Kit involves many phases — design, scaffolding, coding, evaluation, deployment, publishing, and observability — and skipping steps leads to missing eval boilerplate, broken CI/CD, and untested behavior. This Skill orchestrates that entire workflow through the agents-cli toolkit so nothing critical is skipped. ## Core Features & Use Cases - Phased workflow orchestration: Walks through Phase 0 (design dialogue and spec) through Phase 7 (observability), cross-referencing the right sub-skill at each phase. - Code preservation and model selection rules: Enforces surgical code edits, prevents unwanted model changes, and provides commands to list current Gemini models. - Evaluation discipline: Distinguishes pytest (code correctness) from agents-cli eval (agent behavior), and forbids behavioral assertions on non-deterministic LLM output. - Use Case: A developer asks to build a customer-support agent with memory and guardrails. The Skill drives a design dialogue, writes .agents-cli-spec.md, points to matching clone-and-study recipes, scaffolds the project, and mandates an eval loop before any deployment. ## Quick Start Ask the assistant to develop an agent using ADK, for example: help me build and deploy an ADK agent that answers questions over our documentation.

Frequently Asked Questions about google-agents-cli-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and deploy an agent with Google ADK?

Follow the phased workflow: hold a design dialogue and write .agents-cli-spec.md, study matching recipes, scaffold with agents-cli scaffold create, implement the agent, run agents-cli eval until scores pass, then deploy with agents-cli deploy after explicit approval.

What is the difference between agents-cli eval and pytest for agents?

pytest tests code correctness such as imports and return types, while agents-cli eval tests agent behavior like response quality, tool usage, and safety compliance. Never write pytest assertions on LLM response content because outputs are non-deterministic.

How do I install the agents-cli tool?

Install it with uv tool install google-agents-cli, then run uvx google-agents-cli setup to install the companion skills. Check your installed version with agents-cli info.

Which deployment targets does agents-cli support?

agents-cli supports Agent Runtime (formerly Agent Engine), Cloud Run, and GKE as deployment targets. Set the target with agents-cli scaffold enhance . --deployment-target <target>, then run agents-cli deploy.

Why should I not change the model in scaffolded agent code?

The scaffolded model was chosen deliberately, and changing it without being asked violates the code preservation principle and often breaks the project through wrong locations or deprecated versions. Only change models when the user explicitly requests it.

What should I do when an agents-cli command fails repeatedly?

Stop after seeing the same error three times, then run agents-cli <command> --help to find the Source line pointing to the implementing file. Reproduce the error, localize the cause, fix one variable at a time, and verify with the exact reproduction command.