skills-manage

Scan and manage SKILL.md files scattered across your agent directories (~/.agents, ~/.claude, ~/.hermes, ~/.stepfun, ~/.cursor, …) from one place — a local web UI plus a chat-friendly CLI with safe dry-run plans for move / symlink / delete.

Install

npm install -g skills-manage

Requires Node.js ≥ 20.

Usage

sm              # launch the web UI (starts a local server + opens the browser)
sm scan         # rescan and print a per-root summary
sm list [query] # list skills grouped by root
sm roots        # list configured roots with counts and read/write flag
sm view <name>  # print a skill's raw SKILL.md
sm move <name> <root>      # plan a move (dry-run; add --apply to execute)
sm symlink <name> <root>   # plan a relative symlink (add --apply)
sm delete <name>           # plan deletion (add --apply)
sm config       # print the merged config

Mutating commands print a dry-run plan by default. Add --apply only after confirming the plan.

Where data lives

Config and cache live under the user data dir (default ~/.skills-manage, override with SM_DATA_DIR):

• config.yaml — seeded from the bundled default on first run
• config.local.yaml — UI overrides (delete to reset)
• cache/scan.json — scan cache
• .port — the running server's port

License

MIT