# How to Integrate `google/skills` with Claude Code: Complete Setup Guide

> Easily integrate google/skills with Claude Code. Follow our complete setup guide to add the Google Skills marketplace and install individual skills effortlessly.

- Repository: [Google/skills](https://github.com/google/skills)
- Tags: how-to-guide
- Published: 2026-09-05

---

**Add the Google Skills marketplace to Claude Code with `claude plugin marketplace add google/skills`, then install individual skills using `claude plugin install <skill>@google-plugins`.**

The `google/skills` repository contains a curated collection of **Agent Skills** designed for AI-powered development environments. These skills extend Claude Code—the command-line interface for Anthropic's Claude—with Google Cloud capabilities ranging from Cloud Storage management to BigQuery operations. This guide walks through the exact integration steps documented in the repository's source code.

## Prerequisites

Before integrating, ensure you have:

- Claude Code installed and authenticated
- A Google Cloud project with appropriate permissions (for skill operations)
- Node.js and `npx` available (referenced in [[`README.md`](https://github.com/google/skills/blob/main/README.md)](https://github.com/google/skills/blob/main/README.md) for alternative usage patterns)

## Add the Google Skills Marketplace

Claude Code discovers external skills through **plugin marketplaces**. The first integration step registers the `google/skills` repository as a trusted source.

Run this command in your Claude Code terminal:

```bash
claude plugin marketplace add google/skills

```

This command configures Claude Code to read the repository's [`index.json`](https://github.com/google/skills/blob/main/index.json) manifest. According to the source code analysis, the marketplace registration process (documented in [[`README.md`](https://github.com/google/skills/blob/main/README.md)](https://github.com/google/skills/blob/main/README.md) lines 82-86) enables Claude Code to enumerate and fetch all available Google Skills.

### Verify Marketplace Registration

Confirm the marketplace was added successfully:

```bash
claude plugin list | grep google/skills

```

## Install Google Skills

Once the marketplace is registered, install individual skills using the `@google-plugins` suffix. This suffix directs Claude Code to resolve the plugin from the Google Skills marketplace rather than generic sources.

### Install a Single Skill

```bash
claude plugin install cloud/google-cloud-storage-basics@google-plugins

```

**Key parameters:**
- `cloud/google-cloud-storage-basics` — the skill path within the repository's skill tree
- `@google-plugins` — **required** marketplace identifier

### Install Multiple Skills

For batch installation, use a shell loop. The following example installs the entire `cloud` skill collection:

```bash
for skill in \
    google-cloud-recipe-auth \
    google-cloud-recipe-foundation-builder \
    google-cloud-storage-basics \
    bigquery-ai-ml \
    agent-platform-alert-configuration; do
  claude plugin install cloud/$skill@google-plugins
done

```

### Verify Installation

List installed plugins to confirm:

```bash
claude plugin list

```

## How Claude Code Discovers Google Skills

Understanding the discovery mechanism helps troubleshoot integration issues.

The repository's [[`index.json`](https://github.com/google/skills/blob/main/index.json)](https://github.com/google/skills/blob/main/index.json) serves as the **auto-generated manifest** that Claude Code consumes after marketplace registration. This file maps skill identifiers to their entrypoint URLs and metadata. When you run `claude plugin list`, Claude Code fetches and parses this manifest to display available skills.

Each skill directory contains a [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) file defining:
- **Entrypoint** — the executable or command Claude Code invokes
- **Description** — human-readable purpose
- **Parameters** — expected inputs and their types

Example skill structures in the source:
- [`skills/cloud/google-cloud-storage-basics/SKILL.md`](https://github.com/google/skills/blob/main/skills/cloud/google-cloud-storage-basics/SKILL.md) — bucket management operations
- [`plugins/cloud/google-cloud-developer/skills/retrieving-developer-knowledge/SKILL.md`](https://github.com/google/skills/blob/main/plugins/cloud/google-cloud-developer/skills/retrieving-developer-knowledge/SKILL.md) — developer knowledge queries with explicit Claude Code compatibility
- [`skills/cloud/firebase-basics/references/claude_code.md`](https://github.com/google/skills/blob/main/skills/cloud/firebase-basics/references/claude_code.md) — Firebase-specific Claude Code setup instructions

## Using Installed Skills

After installation, invoke skills through natural language prompts or direct commands.

### Natural Language Invocation

```bash
claude "Create a new Cloud Storage bucket named my-bucket in us-central1"

```

Claude Code routes this request to the `google-cloud-storage-basics` skill based on intent matching. The skill's entrypoint executes the bucket creation logic using your authenticated Google Cloud credentials.

### Skill-Scoped Commands

Some skills expose explicit commands. Refer to each skill's [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) for available operations. The `firebase-basics` skill, documented in [[`skills/cloud/firebase-basics/references/claude_code.md`](https://github.com/google/skills/blob/main/skills/cloud/firebase-basics/references/claude_code.md)](https://github.com/google/skills/blob/main/skills/cloud/firebase-basics/references/claude_code.md), provides Claude Code-specific command patterns.

## Troubleshooting Integration Issues

| Issue | Resolution |
|-------|------------|
| `marketplace not found` | Re-run `claude plugin marketplace add google/skills` and verify network connectivity |
| `plugin install` fails with 404 | Confirm the skill path matches an entry in [[`index.json`](https://github.com/google/skills/blob/main/index.json)](https://github.com/google/skills/blob/main/index.json) |
| Skill not responding to prompts | Check `claude plugin list` output; reinstall with `claude plugin install <skill>@google-plugins --force` |
| Authentication errors | Ensure `gcloud` credentials are available in your Claude Code environment |

## Summary

- **Register the marketplace** once with `claude plugin marketplace add google/skills`
- **Use the `@google-plugins` suffix** for all skill installations to ensure correct source resolution
- **Reference [`index.json`](https://github.com/google/skills/blob/main/index.json)** to discover available skills and their paths
- **Invoke naturally** through Claude Code prompts or consult individual [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) files for structured commands
- **Verify installations** with `claude plugin list` before attempting skill usage

## Frequently Asked Questions

### What is the `@google-plugins` suffix and why is it required?

The `@google-plugins` suffix identifies the Google Skills marketplace as the installation source. Claude Code supports multiple marketplaces; this suffix prevents namespace collisions and ensures the plugin resolves from `google/skills` rather than other registries. Omitting it may result in "plugin not found" errors.

### Can I use Google Skills without Claude Code?

Yes. The [[`README.md`](https://github.com/google/skills/blob/main/README.md)](https://github.com/google/skills/blob/main/README.md) documents `npx`-based execution for standalone usage. However, the full intent-matching and natural language capabilities require Claude Code's plugin runtime.

### Where are skill definitions stored in the repository?

Skill definitions reside in `skills/` and `plugins/` directories, with each skill containing a [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) file. The [[`index.json`](https://github.com/google/skills/blob/main/index.json)](https://github.com/google/skills/blob/main/index.json) at repository root aggregates all discoverable skills for marketplace consumption.

### How do I contribute new skills or report integration bugs?

Submit issues and pull requests through the [google/skills](https://github.com/google/skills) GitHub repository. Include the output of `claude plugin list` and relevant [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) paths when reporting Claude Code integration problems.