Docs · CLI
Agent Skills OS CLI
agent-skills is the command-line tool in the universal-agent-skills package. It lists, searches, prints and exports the bundled skills, offline, so scripts and coding agents can use a skill without writing any code.
Run it
Run it once with npx, or install the package and call agent-skills from your project. It needs Node.js 18 or newer and has no dependencies.
npx universal-agent-skills list
# or, inside a project
npm install universal-agent-skills
npx agent-skills search uiCommands
| Command | What it does |
|---|---|
agent-skills list [--json] | List every skill with its description. |
agent-skills search <words...> [--json] | Skills whose name, description or tags contain every word. |
agent-skills show <name> | Print the skill's SKILL.md. |
agent-skills prompt <name> | Print the instructions only, ready to use as a system prompt. |
agent-skills json <name> | Print the skill as JSON: name, tags, inputs, related skills and instructions. |
agent-skills export <name> --format cursor|agents-md|stitch [--out <dir>] | Write a Cursor rule, an AGENTS.md section or a Stitch prompt. Without --out, print it. |
agent-skills --version, agent-skills --help | Show the version or the help. |
Examples
# Add a skill to Cursor as an agent-requested rule
npx universal-agent-skills export super-ui --format cursor --out .cursor/rules
# Append a skill to your project's AGENTS.md
npx universal-agent-skills export super-ui --format agents-md >> AGENTS.md
# Machine-readable output for scripts and agents
npx universal-agent-skills search ui --jsonExit codes: 0 on success, 1 when a skill isn't found, 2 for a usage mistake such as a missing argument. Errors go to stderr, output to stdout, so --json output can be piped straight into jq.
When to use the CLI
- In a shell script or CI job that writes rule files for Cursor or AGENTS.md tools.
- When a coding agent can run commands but shouldn't add code to the project just to read a skill.
- To check what a skill says before loading it with the npm package or the API.