How to Install Google Agent Skills: A Complete CLI and Integration Guide

Google Agent Skills install in seconds using the npx skills CLI, which downloads Markdown-based skill packages directly into your agent's runtime environment.

The google/skills repository distributes AI-ready skills as self-contained Markdown packages. According to the official source code, you can add these capabilities to Claude, Codex, Antigravity, or other agent harnesses without modifying underlying agent code—only a single command is required.

---

Installation Methods in the Google Skills Repository

The README.md at google/skills documents two primary ways to install Google Agent Skills. Both approaches use the skills CLI helper to parse the repository tree, present interactive selection prompts, and copy Markdown skill files into your local agent directory.

Method 1: Interactive CLI Installation (Recommended)

Run the npx skills add google/skills command to launch the interactive installer. The CLI will fetch the repository structure and prompt you to select specific skill directories.

# Install with interactive skill selection

npx skills add google/skills

This command performs three operations defined in the installation logic (source):

• Downloads the skills helper utility
• Presents a tree view of available skill directories
• Copies selected SKILL.md files into your agent's skill folder

Method 2: Direct Skill Installation

For targeted installation, append the specific skill path to install a single capability without interactive prompts:

# Install only the GKE Workload Scaling skill

npx skills add google/skills/skills/cloud/gke-workload-scaling

This pattern follows the repository structure where each skill resides in its own directory containing a SKILL.md definition file.

Method 3: Browser-Based Installation via skills.sh

The repository provides a one-click badge that launches the same installer in a browser environment (source). This method uses the skills.sh shortcut for users who prefer graphical selection or cannot access terminal environments directly.

---

Installing Plugins for Specific Agent Harnesses

Beyond core skills, the google/skills repository bundles optional Google-product plugins for specific agent harnesses. These plugins extend runtime capabilities beyond the Markdown skill definitions.

Claude Code Plugin Installation

# Add the Google Skills plugin marketplace

claude plugin marketplace add google/skills

# Install the Google plugins package

claude plugin install @google-plugins

Plugin documentation resides in [plugins/cloud/data-agent-kit/README.md](https://github.com/google/skills/blob/main/plugins/cloud/data-agent-kit/README.md), which covers harness-specific integration details (source).

---

Using Installed Google Agent Skills

Once installation completes, invoke skills directly from your agent prompt using the @ prefix followed by the skill identifier:

@google-cloud-recipe-auth

The agent harness loads and executes the authentication recipe defined in skills/cloud/google-cloud-recipe-auth/SKILL.md. Each SKILL.md file contains:

• Prompt templates for user interaction
• Context instructions shaping agent behavior
• Optional tooling hooks for external API calls

---

Architecture: How Google Agent Skills Install Works

Understanding the installation architecture clarifies why this approach enables versioning and updates without agent code changes.

Component	Source Location	Function
skills CLI	Installation logic (source)	Parses repository tree, handles selection UI, performs file operations
Skill Markdown (SKILL.md)	skills/**/SKILL.md (example)	Contains complete skill definition—prompts, context, tooling instructions
Plugins folder	plugins/ directory (source)	Harness-specific extensions for Claude, Codex, Antigravity
Agent harness	Runtime environment (source)	Loads Markdown skills at execution time

This separation of concerns—Markdown definitions independent of execution engines—means you can update skills by re-running npx skills add without touching agent configuration.

---

Key Files in the Google Skills Repository

File	Purpose
[README.md](https://github.com/google/skills/blob/main/README.md)	Primary installation guide and skill catalog
skills/**/SKILL.md	Individual skill definitions (e.g., skills/cloud/gke-workload-scaling/SKILL.md)
[plugins/cloud/data-agent-kit/README.md](https://github.com/google/skills/blob/main/plugins/cloud/data-agent-kit/README.md)	Plugin documentation for agent harness integration
[opencode.json](https://github.com/google/skills/blob/main/opencode.json)	Opencode tooling metadata
LICENSE	Apache 2.0 license terms

---

Summary

• Google Agent Skills install via npx skills add google/skills—the CLI handles repository parsing, interactive selection, and file copying automatically.
• Skills are Markdown-based (SKILL.md files), enabling version-controlled, portable definitions separate from agent harness code.
• Targeted installation bypasses selection prompts: npx skills add google/skills/skills/cloud/SKILL-NAME.
• Plugins extend harness capabilities through marketplace commands for Claude, Codex, and other supported environments.
• Invocation uses @ prefixes in agent prompts to trigger installed skill logic.

---

Frequently Asked Questions

What is the fastest way to install Google Agent Skills?

Run npx skills add google/skills in your terminal. This single command downloads the skills helper, presents available options from the repository, and copies your selections into the agent's skill folder. No prior installation of the CLI is required—npx handles it automatically.

Can I install Google Agent Skills without using the command line?

Yes. The repository provides a skills.sh one-click badge that launches the installer in a browser environment. This alternative suits users who cannot access terminal environments or prefer graphical selection interfaces.

How do I install only one specific skill instead of the entire repository?

Append the skill's path to the installation command: npx skills add google/skills/skills/cloud/gke-workload-scaling. This skips the interactive selection and installs only the specified skill's SKILL.md and supporting files.

Do I need to install plugins separately from skills?

Plugins and skills serve different purposes. Skills (Markdown files) install via npx skills add. Plugins for specific harnesses—like Claude Code—require separate commands: claude plugin marketplace add google/skills followed by claude plugin install @google-plugins. Consult plugins/cloud/data-agent-kit/README.md for harness-specific requirements.

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