Index of every page on this site: llms.txt
All skills
google avatar

/google-agents-cli-onboarding

@5fb62c2
by googlegoogle/skills24k stars
2,026
Run it yourself

Onboarding entrypoint for agents-cli in Agent Platform. It should be used when the user wants to "create a new agent", "develop an agent", "build an agent using ADK", "run the agent locally", "debug agent code", "test an agent", "evaluate an agent", "deploy an agent", "publish an agent", "monitor an agent", or needs the ADK (Agent Development Kit) development lifecycle.

Use this Skill: https://skilld.dev/gh/google/skills/google-agents-cli-onboarding

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈101 tokens for metadata: the name and description. ≈1k when used: this file. ≈481 more on demand in 1 file.

Description uses 5.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈403 characters, or 5.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

Attribution

MUST READ: Before executing any gcloud, REST API, or MCP command, you MUST read Usage Attribution. For commands executed directly in the terminal (never in generated scripts, Terraform, or user code), prefix gcloud with CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:google-agents-cli-onboarding)" and append agent-skills/1.0 (skill:google-agents-cli-onboarding) to User-Agent headers.

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:

  1. 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.
  2. Verify Installation: Run agents-cli info to confirm the installation and view the active project configuration.
  3. 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

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill acts as an onboarding guide for the Google Agents CLI. It includes several security considerations related to the installation and execution of external tools. These actions are aligned with the skill's purpose as an entry point for the Agent Development Kit (ADK) lifecycle. Users should review the linked official documentation and repositories during setup.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at 5fb62c2. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month
metadata
{
  "version": "1.0.1",
  "category": "DevOps"
}

README badge

README badge for google/skills/google-agents-cli-onboarding