add-skill

# Add Skill

Install agent skills from any git repository using the `add-skill` CLI.

## When to Use

- Installing skills from GitHub or other git repositories
- Listing available skills from a repository before installation
- Managing skill installations across global and project scopes
- Tracking installed skills in a registry for updates

## Quick Start

### List Available Skills

```bash
npx add-skill vercel-labs/agent-skills --list
```

### Install a Skill

```bash
# Install globally (all projects)
npx add-skill vercel-labs/agent-browser --skill agent-browser --global

# Install to current project
npx add-skill vercel-labs/agent-browser --skill agent-browser
```

### Verify Installation

```bash
ls ~/.claude/skills/       # Global skills
ls .claude/skills/         # Project skills
```

## Source Formats

| Format | Example |
|--------|---------|
| GitHub shorthand | `vercel-labs/agent-skills` |
| Full GitHub URL | `https://github.com/vercel-labs/agent-skills` |
| Specific skill path | `vercel-labs/agent-skills/skills/skill-name` |
| GitLab URL | `https://gitlab.com/org/repo` |
| Any Git URL | `git@github.com:org/repo.git` |

## CLI Options

| Option | Description |
|--------|-------------|
| `-l, --list` | List available skills without installing |
| `-s, --skill <name>` | Install specific skill by name |
| `-g, --global` | Install to user directory (~/.claude/skills/) |
| `-a, --agent <agents...>` | Target specific agents (claude-code, cursor, etc.) |
| `-y, --yes` | Skip all confirmation prompts |
| `-h, --help` | Show help information |

## Installation Locations

| Scope | Path |
|-------|------|
| Project (default) | `.claude/skills/<name>/` |
| Global (`--global`) | `~/.claude/skills/<name>/` |

## Popular Skill Sources

| Source | Description |
|--------|-------------|
| `vercel-labs/agent-skills` | Vercel's curated skill collection |
| `vercel-labs/agent-browser` | Browser automation skill |

## Skill Registry

Track installed skills in a registry for l