Where to Find Documentation for google/skills: Complete Guide to Agent Skills

All documentation for google/skills lives directly in the repository as Markdown files, with the README.md serving as the master index and individual SKILL.md files containing detailed tutorials for each capability.

The google/skills repository is a curated collection of Agent Skills—modular, Markdown-based tutorials and recipes that enable AI agents to work with Google Cloud, AI/ML pipelines, advertising products, and other Google services. Unlike traditional documentation sites, google/skills embeds all documentation within the repository itself, making it version-controlled and directly accessible.

Where Documentation Is Located in the Repository

The google/skills repository follows a predictable structure that places documentation at three key levels.

Repository-Level Documentation: README.md

The primary entry point is the top-level [README.md](https://github.com/google/skills/blob/main/README.md). This file enumerates the complete catalogue of available skills and provides relative links to each skill's detailed documentation.

According to the google/skills source code, the README is generated to stay synchronized with the actual skill directories, ensuring the index never drifts from the available content.

Individual Skill Documentation: SKILL.md Files

Each skill contains its own documentation at a standardized path:

skills/<category>/<skill-name>/SKILL.md

Specific examples from the repository include:

• Google Cloud authentication tutorial: [skills/cloud/google-cloud-recipe-auth/SKILL.md](https://github.com/google/skills/blob/main/skills/cloud/google-cloud-recipe-auth/SKILL.md)
• BigQuery AI/ML capabilities: skills/cloud/bigquery-ai-ml/SKILL.md
• Google Mobile Ads SDK guide: skills/ads/google-mobile-ads-get-started/SKILL.md

Reference Materials and Plugins

Supplementary documentation lives alongside skills in dedicated subdirectories:

• references/ — Contains setup guides, CLI usage instructions, and Terraform examples
• plugins/ — Documentation for agent harness integrations (Claude, Codex, Antigravity, Data Agent Kit)

How to Access and Browse google/skills Documentation

Method 1: Web Browser (GitHub UI)

Navigate directly using this URL pattern:

https://github.com/google/skills/blob/main/<skill-path>/SKILL.md

For example, the authentication skill is accessible at: https://github.com/google/skills/blob/main/skills/cloud/google-cloud-recipe-auth/SKILL.md

Method 2: Command-Line Interface

Install the official skills CLI to browse and run skills locally:

# Install the google/skills repository (adds all skills)

npx skills add google/skills

# List available skills (matches README catalogue)

skills list

# Run a specific skill interactively

skills run google-cloud-recipe-auth

Method 3: Programmatic Access

Execute skills from Node.js applications:

const { execSync } = require('child_process');

// Run a skill and capture structured output
function runSkill(name) {
  const cmd = `npx skills run ${name}`;
  return execSync(cmd, { encoding: 'utf8' });
}

console.log(runSkill('google-cloud-recipe-auth'));

Key Documentation Files in google/skills

Path	Purpose
[README.md](https://github.com/google/skills/blob/main/README.md)	Master index with links to all skills
CONTRIBUTING.md	Guidelines for submitting new skills or documentation fixes
skills/cloud/google-cloud-recipe-auth/SKILL.md	Authentication patterns for Google Cloud
skills/cloud/bigquery-ai-ml/SKILL.md	BigQuery AI/ML integration tutorials
skills/ads/google-mobile-ads-get-started/SKILL.md	Mobile Ads SDK implementation
plugins/cloud/data-agent-kit/README.md	Data Agent Kit plugin configuration

Summary

• Primary documentation location: The README.md at repository root serves as the canonical index for all google/skills documentation.
• Individual skill docs: Each skill's SKILL.md file contains step-by-step tutorials stored at skills/<category>/<skill-name>/SKILL.md.
• Three access methods: GitHub web UI, npx skills CLI, or programmatic execution via Node.js.
• Reference materials: Additional guides live in references/ subdirectories and plugins/ documentation.

Frequently Asked Questions

Does google/skills have a separate documentation website?

No. The google/skills repository intentionally keeps all documentation in Markdown files within the repository. This approach ensures documentation stays version-controlled with the code and remains accessible through GitHub's native rendering, the skills CLI, or plugin marketplaces.

How do I find the right skill for my use case?

Run skills list after installing the repository, or browse the categorized table in [README.md](https://github.com/google/skills/blob/main/README.md). Skills are organized by product domain—cloud/, ads/, ai/, etc.—making it straightforward to locate relevant documentation.

Can I contribute new documentation to google/skills?

Yes. The [CONTRIBUTING.md](https://github.com/google/skills/blob/main/CONTRIBUTING.md) file specifies the required structure for new skills, including the mandatory SKILL.md format, references/ directory conventions, and plugin integration patterns. All submissions follow the same Markdown-based documentation standard.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}