google-cloud-developer plugin

The google-cloud-developer plugin equips AI coding agents with foundational skills, safety guardrails, and live documentation grounding for building on Google Cloud.

Built on the open Agent Plugins specification, this plugin bundles curated Agent Skills, routing rules, and configuration for the Developer Knowledge MCP server into a single portable package.

Installation

Antigravity CLI

Install the plugin directly via the CLI using its path in the Google Agent Skills repository:
```
agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer
```
Enable the Developer Knowledge API in your Google Cloud project by using the gcloud CLI:
```
gcloud services enable developerknowledge.googleapis.com --project=<YOUR_PROJECT_ID>
```

Claude Code

Add the Google plugins marketplace, then install the plugin:

claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-plugins

Enable the Developer Knowledge API in your Google Cloud project by using the gcloud CLI:
```
gcloud services enable developerknowledge.googleapis.com --project=<YOUR_PROJECT_ID>
```
Create an API key for the Developer Knowledge API by following the instructions Create and secure the API key. Save the key you create in a secure location.
Export the API key to your environment before starting Claude Code:
```
export DEVELOPERKNOWLEDGE_API_KEY=<YOUR_API_KEY>
```
Note

The DEVELOPERKNOWLEDGE_API_KEY environment variable needs to be set in the environment before you start Claude Code. You may consider adding this export to your shell's startup script (e.g. .bashrc, .zshrc) for convenience.

Codex CLI

Add the Google plugins marketplace, then install the plugin:

codex plugin marketplace add google/skills
codex plugin add google-cloud-developer@google-plugins

Enable the Developer Knowledge API in your Google Cloud project by using the gcloud CLI:
```
gcloud services enable developerknowledge.googleapis.com --project=<YOUR_PROJECT_ID>
```
Create an API key for the Developer Knowledge API by following the instructions Create and secure the API key. Save the key you create in a secure location.
Enable authenticated access to the Developer Knowledge MCP server by updating ~/.codex/config.toml (or your project's .codex/config.toml) to include the following lines:
```
[mcp_servers.developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  env_http_headers = { "X-Goog-Api-Key" = "DEVELOPERKNOWLEDGE_API_KEY" }
```
Export the API key to your environment before starting Codex:
```
export DEVELOPERKNOWLEDGE_API_KEY=<YOUR_API_KEY>
```
Note

The DEVELOPERKNOWLEDGE_API_KEY environment variable needs to be set in the environment before you start Codex. You may consider adding this export to your shell's startup script (e.g. .bashrc, .zshrc) for convenience.

Note

Note: After you change the configuration, the server may show a not logged in status. This is expected and won't affect your access.

What's Included

Bundled Skills

gcloud: Safety-critical validation, best practices, and execution guardrails for gcloud CLI commands.
google-cloud-recipe-auth: Authentication workflows, credential selection, and service identity best practices.
google-cloud-recipe-onboarding: First-project onboarding, account setup, and billing configuration.
finding-google-skills: Discovery and on-demand installation of specialized skills from the Google Agent Skills repo.
retrieving-developer-knowledge: Grounded retrieval of official Google documentation.

MCP Server

Developer Knowledge MCP server: Provides AI agents with up-to-date grounding in official Google developer documentation over streamable HTTP.

Routing Rules

google-cloud-discovery.md: Always-on routing map that guides the agent to discover and suggest deeper product-specific skills (such as gke-*, agent-platform-*, google-cloud-waf-*, and <product>-basics) when a task requires specialized domain knowledge beyond the foundational bundle.

Plugin in Action

To see how this plugin works, consider a situation where you're bootstrapping a new project as part of working on a script. With the google-cloud-developer plugin installed, you can prompt your agent:

I'm brand new to this platform, and I need to get an account and a first project with billing set up. Then, I need my local machine authenticated so a script that I'm writing can call the APIs as a service identity instead of as me.

Environment awareness: The agent silently runs background checks against your live environment for prerequisites like CLI availability and potential existing projects or organizations.
Review: The agent considers IAM best practices to avoid risks that might be assumed as part of the prompt, like accidental key leaks or git commits.
Interaction with guardrails: The agent outlines a workflow roadmap and offers to act on those steps before modifying any resources.