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

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

claude plugin marketplace add google/skills

This command configures Claude Code to read the repository's 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) lines 82-86) enables Claude Code to enumerate and fetch all available Google Skills.

Verify Marketplace Registration

Confirm the marketplace was added successfully:

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

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:

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:

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) 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 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 — bucket management operations
• 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 — Firebase-specific Claude Code setup instructions

Using Installed Skills

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

Natural Language Invocation

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 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), 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)
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 to discover available skills and their paths
• Invoke naturally through Claude Code prompts or consult individual 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) 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 file. The [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 GitHub repository. Include the output of claude plugin list and relevant SKILL.md paths when reporting Claude Code integration problems.

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