Through your agent
The normal way. Ask in plain language:You: which skills do we have for bookmaker? Agent: Not on this machine. Your org has 3:The agent searches your organizations’ catalog, shows what exists and what’s already installed, and installs only after you confirm — rule 1.@acme/bookmaker-content-rulesv4 ·@acme/bookmaker-api-integrationv2 ·@acme/bookmaker-qa-checklistv1 Which ones should I install? You: the first two Agent: Both installed for every detected agent. They’ll be active in new sessions.
Installed skills load in new agent sessions. Restart the agent (or open a new session)
after installing.
From the CLI
The same operations by hand:list and search take --json for machine-readable output — each entry includes installedVersion and updateAvailable alongside the registry data.
What install actually does
- Downloads the skill package and verifies its content hash against the registry record — a mismatch aborts before anything touches disk.
- Writes the skill to the central store:
~/.masterskills/skills/<org>/<slug>. - Links it into every detected agent’s skills directory (flattened to
org--slug). One install covers Claude Code, Codex, Cursor, and every other detected agent at once.
Removing
“Remove the QA checklist skill from this machine.”or:
unpublish, a human-only action.