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

• GitHub: https://github.com/rolecraft-sh/rolecraft
• npm: https://www.npmjs.com/package/rolecraft
• Docs: https://github.com/rolecraft-sh/rolecraft#readme