What does rolecraft do?
Install and manage AI agent skills across 87 agents (27 verified) with a single command. Zero dependencies. No registry required.
When to use
- Install skills — from local folders, GitHub repos, GitLab projects, or SSH git URLs
- Manage skills — list, update, remove, and verify installed skills
- CI/CD pipelines — lockfile-based re-install with
rolecraft ci - Troubleshooting —
rolecraft doctorto diagnose agent detection, lockfile, and Node.js issues - Team onboarding — bundle install with a single command
- Cross-agent setup — install the same skill to multiple agents at once
Quick start
# Try without installing
npx rolecraft --help
# Create a skill
npx rolecraft init my-skill
# Install from any source
npx rolecraft install ./my-skill
npx rolecraft install user/repo
npx rolecraft install https://gitlab.com/org/project
npx rolecraft install [email protected]:user/repo.git
# Install to specific agents
npx rolecraft install user/repo --cursor --devin
# Check for updates
npx rolecraft check
# Run system health check
npx rolecraft doctor
# List installed skills
npx rolecraft list
# Convert between SKILL.md and .mdc
npx rolecraft convert ./my-skill
Install commands
| Command | Purpose |
|---|---|
rolecraft install <source> | Install a skill (local, GitHub, GitLab, SSH) |
rolecraft init [name] | Scaffold a new SKILL.md (--template, --list) |
rolecraft list | Show installed skills |
rolecraft check | Check for available updates |
rolecraft remove <slug> | Uninstall a skill |
rolecraft update <slug> | Re-install to latest version |
rolecraft rollback <slug> | Restore to previous version from backup |
rolecraft bundle <sources> | Install multiple skills from file or inline |
rolecraft ci | Re-install from lockfile (CI mode) |
rolecraft verify | Check skill integrity via content hash |
rolecraft watch [<slug>] | Watch skills for changes and auto-sync |
rolecraft search <query> | Search skills on GitHub |
rolecraft doctor | Run system health check |
rolecraft agents-xml [--write] | Generate skills XML for AGENTS.md |
rolecraft use <source> | Preview without installing |
rolecraft completions bash|zsh|fish | Generate shell completions |
rolecraft convert <source> | Convert between SKILL.md and .mdc formats |
rolecraft test <skill-path> | Test a skill quality with built-in assertions |
Common flags
| Flag | Purpose |
|---|---|
--cursor, --devin, --claude, --codex | Target specific agents |
--all | Install to every supported agent |
--yes / -y | Non-interactive mode (CI/CD) |
--dry-run | Preview without making changes |
--symlink | Symlink instead of copy |
--global / --project | Scope selection |
Supported agents (87 total · 27 verified)
opencode, claude-code, cursor, windsurf, devin, codex, copilot, aider, cline, gemini-cli, cody, continue, warp, codeium, fabric, goose, tabnine, supermaven, pr-pilot, loom, roo, trae, hermes, kiro, augment, kilo, openhands, junie, factory, command-code, cortex, mistral-vibe, qwen-code, openclaw, codebuddy, mux, pi, omp (oh-my-pi), autohand-code, rovo-dev, firebender, ibm-bob, aider-desk, and 45 more.
Examples
Install from GitHub
rolecraft install vercel-labs/agent-skills --skill frontend-design
Install to multiple agents
rolecraft install ./my-team-rules --cursor --devin --copilot --all
CI pipeline install
rolecraft ci --yes
Create and install your own skill
rolecraft init my-skill
rolecraft install ./my-skill --all