google/google-agents-cli-onboarding

[!TIP] One-Time Setup: To install the CLI and enable all 7 specialized development skills in your coding agent, run the setup command:
uvx google-agents-cli setup
Alternatively, to install only the expert skills and let the agent handle execution:
npx skills add google/agents-cli

Overview

This skill serves as the entrypoint for agents-cli — Google's toolkit for building, evaluating, and deploying AI agents on the Gemini Enterprise Agent Platform.

Use this skill to perform the initial setup and identify the correct specialized workflows for your task.

The Agent Development Lifecycle

After running the setup, the following specialized skills become available and will activate automatically based on your requests. Use this table to identify which skill to load for your current phase:

Phase	Specialized Skill	Purpose / When to Load
0 — Understand	`google-agents-cli-workflow`	Clarify intent. Define the agent spec in `.agents-cli-spec.md` before coding.
1 — Study	`google-agents-cli-workflow`	Leverage samples. Study existing agent samples (e.g., `ambient-expense`) before scaffolding.
2 — Scaffold	`google-agents-cli-scaffold`	Create/Enhance. Initialize the project structure, CI/CD, and infrastructure templates.
3 — Build	`google-agents-cli-adk-code`	Implement. Write agent logic, tools, callbacks, and manage state using ADK APIs.
4 — Evaluate	`google-agents-cli-eval`	Validate Quality. Run systematic evaluations (LLM-as-judge).
5 — Deploy	`google-agents-cli-deploy`	Go Production. Deploy to Agent Runtime (Vertex AI), Cloud Run, or GKE.
6 — Publish	`google-agents-cli-publish`	Register. Make your agent available as a tool in Gemini Enterprise.
7 — Observe	`google-agents-cli-observability`	Monitor. Set up Cloud Trace, prompt-response logging, and BigQuery analytics.

Key CLI Commands

Below are the primary commands you will use throughout the development lifecycle:

Command	Description
`agents-cli setup`	Install the CLI and configure skills in your coding agent.
`agents-cli scaffold <name>`	Create a new agent project from a template.
`agents-cli eval run`	Run the agent and grade the traces in a single step (generate + grade).
`agents-cli deploy`	Deploy your agent to Google Cloud (Agent Runtime, Cloud Run, GKE).
`agents-cli publish gemini-enterprise`	Register your deployed agent with Gemini Enterprise.

For the full list of available commands and global options, run agents-cli --help.

Next Steps

Follow this sequence to initiate the development workflow:

Execute Setup: Run the uvx or npx command in the [!TIP] box above to install the CLI and enable the specialized skills in your environment.
Verify Installation: Run agents-cli info to confirm the installation and view the active project configuration.
Initiate Phase 0: Ask the user for their core requirements (agent purpose, external tools, deployment target) and document them in .agents-cli-spec.md before writing any code.

Reporting Issues

Report bugs or improvements at Google Agents CLI Issues.

Supporting Links

Google Agents CLI Documentation

Files1

1 files · 11.1 KB

Select a file to preview

Overall Score

78/100

Grade

B

Good

Safety

88

Quality

76

Clarity

82

Completeness

68

Summary

This is an onboarding skill for Google's agents-cli tool that directs developers through the initial setup and lifecycle of AI agent development. It serves as a navigation guide pointing users to 7 specialized downstream skills, from project scaffolding through deployment and observability. The skill is primarily educational and instruction-based with no code execution or file manipulation.

Static Analysis Findings

1 finding

Patterns detected by deterministic static analysis before AI scoring. Hover over any finding code for detailed information and remediation guidance.

Command Injection

SEC-011Dynamic Shell Eval

Shell eval/exec of dynamic content

SKILL.mdeval`

80% confidenceCWE-94: Code Injection

Detected Capabilities

cli setup guidancedocumentation referenceworkflow navigation

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

set up agents clicreate new agentagent development lifecycleagents-cli setupagent onboardingadk development kitbuild ai agentdeploy agent

Risk Signals

INFO

Shell eval/exec of dynamic content mentioned in static scan (eval backtick pattern)

SKILL.md

INFO

Referenced pattern does not appear in actual content analysis — likely false positive from markdown code formatting

SKILL.md | Search for 'eval'

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comwww.apache.org

Use Cases

Set up agents-cli development environment
Navigate agent development lifecycle phases
Identify appropriate specialized skill for current development phase
Learn command reference for common agent tasks
Report issues with agents-cli tooling

Quality Notes

Skill is well-structured with clear phases mapped to specialized downstream skills
Lifecycle table provides explicit navigation for developers at each phase
Includes concrete next steps and verification commands
Issue reporting link and documentation links are provided
Skill intentionally scoped to setup and routing — not execution-focused, which is appropriate for entrypoint
Could benefit from troubleshooting section (what if setup fails, how to verify each phase)
No examples of output or error states shown

Model: claude-haiku-4-5-20251001Analyzed: Jun 28, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

google-agents-cli-onboarding