rolecraft
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 doctor to 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 git@github.com: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
Links
1---2name: rolecraft3description: Install AI agent skills as roles & behaviors from any source — local folder, GitHub, GitLab, SSH git URL. Zero-dependency CLI with 87 agent targets (27 verified).4---56# rolecraft78Install and manage AI agent skills across 87 agents (27 verified) with a single command. Zero dependencies. No registry required.910## When to use1112- **Install skills** — from local folders, GitHub repos, GitLab projects, or SSH git URLs13- **Manage skills** — list, update, remove, and verify installed skills14- **CI/CD pipelines** — lockfile-based re-install with `rolecraft ci`15- **Troubleshooting** — `rolecraft doctor` to diagnose agent detection, lockfile, and Node.js issues16- **Team onboarding** — bundle install with a single command17- **Cross-agent setup** — install the same skill to multiple agents at once1819## Quick start2021```bash22# Try without installing23npx rolecraft --help2425# Create a skill26npx rolecraft init my-skill2728# Install from any source29npx rolecraft install ./my-skill30npx rolecraft install user/repo31npx rolecraft install https://gitlab.com/org/project32npx rolecraft install git@github.com:user/repo.git3334# Install to specific agents35npx rolecraft install user/repo --cursor --devin3637# Check for updates38npx rolecraft check3940# Run system health check41npx rolecraft doctor4243# List installed skills44npx rolecraft list4546# Convert between SKILL.md and .mdc47npx rolecraft convert ./my-skill48```4950## Install commands5152| Command | Purpose |53|---------|---------|54| `rolecraft install <source>` | Install a skill (local, GitHub, GitLab, SSH) |55| `rolecraft init [name]` | Scaffold a new `SKILL.md` (`--template`, `--list`) |56| `rolecraft list` | Show installed skills |57| `rolecraft check` | Check for available updates |58| `rolecraft remove <slug>` | Uninstall a skill |59| `rolecraft update <slug>` | Re-install to latest version |60| `rolecraft rollback <slug>` | Restore to previous version from backup |61| `rolecraft bundle <sources>` | Install multiple skills from file or inline |62| `rolecraft ci` | Re-install from lockfile (CI mode) |63| `rolecraft verify` | Check skill integrity via content hash |64| `rolecraft watch [<slug>]` | Watch skills for changes and auto-sync |65| `rolecraft search <query>` | Search skills on GitHub |66| `rolecraft doctor` | Run system health check |67| `rolecraft agents-xml [--write]` | Generate skills XML for AGENTS.md |68| `rolecraft use <source>` | Preview without installing |69| `rolecraft completions bash\|zsh\|fish` | Generate shell completions |70| `rolecraft convert <source>` | Convert between SKILL.md and .mdc formats |71| `rolecraft test <skill-path>` | Test a skill quality with built-in assertions |7273## Common flags7475| Flag | Purpose |76|------|---------|77| `--cursor`, `--devin`, `--claude`, `--codex` | Target specific agents |78| `--all` | Install to every supported agent |79| `--yes` / `-y` | Non-interactive mode (CI/CD) |80| `--dry-run` | Preview without making changes |81| `--symlink` | Symlink instead of copy |82| `--global` / `--project` | Scope selection |8384## Supported agents (87 total · 27 verified)8586`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.8788## Examples8990### Install from GitHub91```92rolecraft install vercel-labs/agent-skills --skill frontend-design93```9495### Install to multiple agents96```97rolecraft install ./my-team-rules --cursor --devin --copilot --all98```99100### CI pipeline install101```102rolecraft ci --yes103```104105### Create and install your own skill106```107rolecraft init my-skill108rolecraft install ./my-skill --all109```110111## Links112113- GitHub: https://github.com/rolecraft-sh/rolecraft114- npm: https://www.npmjs.com/package/rolecraft115- Docs: https://github.com/rolecraft-sh/rolecraft#readme
rolecraft-sh