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

> Install Google Agent Skills effortlessly with the `npx skills` CLI. Get Markdown skill packages into your agent's runtime environment quickly. Learn more now!

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

---

**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](https://github.com/google/skills/blob/main/README.md), 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`](https://github.com/google/skills/blob/main/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.

```bash

# Install with interactive skill selection

npx skills add google/skills

```

This command performs three operations defined in the installation logic ([source](https://github.com/google/skills/blob/main/README.md#L13-L18)):

- Downloads the **`skills`** helper utility
- Presents a tree view of available skill directories
- Copies selected [`SKILL.md`](https://github.com/google/skills/blob/main/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:

```bash

# 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`](https://github.com/google/skills/blob/main/SKILL.md) definition file.

### Method 3: Browser-Based Installation via [`skills.sh`](https://github.com/google/skills/blob/main/skills.sh)

The repository provides a one-click badge that launches the same installer in a browser environment ([source](https://github.com/google/skills/blob/main/README.md#L3-L5)). This method uses the [`skills.sh`](https://github.com/google/skills/blob/main/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

```bash

# 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)](https://github.com/google/skills/blob/main/plugins/cloud/data-agent-kit/README.md), which covers harness-specific integration details ([source](https://github.com/google/skills/blob/main/README.md#L55-L64)).

---

## Using Installed Google Agent Skills

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

```text
@google-cloud-recipe-auth

```

The agent harness loads and executes the authentication recipe defined in [`skills/cloud/google-cloud-recipe-auth/SKILL.md`](https://github.com/google/skills/blob/main/skills/cloud/google-cloud-recipe-auth/SKILL.md). Each [`SKILL.md`](https://github.com/google/skills/blob/main/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](https://github.com/google/skills/blob/main/README.md#L13-L18)) | Parses repository tree, handles selection UI, performs file operations |
| **Skill Markdown ([`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md))** | `skills/**/SKILL.md` ([example](https://github.com/google/skills/tree/main/skills)) | Contains complete skill definition—prompts, context, tooling instructions |
| **Plugins folder** | `plugins/` directory ([source](https://github.com/google/skills/blob/main/README.md#L55-L64)) | Harness-specific extensions for Claude, Codex, Antigravity |
| **Agent harness** | Runtime environment ([source](https://github.com/google/skills/blob/main/README.md#L59-L64)) | 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)](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`](https://github.com/google/skills/blob/main/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)](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)](https://github.com/google/skills/blob/main/opencode.json) | Opencode tooling metadata |
| [`LICENSE`](https://github.com/google/skills/blob/main/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`](https://github.com/google/skills/blob/main/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`](https://github.com/google/skills/blob/main/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`](https://github.com/google/skills/blob/main/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`](https://github.com/google/skills/blob/main/plugins/cloud/data-agent-kit/README.md) for harness-specific requirements.