Skip to content
Agent Skills OS

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.

terminal
npx universal-agent-skills list

# or, inside a project
npm install universal-agent-skills
npx agent-skills search ui

Commands

CommandWhat 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 --helpShow the version or the help.

Examples

terminal
# 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 --json

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