# Agent Skills OS CLI

`agent-skills` is the command-line tool in the [universal-agent-skills](https://www.npmjs.com/package/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.

```sh
npx universal-agent-skills list

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

## Commands

| 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

```sh
# 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](https://skills.rakibulism.space/docs) or the [API](https://skills.rakibulism.space/docs/api).

---

Page: https://skills.rakibulism.space/docs/cli · Site guide for agents: https://skills.rakibulism.space/llms.txt
