> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masterskills.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# masterskills install

> One-time setup: register MasterSkills with every coding agent on this machine.

```bash theme={"dark"}
npm install -g @masterskills/cli   # once per machine
masterskills install
```

Detects every supported coding agent on the machine and installs the bundled MasterSkills skill into each one — the skill that teaches agents to search, install, update, and publish through this CLI, and the approval rules they must follow.

## What it does

1. Detects agents by their config directories — Claude Code, Codex, Cursor, Gemini CLI, and the rest of the [70+ agent registry](/guides/supported-agents).
2. Writes the bundled skill into the central store as `@masterskills/cli`.
3. Links it into each detected agent's skills directory. Agents sharing the universal `~/.agents/skills` directory are linked once.

Output is one line per agent, marking each install or the reason it was skipped. If **no** agents are detected, the command exits non-zero and points you at `masterskills agents --all`.

## After installing

Restart your agents so they load the skill, then authorize the device:

```bash theme={"dark"}
masterskills login
```

## Re-running

`install` is idempotent — run it again any time, for example after installing a new coding agent. Registry skills you've added are linked into new agents via [`masterskills link`](/cli/link).