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

> Find google/skills documentation directly in the repository. Discover README.md for the master index and SKILL.md for detailed capability tutorials.

- Repository: [Google/skills](https://github.com/google/skills)
- Tags: getting-started
- Published: 2026-08-14

---

**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)](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)](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`](https://github.com/google/skills/blob/main/skills/cloud/bigquery-ai-ml/SKILL.md)
- **Google Mobile Ads SDK guide**: [`skills/ads/google-mobile-ads-get-started/SKILL.md`](https://github.com/google/skills/blob/main/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:

```bash

# 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:

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

## Summary

- **Primary documentation location**: The [`README.md`](https://github.com/google/skills/blob/main/README.md) at repository root serves as the canonical index for all google/skills documentation.
- **Individual skill docs**: Each skill's [`SKILL.md`](https://github.com/google/skills/blob/main/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)](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)](https://github.com/google/skills/blob/main/CONTRIBUTING.md) file specifies the required structure for new skills, including the mandatory [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) format, `references/` directory conventions, and plugin integration patterns. All submissions follow the same Markdown-based documentation standard.