English | 简体中文
Cross-platform skill lifecycle manager for AI coding agents. It still installs and manages skills reliably, and now also helps with discovery, inspection, recommendation, verification, composition, and orchestration.
- ✅ Task-to-skill recommendation — Recommend skills from a user task with explainable scoring
- ✅ Static inspection — Inspect candidate skills before installation
- ✅ Post-install verification — Verify env, structure, conflicts, and smoke checks
- ✅ Skill composition — Adapt, merge, or generate skill outputs
- ✅ Structured JSON interfaces —
find,inspect,recommend,verify,compose, andsolvecan now serve as machine-consumable interfaces - ✅ Solve workflow —
solveorchestrates discovery, recommendation, optional install, and optional verify - ✅ Design doc included — See docs/skill-lifecycle-platform.md
- ✅ Smart .env Management — Auto backup/restore environment variables during updates
- ✅ Multi-Platform Support — 39 AI coding agents including Claude Code, Cursor, Cline, Windsurf, OpenCode and more
- ✅ npx skills Compatible — Drop-in replacement with same command interface
- ✅ Unified Directory — Centralized management in
~/.agents/ - ✅ Atomic Operations — Auto rollback on failure
- ✅ Diagnostic Tools — Built-in
doctorcommand
npm install -g skill-masterOr use directly:
npx skill-master add <source># Discover candidates
skill-master find "code review"
skill-master find "code review" --json
# Inspect a source or installed skill
skill-master inspect owner/repo
skill-master inspect my-skill --json
# Recommend skills from a task
skill-master recommend "monitor deploy status"
skill-master recommend "monitor deploy status" --safe --local-first
skill-master recommend "monitor deploy status" --json
# Recommend and install best match
skill-master recommend "fetch latest library docs" --install# Discovery + recommendation
skill-master solve "search web docs"
# Structured orchestration output
skill-master solve "search web docs" --json
# Orchestrate recommendation, install, and verify
skill-master solve "search web docs" --install --verify --json# From GitHub
skill-master add owner/repo
skill-master add https://github.com/user/skill
# From local path
skill-master add ./local-skill
# Specify target agent
skill-master add owner/repo -a claude-code cursor
# Copy mode (recommended for Windows)
skill-master add owner/repo --copy# Verify installed skill
skill-master verify my-skill
skill-master verify my-skill --json
# Compose a new skill output from multiple sources
skill-master compose path/to/skill-a path/to/skill-b -o ./generated-skill
skill-master compose path/to/skill-a path/to/skill-b -o ./generated-skill --json# List all skills with env status
skill-master env list
# Set environment variable
skill-master env set my-skill API_KEY=your_key
# Edit .env file
skill-master env edit my-skill# Update skill (auto preserves .env)
skill-master update my-skill
# Remove skill
skill-master remove my-skill
# Remove with config purge
skill-master remove my-skill --purge# List installed skills
skill-master list
# Check for updates
skill-master check
# Create new skill template
skill-master init my-new-skill
# Show skill details
skill-master info my-skill
# Run diagnostics
skill-master doctorThese commands now support structured output for scripting and higher-level products:
skill-master find <query> --json
skill-master inspect <source|skill> --json
skill-master recommend "<task>" --json
skill-master verify <skill-name> --json
skill-master compose <source...> --json
skill-master solve "<task>" --jsonField-level contracts and stable schema entry points:
find, inspect, and compose are documented in the contract doc, but do not ship a dedicated schema in this round.
recommend and solve support preference tuning:
--safe prefer lower-risk candidates
--local-first boost local and project candidates
--no-remote filter out remote-only candidates
--prefer-installed boost already installed skillsAll npx skills commands work:
skill-master add # or: a, install, i
skill-master remove # or: rm, r
skill-master list # or: ls
skill-master find # or: search, f, s
skill-master update # or: upgrade39 AI coding agents are supported. Auto-detection works for agents with a project directory marker:
| Platform | Detection | Skills Directory |
|---|---|---|
| Claude Code | .claude/ |
.claude/skills/ |
| Cursor | .cursor/ |
.cursor/skills/ |
| Cline | .cline/ |
.cline/skills/ |
| Windsurf | .windsurf/ |
.windsurf/skills/ |
| OpenCode | ~/.config/opencode/ |
.opencode/skills/ |
| Roo Code | .roo/ |
.roo/skills/ |
| Augment | .augment/ |
.augment/skills/ |
| Continue | .continue/ |
.continue/skills/ |
| Goose | .goose/ |
.goose/skills/ |
| Kode | .kode/ |
.kode/skills/ |
| Trae | .trae/ |
.trae/skills/ |
All 39 supported agents
Amp, Antigravity, Augment, Claude Code, OpenClaw, Cline, CodeBuddy, Codex, Command Code, Continue, Crush, Cursor, Droid, Gemini CLI, GitHub Copilot, Goose, Junie, iFlow CLI, Kilo Code, Kimi Code CLI, Kiro CLI, Kode, MCPJam, Mistral Vibe, Mux, OpenCode, OpenHands, Pi, Qoder, Qwen Code, Replit, Roo Code, Trae, Trae CN, Windsurf, Zencoder, Neovate, Pochi, AdaL
See CLAUDE.md for architecture, development commands, and release workflow.
See docs/skill-lifecycle-platform.md for the full platform design.
| Feature | npx skills | skill-master |
|---|---|---|
| .env Protection | ❌ Deleted on update | ✅ Auto backup/restore |
| Multi-Platform | ❌ Claude Code only | ✅ 39 platforms |
| Config Management | ❌ None | ✅ env commands |
| Diagnostics | ❌ None | ✅ doctor command |
| Discovery & Recommendation | ❌ Minimal | ✅ Multi-source + recommend |
| Verification | ❌ None | ✅ verify command |
| Composition | ❌ None | ✅ compose command |
| Orchestration | ❌ None | ✅ solve command |
| Structured JSON API | ❌ None | ✅ Core lifecycle commands support --json |
| Symlinks | ✅ | ✅ + copy mode |
| Git Install | ✅ | ✅ |
| Local Install | ✅ | ✅ |
npx skills add executes rm -rf during install/update, deleting .env files. Users must reconfigure API keys after every update. skill-master solves this with intelligent backup and now also helps users choose, verify, and orchestrate skills.
Yes. skill-master uses separate ~/.agents/ directory and won't affect existing installations.
Use --copy flag: skill-master add <source> --copy
Simply reinstall with skill-master. It will auto-detect and preserve existing .env configs.
MIT
BenedictKing
Issues and Pull Requests are welcome!