# What Is the Primary Purpose of the google/skills Repository? A Complete Guide to Agent Skills for Google Cloud

> Explore the google/skills repository to understand how Agent Skills streamline Google Cloud management. Authenticate, provision, and manage services using natural language.

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

---

**The google/skills repository provides a curated library of markdown-based "Agent Skills" that enable AI agents to authenticate, provision, and manage Google Cloud services and products through natural language instructions.**

The `google/skills` repository serves as **the central source of ready-to-use, maintainable knowledge that powers AI agents when interacting with Google services**. According to the [google/skills source code](https://github.com/google/skills/blob/main/README.md), these skills function as reusable recipes that developers can plug into agent harnesses like Claude Code, Codex, and Antigravity CLI to automate complex operational workflows.

## What Are Agent Skills?

Agent Skills are **self-contained markdown files** (or folders of markdown files) that describe step-by-step recipes for completing specific tasks. Each skill typically includes:

- CLI commands for direct execution
- Code snippets in multiple languages
- Explanatory notes and prerequisites
- Authentication and configuration steps

The skills cover domains spanning **Cloud infrastructure** (GKE, Cloud Run), **AI/ML** (Gemini, Agent Platform), **databases** (AlloyDB, BigQuery), **security**, **observability**, and even advertising SDKs.

## How the google/skills Repository Works

### Content Format and Structure

Every skill in the `google/skills` repository follows a consistent markdown-based format. The repository organizes skills under the `skills/` directory, with subdirectories grouping related functionality.

For example, the authenticating-to-Google-Cloud skill resides at:

```

skills/cloud/google-cloud-recipe-auth/README.md

```

Similarly, GKE cluster creation guidance lives at:

```

skills/cloud/gke-cluster-creation/README.md

```

### Discovery and Installation

The root [`README.md`](https://github.com/google/skills/blob/main/README.md) provides a complete **skill index** in the "Available Skills" section. Users can install the entire skill package or select individual capabilities.

**Install the full skill package:**

```bash
npx skills add google/skills

```

This command pulls the repository into your local project and makes all listed skills available for selection.

### Plugin Integration with Agent Harnesses

The `google/skills` repository ships with **plugins** that expose skills to various agent harnesses. A harness loads the plugin and invokes any skill by name.

**Load as a Claude Code plugin:**

```bash
claude plugin marketplace add google/skills
claude plugin install <plugin>@google-plugins

```

After installation, Claude can execute any skill—for example, `google-cloud-recipe-auth`—directly from the conversation.

## Practical Usage Examples

### Running Skills from the Command Line

Execute a specific skill directly using the `npx skills run` command:

```bash
npx skills run google-cloud-recipe-auth

```

This reads the markdown recipe at [`skills/cloud/google-cloud-recipe-auth/README.md`](https://github.com/google/skills/blob/main/skills/cloud/google-cloud-recipe-auth/README.md) and follows its instructions automatically.

### Programmatic Skill Execution

Reference skills in your JavaScript applications using the `skills` package:

```javascript
const {executeSkill} = require('skills');

// Run the GKE cluster creation skill
executeSkill('gke-cluster-creation')
  .then(result => console.log('Skill completed:', result))
  .catch(err => console.error('Skill failed:', err));

```

The `executeSkill` helper loads the markdown definition from [`skills/cloud/gke-cluster-creation/README.md`](https://github.com/google/skills/blob/main/skills/cloud/gke-cluster-creation/README.md) and runs its embedded commands.

## Key Files in the Repository

Understanding the repository structure helps developers navigate and extend the `google/skills` codebase:

| File | Role |
|------|------|
| [`README.md`](https://github.com/google/skills/blob/main/README.md) (root) | Overview, installation instructions, complete skill index |
| [`skills/cloud/google-cloud-recipe-auth/README.md`](https://github.com/google/skills/blob/main/skills/cloud/google-cloud-recipe-auth/README.md) | Example skill: authenticating to Google Cloud |
| [`skills/cloud/gke-cluster-creation/README.md`](https://github.com/google/skills/blob/main/skills/cloud/gke-cluster-creation/README.md) | Example skill: creating a GKE cluster |
| [`plugins/README.md`](https://github.com/google/skills/blob/main/plugins/README.md) | Documentation of plugin usage for agent harnesses |
| `LICENSE` | Apache 2.0 license governing reuse and contributions |

## Extensibility and Community Contributions

The `google/skills` repository encourages **community-driven expansion**. New skills can be added by contributing additional markdown folders under `skills/…`. The Apache 2.0 license permits broad reuse and modification.

This extensibility model ensures the skill library grows to cover emerging Google products and evolving operational patterns.

## Summary

- **Primary purpose**: The `google/skills` repository provides **reusable, versioned AI-agent-ready instructions** for automating Google Cloud and Google product tasks.
- **Core format**: Markdown-based recipes with CLI commands, code snippets, and step-by-step guidance.
- **Integration paths**: `npx skills add`, Claude Code plugins, Codex, Antigravity CLI, and programmatic JavaScript execution.
- **Key locations**: Root [`README.md`](https://github.com/google/skills/blob/main/README.md) for discovery; `skills/` directory for skill definitions; [`plugins/README.md`](https://github.com/google/skills/blob/main/plugins/README.md) for harness integration.

## Frequently Asked Questions

### What types of tasks can google/skills automate?

The repository covers **authentication**, **resource provisioning**, **analytics execution**, **deployment management**, **logging configuration**, and operational tasks across Google Cloud, GKE, BigQuery, Gemini, AlloyDB, and more. Each skill targets a specific workflow with executable instructions.

### How do I add a custom skill to the google/skills repository?

Contribute by creating a new markdown folder under the appropriate `skills/` subdirectory. Follow the existing structure—include a [`README.md`](https://github.com/google/skills/blob/main/README.md) with step-by-step instructions, CLI commands, and code examples. Submit via pull request under the Apache 2.0 license.

### Can I use google/skills without Claude Code or Codex?

Yes. The `npx skills` CLI provides **harness-agnostic access**. Run `npx skills add google/skills` and `npx skills run <skill-name>` from any terminal, or import the `skills` package programmatically in Node.js applications.

### What is the difference between a skill and a plugin in google/skills?

**Skills** are the markdown instruction files themselves (the "what" and "how"). **Plugins** are the bridge code that exposes these skills to specific agent harnesses like Claude Code or Codex. The repository contains both, with plugins documented in [`plugins/README.md`](https://github.com/google/skills/blob/main/plugins/README.md).