rolecraft — Claude Code skill: what it does, how to install
Installs and manages AI agent skills across 90 targets from local folders, GitHub, GitLab, or SSH without external dependencies.
npx skills add rolecraft-sh/rolecraft --skill rolecraft -a claude-codeWhat rolecraft does
rolecraft distributes agent role definitions and skills into local projects or global system paths. The tool runs via npx rolecraft across 90 agent targets, including 65 verified environments. It also handles bidirectional conversion between SKILL.md and .mdc file formats.
Built-in commands scaffold new files using rolecraft init or download multi-skill bundles from text lists. For automated pipelines, rolecraft ci restores exact versions using a lockfile, while rolecraft verify validates skill integrity with content hashes.
The rolecraft doctor command inspects agent detection and your local Node.js environment. Without a working Node.js runtime, the CLI cannot execute.
What it helps with
- install agent skills from GitHub, GitLab, SSH URLs, or local directories
- distribute shared behaviors across multiple AI agents simultaneously
- convert agent instructions between
SKILL.mdand.mdcformats - lock skill revisions for reproducible CI/CD deployments
- verify installed skill files against cryptographic content hashes
Example prompts for the agent
- Install a skill into Cursor and Devin using
npx rolecraft install user/repo --cursor --devin - Check for newer versions of installed skills with
npx rolecraft check - Diagnose target agent detection and lockfile issues using
npx rolecraft doctor
How to install rolecraft
1Skills CLI (Vercel)
npx skills add rolecraft-sh/rolecraft --skill rolecraft -a claude-code2Manually: put the files in place
~/.claude/skills/rolecraft/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rolecraft/
1Skills CLI (Vercel)
npx skills add rolecraft-sh/rolecraft --skill rolecraft -a codex2Manually: put the files in place
.agents/skills/rolecraft/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rolecraft-sh/rolecraft --skill rolecraft -a cursor2Manually: put the files in place
.cursor/skills/rolecraft/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rolecraft-sh/rolecraft rolecraft2Manually: put the files in place
.github/skills/rolecraft/SKILL.md1Skills CLI (Vercel)
npx skills add rolecraft-sh/rolecraft --skill rolecraft -a gemini-cli2Platform CLI
gemini skills install https://github.com/rolecraft-sh/rolecraftManually: put the files in place
.devin/skills/rolecraft/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rolecraft-sh/rolecraft --skill rolecraft -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rolecraft
How to install rolecraft in Claude Code?
Run npx skills add rolecraft-sh/rolecraft --skill rolecraft -a claude-code in your terminal. The skill file is placed at ~/.claude/skills/rolecraft/SKILL.md.
What does rolecraft do?
rolecraft installs, converts, and updates AI agent skills across 90 targets without third-party dependencies. It pulls files directly from local paths, GitHub, GitLab, or SSH URLs.
What does rolecraft doctor diagnose?
It checks agent detection rules, validates lockfile consistency, and flags configuration issues in your local Node.js setup.
Source text
SKILL.md · MIT
--- name: rolecraft description: >- Install AI agent skills as roles & behaviors from any source — local folder, GitHub, GitLab, SSH git URL. Zero-dependency CLI with 90 agent targets (65 verified). --- # rolecraft Install and manage AI agent skills across 90 agents (65 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 ```bash # 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 (90 total · 65 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
© rolecraft-sh · MIT · rolecraft-sh/rolecraft
