rolecraft

Files (200)

• .biomeignore
• .editorconfig
• CODEOWNERS · .github/
• bug_report.md · .github/ISSUE_TEMPLATE/
• feature_request.md · .github/ISSUE_TEMPLATE/
• PULL_REQUEST_TEMPLATE.md · .github/
• codeql-config.yml · .github/codeql/
• dependabot.yml · .github/
• release-prep.sh · .github/scripts/
• release-prep.test.js · .github/scripts/
• codeql.yml · .github/workflows/
• docs.yml · .github/workflows/
• release-prep.yml · .github/workflows/
• release-publish.yml · .github/workflows/
• scorecard.yml · .github/workflows/
• test.yml · .github/workflows/
• welcome.yml · .github/workflows/
• .gitignore
• .npmignore
• .nvmrc
• AGENTS.md
• CHANGELOG.md
• CODE_OF_CONDUCT.md
• CONTRIBUTING.md
• LICENSE
• MANIFEST-MATRIX.md
• README.md
• RELEASE.md
• SECURITY.md
• SKILL.md
• SUPPORT.md
• apps.json
• demo.tape · assets/
• favicon.png · assets/
• logo.png · assets/
• og.jpg · assets/
• robots.txt · assets/
• rolecraft-demo.gif · assets/
• rolecraft_logo.png · assets/
• RESULTS.md · benchmark/
• comparison.svg · benchmark/
• install-speed.js · benchmark/
• results.json · benchmark/
• rolecraft.js · bin/
• rolecraft.test.js · bin/
• cli-contract.test.js · bin/rolecraft/
• biome.json
• config.js · docs/.vitepress/
• custom.css · docs/.vitepress/theme/
• index.js · docs/.vitepress/theme/
• agents.md · docs/
• api.md · docs/
• architecture.md · docs/
• architecture.test.js · docs/
• benchmark · docs/
• agents-xml.md · docs/commands/
• agents.md · docs/commands/
• bundle.md · docs/commands/
• check.md · docs/commands/
• ci.md · docs/commands/
• …and 140 more

SKILL.md (first lines)

# 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 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 (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

From rolecraft-sh/rolecraft, MIT.