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
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.