rolecraft

---
name: rolecraft
description: >-
  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).
---

# 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

```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 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