SKILL.md
Skill Store
Your active context holds ~10 skills. The skill store holds everything else.
Use this CLI to browse, search, and pull skills on demand from ~/.skill-store/ — without polluting your context window.
Quick Start
skill-store list # what's available (not what's loaded)
skill-store search web # find by keyword
skill-store load <slug> # read a skill into context
Commands
| Command | What it does |
|---|---|
list |
Paginated list (pinned first). --json for machine output |
search <query> |
Full-text search names + descriptions |
load <slug> |
Print path, SKILL.md path, tree. --json for machine output |
preview <slug> |
Print first 100 lines of SKILL.md |
pin <slug> / unpin <slug> |
Move to top / back to alphabetical |
Installing the CLI
See [references/install.md](references/install.md).
Adding Skills
| Source | Where to look |
|---|---|
| Community packages | See [references/npx-skills.md](references/npx-skills.md) |
.skill bundles |
See [references/importing.md](references/importing.md) |
| Create your own | See [references/creating.md](references/creating.md) |
Organizing Your Skills
As your store grows, groups keep it tidy. See [references/organizing.md](references/organizing.md) for the workflow.
Environment
| Variable | Default | Purpose |
|---|---|---|
SKILLSTOREPATH |
~/.skill-store/ |
Override store location |