# Install SkillsVault capabilities

> For AI agents. Use this when the person asks you to "install my capabilities from skillsvault.dev", to set up SkillsVault, or to run routines, playbooks or skills they hold on SkillsVault.

SkillsVault licenses capabilities to organisations: skills, routines, playbooks and agents. Some are installed on the machine; others are served by SkillsVault over MCP and are never stored locally. One command sets up both.

## 1. Run the installer in the project

From the root of the project the person works in:

```bash
npx -y https://skillsvault.dev/skillsvault-cli.tgz install
```

It does four things:

- **Signs in.** It opens SkillsVault in the browser and the person approves once. Tell them this is about to happen, and wait for them. Never ask for a password or a token.
- **Installs everything the organisation holds**, each the way it is delivered: a downloadable capability is installed in full, a hybrid one as a small pointer, and a hosted one not at all, because it is served.
- **Adds the SkillsVault MCP server** to the AI tool's config.
- **Installs the `skillsvault` skill**, which is what makes "run my routines" reach everything above.

It detects the AI tool from the project. If it cannot, add `--client <tool>`: `claude-code` (Claude Code), `cursor` (Cursor), `opencode` (OpenCode).

## 2. Connect

The AI tool picks up a new MCP server when it next starts, and asks the person to sign in to SkillsVault the first time it uses it.

- **Claude Code:** Run /mcp in Claude Code and sign in with SkillsVault.
- **Cursor:** Cursor asks you to sign in with SkillsVault the first time it needs the server.
- **OpenCode:** run `opencode mcp auth skillsvault`.

Tell the person to do this, then to ask again.

## 3. Use it

After that, these work in one sentence:

- "run my routines"
- "use my capabilities"
- "what do I have on SkillsVault?"

The `skillsvault` skill calls `list_my_skills` on the SkillsVault MCP server, which lists everything the organisation holds, whether each licence is active, and where each routine is read from. Served content is loaded with `load_skill` and `read_skill_file` every time it is used, and needs an active licence each time.

## If you cannot run commands

Add the SkillsVault MCP server by hand. Its address is `https://mcp.skillsvault.dev/mcp`; it signs in with OAuth, so no token goes in the config.

**Claude Code**, in `.mcp.json`:

```json
{
  "mcpServers": {
    "skillsvault": {
      "type": "http",
      "url": "https://mcp.skillsvault.dev/mcp"
    }
  }
}
```

**Cursor**, in `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "skillsvault": {
      "type": "http",
      "url": "https://mcp.skillsvault.dev/mcp"
    }
  }
}
```

**OpenCode**, in `opencode.json`:

```json
{
  "mcp": {
    "skillsvault": {
      "type": "remote",
      "url": "https://mcp.skillsvault.dev/mcp",
      "enabled": true
    }
  }
}
```

Then call `list_my_skills` and follow what it says for each capability.

## What not to do

- Do not copy served skills into files, memory or notes. They are licensed per use.
- Do not ask the person for a SkillsVault password, API key or token. The browser sign-in is the only credential.
