Development & Code COMMUNITY New

Google Agents CLI Publish

You register an already deployed agent in your Gemini app with agents-cli and manage agents and MCP servers in Agent Registry.

Level ●● Intermediate
Saves looking up flags, resource names and the right registration mode
Version v1.13.0
Updated 2026-11-12
Available in: claude-codecoworkclaude-desktop

What is Google Agents CLI Publish?

Google Agents CLI Publish is a skill for Claude Code that walks you through publishing an AI agent to a Gemini app on Google Cloud. It explains the 'agents-cli publish gemini' command and its flags, the choice between ADK and A2A registration, and how to manage agents and MCP servers in Agent Registry. The skill belongs to the agents-cli series from Google.

For an ADK agent running in Agent Runtime, the command reads the deployment_metadata.json file created by 'agents-cli deploy' and picks up the runtime ID, target and registration mode from it. Often the Gemini app ID is then all you add. On Cloud Run or GKE you pass the agent card URL instead. Without extra options the command asks no questions, which suits CI/CD, while 'agents-cli publish gemini --interactive' prompts you for missing values step by step.

The skill is worth it for developers who run agents on Google Cloud. You need a running, reachable agent, a Gemini app you created beforehand in the Google Cloud console, and the agents-cli tool, which installs with 'uv tool install google-agents-cli'. The Gemini app does not support voice or live agents. Deployment itself is handled by the separate google-agents-cli-deploy skill.

Who it is for

Developers and platform teams who run AI agents on Google Cloud and want to offer them in Gemini or manage them in Agent Registry.

Use cases

  • You deployed an ADK agent to Agent Runtime with agents-cli and want to make it available to your team in the Gemini app.
  • Your pipeline should register the agent in Gemini automatically after every deployment, driven by environment variables.
  • You run an agent on Cloud Run and need to set up A2A registration, including the permission for the Discovery Engine service account.

What Google Agents CLI Publish does

ADK registration in Agent Runtime

Recommended when your agent is built with ADK and runs in Agent Runtime. Gemini calls it directly through its reasoning engine resource, so no agent card URL is required.

A2A registration via agent card

On Cloud Run and GKE you register through the Agent-to-Agent protocol. The command loads the agent card from the URL you give and reuses its name and description unless you override them.

Auto-detection from metadata

When deployment_metadata.json is present, the command reads the runtime ID, registration mode and deployment target on its own. In the simplest setup you add just the Gemini app ID.

CI/CD and interactive mode

With flags or environment variables the command runs without prompts inside pipelines. With 'agents-cli publish gemini --interactive' it lists Gemini apps and asks for missing values.

Agent Registry for agents and MCP servers

The skill covers Agent Registry (Preview), the project-wide catalog where you list, update or delete agents and MCP servers using gcloud.

Say this to activate the skill

"Publish my ADK agent to our Gemini app.""Register my Cloud Run agent with Gemini over A2A.""Set up Gemini registration for our CI/CD pipeline.""Show me the registered agents in Agent Registry."

Install

npx skills add google/agents-cli --skill google-agents-cli-publish

The command installs the original version from the author's repository (Vercel skills CLI, needs Node.js), add -g for all projects. We do not host a copy: updates come straight from the author. Need help with setup? How to install skills →

Figures with source and date

GitHub stars
≈ 6,300
Installs
566,740
On skills.sh since
21 Apr 2026
Last change in the repository
4 Nov 2026
Licence
Apache-2.0

As of 12 Nov 2026. Sources: GitHub, skills.sh. The figures change daily; we show the state of our last lookup.

Checked automatically

Version 1.13.0, checked on 12 Nov 2026.

  • Automated check on 2026-11-12 (revision 896e471): 1 files in the skill folder read by pattern search. It found no hidden characters, no instructions to override rules, no download-and-run and no access to credentials.

Independent checks on skills.sh, as of 12 Nov 2026

Gen Agent Trust Hub Pass
Socket Pass
Snyk Pass

Full results on skills.sh ↗

Good to know

  • You need an agent that is already deployed and reachable, plus a Gemini app you create beforehand in the Google Cloud console.
  • For A2A on Cloud Run, the Discovery Engine service account needs the roles/run.servicesInvoker role on the Cloud Run service.
  • According to the skill, Agent Registry is in Preview, and managing it with gcloud requires the roles/agentregistry.editor role.
  • The check is an automated pattern search, not a security guarantee, and reads the skill folder only. The command always installs the author's current version; later versions have not been reviewed by us.

Frequently asked questions about Google Agents CLI Publish

What is Google Agents CLI Publish?

Google Agents CLI Publish is a skill for Claude Code that helps you register deployed agents in a Gemini app using 'agents-cli publish gemini'. It covers ADK and A2A registration, the flags, Agent Registry and troubleshooting.

How do I install Google Agents CLI Publish?

You install Google Agents CLI Publish with 'npx skills add google/agents-cli --skill google-agents-cli-publish'. The skill relies on the agents-cli tool, which according to the skill installs with 'uv tool install google-agents-cli'.

Is Google Agents CLI Publish free?

Google Agents CLI Publish is released under the Apache-2.0 license and is free to use. The command works with a Google Cloud project whose ID is used for billing, so the cloud services you use may cost money.

Who is Google Agents CLI Publish for?

Google Agents CLI Publish suits teams that run agents with agents-cli on Agent Runtime, Cloud Run or GKE and want to offer them to users in Gemini or manage them centrally in Agent Registry.

How does Google Agents CLI Publish differ from google-agents-cli-deploy?

Google Agents CLI Publish handles the step after deployment and registers an agent that is already running in Gemini. Deployment itself is covered by the google-agents-cli-deploy skill, whose 'agents-cli deploy' command also writes the deployment_metadata.json file.

Which agents can Google Agents CLI Publish register?

Google Agents CLI Publish registers text-based agents, since the Gemini app does not support live or voice agents. ADK agents in Agent Runtime register natively as ADK, while agents from other frameworks register over A2A on Cloud Run or GKE.

Share this skill

About this skill

Google Agents CLI Publish comes from google and is an open-source project maintained by its author and community.

Author: google / github.com. Source: github.com/google/agents-cli/tree/main/skills/google-agents-cli-publish. Licence: Apache-2.0.

Curated by Collective Brain, an AI and automation digital agency from Hamburg, together with WhiteFox Automations. More vetted skills in the skills catalog.

Working in Germany, Austria or Switzerland? We help teams roll out Claude, in English or German.

Want this skill tailored to your team?

Google Agents CLI Publish is a strong starting point. A skill gets really powerful once it knows your workflows, templates and tone of voice. We build custom skills for teams, from analysis to rollout, and connect them to our work in AI consulting.

Request a custom skill →