google-agents-cli-publish Skill for Claude: Register an Agent With Gemini

Teaches Claude to register a deployed agent with Gemini using agents-cli publish gemini, and to manage Agent Registry entries.

Installs: 532.9K; on skills.sh
Stars: 6.3K; on GitHub
Updated: Oct 2026; last repo commit

google-agents-cli-publish covers one command: agents-cli publish gemini. It registers a deployed agent with Gemini in two modes, A2A and ADK, in either programmatic or interactive form. A2A is the default and only type on Cloud Run and GKE.

It needs a deployed agent and a Gemini app already created in the Google Cloud console. It also lists the Agent Registry commands, using gcloud agent-registry, for listing, updating and deleting agents and for registering an external MCP server.

Good for

Teams with a deployed ADK agent who want it in Gemini
Platform admins managing agents and MCP servers in Agent Registry
CI/CD owners scripting registration

Install google-agents-cli-publish

Claude Code

Copy this prompt.

Install the google-agents-cli-publish skill in Claude Code. Run this command:

uvx google-agents-cli setup

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Python 3.11+, uv, Node.js.

Pick one route. setup installs the agents-cli program and the skills into your coding agent. The README says that with the skills-only route your coding agent handles the rest. The seven skills in the suite point to each other, so take the whole set.

From the project README. Source.

What's in the skill

When it loads

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).

Sections in SKILL.md

Prerequisites
Required Permissions for A2A on Cloud Run
Registration Modes
A2A Registration
ADK Registration (default on Agent Runtime)
Programmatic Mode (CI/CD)
Via flags
Via environment variables
Interactive Mode (--interactive)
Complete Flag Reference
Auto-Detection from Metadata
Agent Registry (agents and MCP servers)
Troubleshooting
Related Skills

Key facts

Author: Google
License: Apache-2.0 (stated in SKILL.md)
GitHub stars: 6,276 for the whole google/agents-cli repo (Nov 2, 2026)
Last commit: Oct 27, 2026
What installs: SKILL.md only; bundles no other files
Needs: A deployed agent; a Gemini app; agents-cli; the other skills in the suite
Part of: The google-agents-cli plugin in google/agents-cli
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Works in: Antigravity CLI, Claude Code, Codex and other coding agents (README)

What it includes

Registers by agent card; the default on Cloud Run and GKE
Runs code · A2A registration
The default on Agent Runtime, using deployment_metadata.json
Runs code · ADK registration
Flags or environment variables, for CI/CD
Runs code · Programmatic mode
agents-cli publish gemini --interactive
Runs code · Interactive mode
gcloud agent-registry list, update, create and delete
Includes registering an external MCP server from a toolspec.json file.
Delete · Agent Registry
Common registration errors
Read · Troubleshooting

From the official docs

Permissions

Medium risk

Claude registers your agent with Gemini and can run registry commands that update or delete entries. Confirm the agent name before you approve each command.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Registry commands can delete registered agents
The skill lists gcloud agent-registry delete commands. Confirm the name before you approve.
It needs IAM changes for A2A on Cloud Run
It names a Discovery Engine service account that needs roles/run.servicesInvoker. Grant it only on the service you are registering.

Technical details

Scopes	Registers your agent with Gemini Needs IAM roles such as run.servicesInvoker for A2A on Cloud Run Registry commands can update and delete registered agents

Questions

What does google-agents-cli-publish do?

It teaches Claude to register a deployed agent with Gemini using agents-cli publish gemini, and to manage entries in Agent Registry.

How do I install it?

Use the install box at the top of this page. The setup command installs the agents-cli program and all seven skills in the suite, which is what you want. The README says that with the skills-only route your coding agent handles the rest. You need Python 3.11+, uv and Node.js first.

What do I need before publishing?

A deployed agent and a Gemini app created in the Google Cloud console. Agent Runtime deploys also produce deployment_metadata.json, which enables auto-detection.

Does it work for voice agents?

No. The SKILL.md says live or voice agents are not supported by the Gemini app. Register a text-based agent instead.

Is it safe?

It registers agents and can run registry deletes, so confirm each command. skills.sh lists Gen Agent Trust Hub, Socket and Snyk as pass.

Does it need an API key?

The SKILL.md names no API key. It needs the agents-cli program and a Google Cloud sign-in, which agents-cli login handles; the README says login also supports AI Studio.

Does it work in the Claude app, Codex or Cursor?

The README names Antigravity CLI, Claude Code and Codex, and says any other coding agent works too. It does not name the Claude desktop or web app or Cursor.

Information

updated Nov 2, 2026

Repository: google/agents-cli
Folder: skills/google-agents-cli-publish

google/agents-cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

google/agents-cli README · github.com
google-agents-cli-publish SKILL.md · github.com
google-agents-cli-publish on skills.sh · skills.sh