Quickstart

npm i -g @openskillmd/osm

osm search testing                          # find a skill
osm add anthropics/skills@frontend-design   # install it

That's the whole loop: search, add, done. Your agent takes it from there.

Install

npm i -g @openskillmd/osm
# or the unscoped alias — same CLI, shorter name:
npm i -g openskillmd

Both packages install the same tool and expose the osm command (plus openskill and openskillmd aliases, if your fingers prefer them).

Commands

| Command | What it does | | --- | --- | | osm search <query> | Search skills, blueprints, and MCP servers by keyword | | osm info <slug> | Show details about a skill or blueprint (skills with a GitHub repo include a copy-paste add command) | | osm add <owner>/<repo> | Install a skill from a repo (alias: install) | | osm add <owner>/<repo>@<skill> | Install one skill from a multi-skill repo | | osm browse | Explore curated collections and MCP servers, interactively | | osm list | Show what's installed in this project | | osm score <file> | Score a local SKILL.md for quality | | osm init <skill\|blueprint> | Scaffold a new skill or blueprint | | osm remove <slug> | Uninstall a skill or blueprint | | osm router install | Drop the OpenSkill router SKILL.md into .skills/ | | osm mcp setup | Print the OpenSkill MCP server config for Claude / Cursor | | osm mcp info <slug> | Show details about an MCP server | | osm plugin install <slug> | Install a plugin bundle (Claude Code / Codex) | | osm plugin info <slug> | Show details about a plugin |

Installing skills

osm add pulls a skill straight from its source repo and drops it where your agent expects to find it (it delegates to the skills installer and is agent-aware):

osm add anthropics/skills@frontend-design
osm add anthropics/skills@frontend-design --agent claude-code
osm add anthropics/skills --global --copy

Not sure what to grab? Run osm search <query>, then osm info <slug> — for a skill backed by a source repo, the output hands you the exact osm add owner/repo line, ready to paste.

More than skills

osm covers the whole OpenSkill catalog:

• Plugins — install Claude Code / Codex plugin bundles with osm plugin install <slug>; inspect one with osm plugin info <slug>.
• MCP servers — browse the catalog and inspect servers with osm mcp info <slug>, and print the OpenSkill MCP server config for Claude or Cursor with osm mcp setup.
• Router — the meta-skill that teaches your agent to pull the right skills on demand: osm router install.

Telemetry

osm collects anonymous usage data (CLI version, command names, and installed skill slugs) to help us make it better. No personal data, no file contents, no command arguments — and an anonymous random id, never your identity.

Opt out any time:

export OSM_TELEMETRY=0      # or the cross-tool standard:
export DO_NOT_TRACK=1

Configuration

Settings live in ~/.openskill/config.json. osm talks to the production API by default; point it elsewhere with the OPENSKILL_API_URL environment variable (takes precedence) or a baseUrl in the config file:

OPENSKILL_API_URL=https://openskill.md/api osm search testing

Coming soon

Authenticated publishing (osm login / osm publish) is in the works — not available in this release yet.

License

MIT — built for OpenSkill.md.