Official agent skill

Retrieving Developer Knowledge

by google in google/skills

Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms.

OfficialApache-2.0Auto-check passedBackend & APIs

Install Retrieving Developer Knowledge

skills CLI
$ npx skills add google/skills --skill retrieving-developer-knowledge -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install google/skills retrieving-developer-knowledge --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/google/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/developers/retrieving-developer-knowledge .claude/skills/retrieving-developer-knowledge && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
retrieving-developer-knowledge
GitHub stars
21k
Token cost
~2k tokens
SKILL.md length
808 words
Files
4 (incl. references)
Skills in repo
145
Repo updated
First seen
Licence
Apache-2.0

At a glance

Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms.

  • Works in 2 steps: Developer Knowledge MCP Tools (Preferred) → REST API Fallback
  • Searching for gcloud CLI commands
  • SKILL.md covers Workflow, Tool Selection & Usage, Synthesis & Output Guidelines and References
  • Calls curl and gcloud; reaches developerknowledge.googleapis.com; needs DEVELOPERKNOWLEDGE_API_KEY

What it does

Retrieving Developer Knowledge is an agent skill from google/skills, published by the product's own GitHub organization. Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms. Integrates with the Developer Knowledge MCP server (searchdocuments, getdocuments, answerquery) or the Developer Knowledge REST API fallback. Use when searching for gcloud CLI commands, API syntax, IAM permissions, official documentation, architectural comparisons, or product choice overviews. Don't use for local filesystem…

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/api-fallback.md`, `references/mcp-usage.md` and `references/supported-domains.md`).

It sits in Backend & APIs, covering REST APIs, Cross-platform mobile apps and MCP servers. It works with Google Cloud, Model Context Protocol, Firebase and Flutter. The repository describes itself as: Agent Skills for Google products and technologies. The licence is Apache-2.0.

When your agent uses it

  • Searching for gcloud CLI commands
  • IAM permissions
  • Official documentation
  • Architectural comparisons

Example prompts

  • “/retrieving-developer-knowledge”

Requirements

  • A credential in DEVELOPERKNOWLEDGE_API_KEY

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Developer Knowledge MCP Tools (Preferred)
  2. REST API Fallback

What it can do on your machine

Read from SKILL.md and the folder at commit 8a1ac05. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • gcloud

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • developerknowledge.googleapis.com

    Also links to:

    • developers.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DEVELOPERKNOWLEDGE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Retrieving Developer Knowledge loads about 2k tokens when it runs, and up to ~4.4k if it reads all its reference files. Until then it costs about 147 tokens; SKILL.md has 808 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~147
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from google/skills at commit 8a1ac05, republished under its Apache-2.0 licence (© google). 808 words, ~2,040 tokens.

Download SKILL.mdSave it as .claude/skills/retrieving-developer-knowledge/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
retrieving-developer-knowledge
description
Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms. Integrates with the Developer Knowledge MCP server (search_documents, get_documents, answer_query) or the Developer Knowledge REST API fallback. Use when searching for gcloud CLI commands, API syntax, IAM permissions, official documentation, architectural comparisons, or product choice overviews. Don't use for local filesystem lookups or non-Google documentation.
metadata.version
1.0.1
metadata.category
CloudInfrastructureAndServices

Google Developer Knowledge

The Developer Knowledge skill provides access to official Google developer documentation across Google Cloud, AI/ML (ai.google.dev, ADK, TensorFlow), Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms via the Developer Knowledge MCP server or REST API fallback.

Workflow

  1. Direct Retrieval: When answering a technical question, execute a single documentation lookup directly within your current conversation context (do not delegate retrieval to subagents):
    • If MCP tools are present in your environment: Call answer_query (for conceptual guides/workflows) or search_documents (for CLI flags/syntax).
    • If MCP tools are not present: Execute a REST API request via curl against https://developerknowledge.googleapis.com/v1.
    • A declared server is not always a connected server. Some clients cannot complete the MCP handshake with this server and expose no answer_query, search_documents or get_documents tool at all, even though the plugin declares one. Treat their absence as normal and use the REST fallback below.
  2. Confirm the lookup succeeded before using it: A response that arrives is not automatically an answer. PERMISSION_DENIED, UNAUTHENTICATED, HTTP 401 or 403, an empty result set, or any error payload is a FAILED lookup even when the tool itself reported no error. On a failed lookup, do not answer as though it had succeeded.
    • Rate Limits (HTTP 429 / Out of Quota): If calling answer_query or the REST :answerQuery endpoint returns an HTTP 429 (RESOURCE_EXHAUSTED / out of quota error), this indicates server-side generative QA quota exhaustion. Do not treat this as an unrecoverable failure or fall back to ungrounded memory; immediately retry using the search endpoint (search_documents for MCP, or documents:searchDocumentChunks for REST) with 2–5 focused keywords from the query.
    • Persistent Failures: Try the other transport once, and if that also fails, state plainly in your reply to the user that you could not reach Developer Knowledge and are answering without it. Presenting recalled documentation as a retrieved result is the worst available outcome, because nothing in the reply distinguishes it from a real lookup.
  3. Immediate & Complete Solution Output: Immediately upon receiving the documentation response, output the complete, self-contained, and executable technical solution (commands with all required flags and placeholders, YAML/JSON configurations, or code snippets) directly in your response text.

Tool Selection & Usage

Choose the appropriate tool based on availability in your runtime environment:

1. Developer Knowledge MCP Tools (Preferred)

When MCP tools are present in your active tool definitions:

  • answer_query(query="..."): Use for conceptual guides, architectural comparisons, product choice overviews, and multi-step workflows. This tool has limited quota. If you get a 429 out of quota error, use search_documents instead.
  • search_documents(query="..."): Use for granular CLI flags, exact syntax, parameter names, and IAM permissions (service.resource.verb). Use 2–5 focused keywords (e.g., cloud run filestore nfs mount gcloud) rather than full conversational sentences.
  • get_documents(names=["documents/{uri_without_scheme}"]): Fetch full documentation pages by resource name (e.g. names: ["documents/docs.cloud.google.com/run/docs/overview/what-is-cloud-run"]).
Show full SKILL.md (389 more words)Show less
2. REST API Fallback

When the MCP tools are absent, query the Developer Knowledge REST API (https://developerknowledge.googleapis.com/v1) with curl. Two credentials work, and you should try them in this order.

An existing Google credential, preferred. If gcloud is authenticated, pass a bearer token and your quota project. Nothing needs to be installed or configured:

bash
curl -s -X POST "https://developerknowledge.googleapis.com/v1:answerQuery" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: $(gcloud config get-value project 2>/dev/null)" \
  -H "Content-Type: application/json" \
  -d "{\"query\": \"How do I configure public read access on Cloud Storage?\"}"

If that fails to authenticate, on a 401, a 403, or any other credential error, the account has a token the API will not accept. Substitute gcloud auth application-default print-access-token for gcloud auth print-access-token in the command above and try again. Which credential the API accepts depends on how the environment was authenticated, so treat an auth error here as a reason to try the application-default credential rather than as a failed lookup.

An API key, if one is configured. Where DEVELOPERKNOWLEDGE_API_KEY is set in the environment, pass it as a key query parameter instead of an Authorization header. If neither credential is available, an API key is the supported path for this client: enable the API and create one by following the Developer Knowledge quickstart, then export it as DEVELOPERKNOWLEDGE_API_KEY. Say that you need a credential rather than answering without a lookup. The remaining examples in this section use that form:

  • Answer Query:
    bash
    curl -s -X POST "https://developerknowledge.googleapis.com/v1:answerQuery?key=${DEVELOPERKNOWLEDGE_API_KEY}" \
      -H "Content-Type: application/json" \
      -d '{"query": "How do I configure public read access on Cloud Storage?"}'
    This endpoint has limited quota. If you get a 429 out of quota error, use documents:searchDocumentChunks instead.
  • Search Document Chunks (use 2–5 focused keywords):
    bash
    curl -s "https://developerknowledge.googleapis.com/v1/documents:searchDocumentChunks?query=gcloud+logging+metrics+create&key=${DEVELOPERKNOWLEDGE_API_KEY}"
  • Get Document:
    bash
    curl -s "https://developerknowledge.googleapis.com/v1/documents/docs.cloud.google.com/run/docs/overview/what-is-cloud-run?key=${DEVELOPERKNOWLEDGE_API_KEY}"
  • Batch Get Documents (a GET, with one names parameter per document and no request body; up to 20 per call):
    bash
    curl -s -G "https://developerknowledge.googleapis.com/v1/documents:batchGet" \
      --data-urlencode "names=documents/docs.cloud.google.com/run/docs/overview/what-is-cloud-run" \
      --data-urlencode "names=documents/docs.cloud.google.com/storage/docs/creating-buckets" \
      --data-urlencode "key=${DEVELOPERKNOWLEDGE_API_KEY}"

Synthesis & Output Guidelines

  1. Grounding in Official Documentation: Ground all solutions directly in retrieved documentation. Official documentation conventions have absolute precedence over memorized defaults.
  2. Exact Parameter Formatting: Format CLI flags, composite keys (e.g. location=IP:PATH), and IAM permission strings according to official Google specifications.
  3. Complete Solutions in Final Response: Always output the full, self-contained, executable technical solution (commands, configurations, or code snippets) with clear standard placeholders (e.g. PROJECT_ID, SERVICE_NAME, REGION) directly in your final message, even if previously referenced during internal planning.

References

© google, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/developers/retrieving-developer-knowledge of google/skills.

  • SKILL.md
  • references/api-fallback.md
  • references/mcp-usage.md
  • references/supported-domains.md

Open the folder on GitHubat commit 8a1ac05

Compare with similar skills

Retrieving Developer Knowledge next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Retrieving Developer Knowledge compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Retrieving Developer Knowledge this skillgoogle/skills21k—~2kAutomated safety check: PassApache-2.0
Web3authWeb3Auth/web3auth-examples144—~1.4kAutomated safety check: PassMIT
NpgsqlrestNpgsqlRest/NpgsqlRest132—~7kAutomated safety check: NotesMIT
Flutter MCP Boundary AuditArenukvern/mcp_flutter385—~3kAutomated safety check: PassMIT
Flutter MCP Toolkit Custom ToolsArenukvern/mcp_flutter385—~1.9kAutomated safety check: PassMIT
Aaalice Dev SessionsAaalice233/Aaalice_NAI_Launcher187—~902Automated safety check: PassMIT

Similar skills

  • Web3auth

    Web3Auth/web3auth-examples

    Integrates MetaMask Embedded Wallets (Web3Auth) for non-custodial wallets via social login or custom JWT (Firebase, Auth0, Cognito).

    144 GitHub stars~1.4k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Npgsqlrest

    NpgsqlRest/NpgsqlRest

    Build and modify REST APIs with NpgsqlRest — exposing PostgreSQL as HTTP endpoints from two sources (database functions/procedures/tables/views, and plain .sql files), driven by SQL comment…

    132 GitHub stars~7k tokensUpdated 4 days ago
    DatabasesAuto-check: notes
  • Flutter MCP Boundary Audit

    Arenukvern/mcp_flutter

    Generic contract/schema boundary audit across authoring, discovery, validation, and execute—detecting split-brain between listings and invoke paths, gateway divergence, and permissive placeholders.

    385 GitHub stars~3k tokensUpdated 4 days ago
    MobileAuto-check passed
  • Flutter MCP Toolkit Custom Tools

    Arenukvern/mcp_flutter

    A skill your agent uses when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcptoolkit dynamic registry — AgentCallEntry, addEntries).

    385 GitHub stars~1.9k tokensUpdated 4 days ago
    MobileAuto-check passed
  • Aaalice Dev Sessions

    Aaalice233/Aaalice_NAI_Launcher

    管理 Aaalice NAI Launcher 项目专用的 Windows 与 Android Flutter 开发会话。用户提到 PC热重载、安卓热重载、启动/关闭/重建独立命令行窗口、模拟器启动异常或检查双端会话时使用。

    187 GitHub stars~902 tokensUpdated 2 days ago
    MobileAuto-check passed
  • MCP Dart Client

    leehack/mcp_dart

    A skill your agent uses when connecting a Dart or Flutter app to a Model Context Protocol (MCP) server with mcpdart: creating an McpClient, launching a local server over stdio or reaching a remote…

    116 GitHub stars~1.8k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from google/skills

All 145 skills in this repo
  • Official

    Manages Google Cloud Privileged Access Manager entitlements and grants: create and edit entitlements, request temporary access, and approve or deny pending grants.

    21k GitHub stars~3.2k tokensUpdated yesterday
    Auto-check passed
  • Official

    Writes Terraform alerting policies for AI agents that emit OpenTelemetry metrics, covering reliability, cost, safety, security and quality signals on Google Cloud.

    21k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Official

    Deploys open models or custom weights from Model Garden to Agent Platform endpoints, checks deployment status and cleans up endpoints, confirming before any change.

    21k GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed
  • Official

    Searches, manages and scaffolds skills in the Gemini Enterprise Agent Platform Skill Registry using bundled Python scripts and Google Cloud credentials.

    21k GitHub stars~584 tokensUpdated yesterday
    Auto-check passed
  • Designs GCP infrastructure as local Terraform, validates and scans it against best practices, then imports it to Application Design Center for deployment and troubleshooting.

    21k GitHub stars~4.4k tokensUpdated yesterday
    Auto-check passed
  • Official

    Analyzes BigQuery slot use, query costs and execution bottlenecks from INFORMATION_SCHEMA to diagnose slow queries, slot contention and unpartitioned scans.

    21k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed

Questions about Retrieving Developer Knowledge

What does Retrieving Developer Knowledge do?

Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms. Retrieving Developer Knowledge is an agent skill from google/skills, published by the product's own GitHub organization. Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms.

When should I use Retrieving Developer Knowledge?

Retrieving Developer Knowledge fits situations like: searching for gcloud CLI commands; IAM permissions; official documentation; architectural comparisons.

How do I install Retrieving Developer Knowledge in Claude Code?

Run `npx skills add google/skills --skill retrieving-developer-knowledge -a claude-code`. Or copy the skill folder (skills/developers/retrieving-developer-knowledge in google/skills) into .claude/skills/retrieving-developer-knowledge in your project. Claude Code loads it when a task matches its description.

How do I install Retrieving Developer Knowledge in Codex?

Run `npx skills add google/skills --skill retrieving-developer-knowledge -a codex`. Or copy the skill folder (skills/developers/retrieving-developer-knowledge in google/skills) into .agents/skills/retrieving-developer-knowledge in your project. Codex loads it when a task matches its description.

Can I use Retrieving Developer Knowledge in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add google/skills --skill retrieving-developer-knowledge -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/retrieving-developer-knowledge, .gemini/skills/retrieving-developer-knowledge, .github/skills/retrieving-developer-knowledge and .opencode/skills/retrieving-developer-knowledge in your project.

What does Retrieving Developer Knowledge need to run?

Going by SKILL.md and its folder, Retrieving Developer Knowledge needs the command-line tools its instructions call (curl and gcloud) and credentials named DEVELOPERKNOWLEDGE_API_KEY. Our summary lists: A credential in DEVELOPERKNOWLEDGE_API_KEY.

Does Retrieving Developer Knowledge access the network?

SKILL.md names 2 domains. In commands or code: developerknowledge.googleapis.com; the agent is likely to contact it when it follows the instructions. As links in the text: developers.google.com. This is read from the text; nothing was executed.

Is Retrieving Developer Knowledge safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Retrieving Developer Knowledge use?

Retrieving Developer Knowledge is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Retrieving Developer Knowledge use?

About 2k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Retrieving Developer Knowledge?

Skills that share tags, products or a category with Retrieving Developer Knowledge: Web3auth (Web3Auth/web3auth-examples, 144 stars), Npgsqlrest (NpgsqlRest/NpgsqlRest, 132 stars), Flutter MCP Boundary Audit (Arenukvern/mcp_flutter, 385 stars) and Flutter MCP Toolkit Custom Tools (Arenukvern/mcp_flutter, 385 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Retrieving Developer Knowledge?

google (a GitHub organization, an official publisher) maintains it in google/skills, which has 20,994 GitHub stars. The repository holds 145 skills in this directory. The repository was last updated on October 6, 2026.

Source: google/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.