Google Agents CLI Publish
Should be used when the user wants to "publish an agent", "publish my ADK agent"...
Install
npx skills add google/agents-cli --skill google-agents-cli-publish -g -a claude-code -y- Repository
- google/agents-cli6.3k
- Category
- AI and agents
- Updated
- 8d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 2,687 tokens
- Runs scripts
- No, instructions only
What it does
This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).
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.
