# Skills CLI

This guide uses the [Skills CLI](https://github.com/vercel-labs/skills) (`npx skills`), a cross-platform installer that works with most AI coding agents. If you're using Claude Code specifically, the plugin marketplace method is simpler. If you use a different agent, see all the available [installation methods](https://docs.keeper.io/en/keeperpam/secrets-manager/integrations/ai-agents/..#installation) we support for AI Agents.

***

### Requirements

* **Node.js 18+** (needed to run `npx`)

The CLI auto-detects which agents you have installed.

***

### Install

**Interactive (recommended):** Prompts you to pick which skills and agents to install.

```bash
npx skills add Keeper-Security/keeper-agent-kit
```

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2Fz4AoPTkmdvvhqNo3aMKd%2Fskills-1.png?alt=media&#x26;token=2adf20f3-8b73-45ae-92eb-f9591a1e2e76" alt=""><figcaption></figcaption></figure>

**Target a specific agent:**

```bash
npx skills add Keeper-Security/keeper-agent-kit -a cursor
npx skills add Keeper-Security/keeper-agent-kit -a claude-code
npx skills add Keeper-Security/keeper-agent-kit -a codex
```

**Install to all detected agents at once:**

```bash
npx skills add Keeper-Security/keeper-agent-kit --all
```

**Install a single skill:**

```bash
npx skills add Keeper-Security/keeper-agent-kit --skill keeper-secrets
```

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2Fkz4JqtafXiZiI3tajF3K%2Fskills-2.png?alt=media&#x26;token=fca77c04-822f-4a42-9513-85810c300dbc" alt=""><figcaption></figcaption></figure>

***

### Global vs. Project Install

By default, `npx skills add` installs to the current project directory.

**Project-level** (default): Skills go into `./.agents/skills/` with symlinks to each detected agent's directory. Useful when your team should all have the same Keeper skills.

**Global**: Skills go into your home directory and are available across every project.

```bash
npx skills add Keeper-Security/keeper-agent-kit -g
```

Use global install if you work with Keeper across many repos and don't want to install per-project.

***

### Verify

Check what's installed:

```bash
npx skills list
```

Or filter by agent:

```bash
npx skills ls -a cursor
```

You should see `keeper-secrets`, `keeper-admin`, and `keeper-setup` listed.

***

### Update

Check for newer versions:

```bash
npx skills check
```

Pull the latest:

```bash
npx skills update
```

***

### Supported Agents

The Skills CLI supports these agents. It detects which ones are installed and sets up the right directories.

| Agent          | Flag             | Skills Path           |
| -------------- | ---------------- | --------------------- |
| Claude Code    | `-a claude-code` | `~/.claude/skills/`   |
| Cursor         | `-a cursor`      | `~/.cursor/skills/`   |
| Codex          | `-a codex`       | `~/.codex/skills/`    |
| GitHub Copilot | `-a copilot`     | `~/.github/skills/`   |
| OpenCode       | `-a opencode`    | `~/.opencode/skills/` |
| Gemini CLI     | `-a gemini`      | `~/.gemini/skills/`   |

If your agent isn't listed, the CLI creates a generic `.agents/skills/` directory. Check your agent's docs for the right path and copy the files there.

***

### Uninstall

```bash
npx skills remove keeper-secrets
npx skills remove keeper-admin
npx skills remove keeper-setup
```

This only removes the agent skills. The KSM CLI and Commander CLI stay installed on your machine.
