> ## 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 link

> (Re)link installed skills into agent skill directories.

```bash theme={"dark"}
masterskills link                          # all skills → all detected agents
masterskills link @acme/api-conventions    # specific skills only
masterskills link --agents claude-code,codex
```

Recreates the links from agent skill directories into the central store. Installs and updates do this automatically — `link` is the repair and catch-up tool:

* **A new agent was installed** after your skills were — link everything into it.
* **A skills directory was cleaned out** by hand or by a tool — restore the links.

## Options

| Option           | Effect                                                                               |
| ---------------- | ------------------------------------------------------------------------------------ |
| `--agents <ids>` | Comma-separated agent ids to target — see [`masterskills agents --all`](/cli/agents) |

Link names are flattened to `org--slug` (e.g. `~/.claude/skills/acme--api-conventions`). Agents sharing the universal `~/.agents/skills` directory are linked once; agents whose directories can't hold real links get copies that refresh on every store write.