Cloud IX Team d9ed0bd5c4 Give the Developer Knowledge skill a transport that works, and make a failed lookup visible
On some clients the Developer Knowledge MCP server does not connect at all, and
the skill did not describe the situation its users are actually in.

The connection failure is structural rather than a misconfiguration. The
Claude-facing manifest declares the server with no auth method, so the client
follows the MCP authorization spec, discovers the protected-resource metadata,
and is pointed at Google as the authorization server. Completing that handshake
without a pre-registered client requires dynamic client registration, and
Google's discovery documents advertise no registration endpoint. The client
cannot mint an identity, the handshake ends, and no answer_query,
search_documents or get_documents tool is ever exposed. The skill previously
said a declared tool might return an error. The tools are not there to return
one.

The REST fallback is therefore the only transport on those clients, and the
skill documented it as needing an API key. It does not. The v1 REST API accepts
an ordinary Google bearer token, so anyone with an authenticated gcloud has a
working path already and needs nothing installed or configured. That form is now
shown first, with the API key kept as the alternative, and the REST fallback
reference is reordered to match so the two do not disagree. Where a bearer token is
refused, the note explains that the application-default credential often
succeeds where the account credential does not, because which one the API
accepts depends on how the environment was authenticated.

A verification step also now sits between retrieval and output. The skill told
an agent to answer immediately upon receiving the documentation response,
without checking that what came back was documentation. PERMISSION_DENIED,
UNAUTHENTICATED, HTTP 401 or 403, an empty result set, or any error payload is a
failed lookup even when the tool reported no error. On a failure the agent tries
the other transport once, and if that also fails it says it could not reach
Developer Knowledge and is answering without it.

PiperOrigin-RevId: 974811356
2026-09-01 18:05:59 -07:00
2026-06-12 13:00:28 -07:00
2026-09-01 10:44:14 -07:00
2026-04-13 16:25:00 +00:00
2026-08-31 13:30:45 -07:00

Agent Skills

Install via skills.sh

This repository contains Agent Skills for Google products and technologies, including Google Cloud.

Note

This repository is under active development.

Installation

npx skills add google/skills

From the npx install command, you can select the specific skills from this repo to install.

Available Skills

Additional Google skills

Plugins

This repo also bundles Google product plugins (Skills + MCP servers) for agent harnesses.

Agent harness Install
Claude Code claude plugin marketplace add google/skills, then claude plugin install <plugin>@google-plugins
Codex codex plugin marketplace add google/skills, then install from the /plugins browser
Antigravity CLI agy plugin install https://github.com/google/skills/<plugin-path>

Support

If you need help or encounter issues with these skills, search for existing issues or open a new one in the GitHub Issue Tracker.

Contributing

We welcome contributions to improve our skills. You can help by:

  • Reporting bugs or inaccuracies in the skill Markdown files.
  • Suggesting new skills to add to this repository (for example, Google technologies or recipes) by filing a feature request.

License

You are free to copy, modify, and distribute these skills under the terms of the Apache 2.0 license. See the LICENSE file for details.

S
Description
cloud-run-basics: Manages Cloud Run services, jobs, and worker pools. Use when you need to deploy applications responding to HTTP requests (services), run event-triggered or…; gemini-api: Use when the user asks about using Gemini in an enterprise environment or explicitly mentions Vertex AI, Google Cloud, or Agent Platform. Guides the usage of…; bigquery-basics: Manages datasets, tables, and jobs in BigQuery. Use when you need to interact with BigQuery, run SQL queries, manage BigQuery resource…
Readme Apache-2.0 3.2 MiB
Languages
Python 86.4%
Shell 8.3%
HCL 5.1%
Dockerfile 0.1%
JavaScript 0.1%