agents-cli is a command-line tool and collection of skills that guides coding assistants through building, evaluating, and deploying AI agents on Google's Gemini Enterprise Agent Platform. Developers use it with assistants such as Claude Code, Codex, and Antigravity CLI to work with Google Cloud agent services. The catalogue entries provide skills and a plugin for that development workflow.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add google/agents-cli --skill google-agents-cli-publishgit clone --depth 1 https://github.com/google/agents-cliWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/google/agents-cli/google-agents-cli-publish)<a href="https://agentmods.dev/skills/google/agents-cli/google-agents-cli-publish"><img src="https://agentmods.dev/badge/skills/google/agents-cli/google-agents-cli-publish/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/google/agents-cli/google-agents-cli-publish"><img src="https://agentmods.dev/badge/skills/google/agents-cli/google-agents-cli-publish.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- Socket pass
- Snyk pass
- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00142 | $0.02765 |
| Opus 5.5 | $0.00057 | $0.01106 |
| Sonnet 5.5 | $0.00028 | $0.00553 |
| Haiku 4.5 | $0.00014 | $0.00277 |
Grade A, and why
google-agents-cli-publish scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 211 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Gemini Registration
Requires: A deployed agent. For Agent Runtime in Gemini platform,
deployment_metadata.json(created byagents-cli deploy) enables auto-detection. For Cloud Run or GKE, provide the agent card URL and flags directly.
Prerequisites
- Agent must be deployed — the agent must be running and reachable
- Gemini app must exist — Create one in the Google Cloud console before registering
deployment_metadata.json(Agent Runtime only) — Created automatically byagents-cli deploy; contains the Agent Runtime ID, deployment target, the A2A flag, and the agent directory- Text-based agent — Live/voice (bidi) agents are not supported by the Gemini app, which has no
/run_livetransport. Register a text-based agent instead.
Required Permissions for A2A on Cloud Run
roles/run.servicesInvokergranted to the Discovery Engine service account (service-<PROJECT_NUMBER>@gcp-sa-discoveryengine.iam.gserviceaccount.com) on the Cloud Run service.
Registration Modes
A2A Registration
Every scaffolded agent serves the Agent-to-Agent protocol. A2A is the default — and only — registration type on Cloud Run and GKE (no reasoning engine to invoke natively). It also works on Agent Runtime via --registration-type a2a. For an ADK agent there the CLI warns against it, because the Gemini app can invoke Agent Runtime natively via :streamQuery — prefer ADK registration in that case. For an agent built on another framework there is no ADK app to invoke natively, so A2A is the right mode on every target and the warning is expected. Pass the agent card URL and the command fetches the card and registers it; display name and description default to the card's name/description.
# A2A on Cloud Run / GKE. The card path depends on the project's language:
# Python -> /a2a/{app_name}/.well-known/agent-card.json
# Go -> /.well-known/agent-card.json
agents-cli publish gemini \
--agent-card-url https://my-service-abc123.us-east1.run.app/a2a/app/.well-known/agent-card.json \
--gemini-app-id projects/123456/locations/global/collections/default_collection/engines/my-app
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago Changed · +2 lines · +1 tokens per session 08a2ceb98956
- 12d ago Changed 78e1b566647e
- 18d ago Changed · -6 lines c93439f83475
- 26d ago Changed · +1 lines 1469a0a15c74
- 1mo ago Changed · +2 lines 70368899c1a2
- 1mo ago Changed · +4 lines · -6 tokens per session 3b8a063f6a62
- 1mo ago First seen · 208 lines · 147 tokens per session scan A 8b85fed38437
google-agents-cli-publish is a skill published in the GitHub repository google/agents-cli (6,099 stars, last pushed 6d ago), licensed Apache-2.0. It adds 142 tokens to every session and 2,765 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
adk-student-evaluator
Acts as a student developer to evaluate ADK training modules. Follows a rigorous 5-step workflow to test labs and generate formal pedagogical reports. Use when asked to "evaluate", "test as a student", or "review" a training module.
adk-skill
Use this skill for developing agents using the Google Agent Development Kit (ADK) in Python. Provides guidelines, best practices, and documentation.
adk-go-self-review
Review an ADK Go change the way a maintainer will — a fresh-context pass over the whole diff, five lenses (correctness and tests, scope, simplicity, style, adk-python parity), and the mutation check that proves your tests pin the change. Use before opening a PR, before any later push that changes code, and when asked…
potpie-cli
Use when the task is centered on running, explaining, configuring, or troubleshooting the potpie command: doctor, login, pot management, source registration, resolve/search/record, graph workbench reads/writes, resource (document payload) commands, and pot scope behavior.
potpie-infra-architecture
Use for project infra and architecture context: environments, adapters, runtime configuration, deployments, service dependencies, datastores, API contracts, ownership, incidents, and dependency blast radius.
grocery-prices
A skill to calculate grocery prices with country-specific taxes.