скилл CX Codex

rolecraft — скилл для Claude Code: что делает и как установить

Q: Как установить rolecraft в Claude Code?

Выполните команду `npx skills add rolecraft-sh/rolecraft --skill rolecraft -a claude-code`. Конфигурация сохранится по пути `~/.claude/skills/rolecraft/SKILL.md`.

Управляет скиллами агентов из локальных папок, GitHub, GitLab и SSH-репозиториев для 90 сред разработки без сторонних зависимостей.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓

npx skills add rolecraft-sh/rolecraft --skill rolecraft -a claude-code

Открыть на GitHub

Что делает rolecraft

rolecraft разворачивает правила и роли агентов в локальные каталоги проектов или в глобальную конфигурацию. Утилита работает через npx rolecraft и поддерживает 90 агентов, среди которых 65 верифицированы разработчиками. Она умеет конвертировать форматы инструкций между SKILL.md и .mdc.

Команда rolecraft init создаёт файлы навыков по шаблонам, а rolecraft bundle ставит сразу несколько конфигураций. Для автоматизации процессов предусмотрена команда rolecraft ci, которая восстанавливает точные версии скиллов по lockfile, и rolecraft verify для сверки хешей файлов.

Диагностическая команда rolecraft doctor проверяет детекцию целевых агентов и окружение Node.js. Без установленной платформы Node.js утилита не запустится.

Какие задачи решает

установить скиллы агентов из Git-репозиториев или локальных папок
синхронизировать правила между несколькими AI-агентами одной командой
конвертировать форматы инструкций между SKILL.md и .mdc
зафиксировать версии навыков через lockfile для CI/CD-пайплайнов
проверить целостность установленных файлов по хешу содержимого

Примеры запросов агенту

Установи скилл из репозитория с помощью команды npx rolecraft install vercel-labs/agent-skills --skill frontend-design
Проверь наличие обновлений для установленных навыков через rolecraft check
Запусти проверку детекции агентов и файлов блокировки командой rolecraft doctor

Как установить rolecraft

1Через Skills CLI (Vercel)

npx skills add rolecraft-sh/rolecraft --skill rolecraft -a claude-code

2Вручную: положить файлы

~/.claude/skills/rolecraft/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/rolecraft/

1Через Skills CLI (Vercel)

npx skills add rolecraft-sh/rolecraft --skill rolecraft -a codex

2Вручную: положить файлы

.agents/skills/rolecraft/SKILL.md

Для всех проектов — ~/.agents/skills/

1Через Skills CLI (Vercel)

npx skills add rolecraft-sh/rolecraft --skill rolecraft -a cursor

2Вручную: положить файлы

.cursor/skills/rolecraft/SKILL.md

Cursor читает и .agents/skills/, и .claude/skills/

1GitHub CLI

gh skill install rolecraft-sh/rolecraft rolecraft

2Вручную: положить файлы

.github/skills/rolecraft/SKILL.md

1Через Skills CLI (Vercel)

npx skills add rolecraft-sh/rolecraft --skill rolecraft -a gemini-cli

2Командой платформы

gemini skills install https://github.com/rolecraft-sh/rolecraft

Вручную: положить файлы

.devin/skills/rolecraft/SKILL.md

Старый путь .windsurf/skills/ тоже читается

Через Skills CLI (Vercel)

npx skills add rolecraft-sh/rolecraft --skill rolecraft -a opencode

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о rolecraft

Как установить rolecraft в Claude Code?

Выполните команду npx skills add rolecraft-sh/rolecraft --skill rolecraft -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/rolecraft/SKILL.md.

Что делает rolecraft?

Утилита устанавливает и обновляет файлы навыков для 90 AI-агентов из локальных папок, GitHub, GitLab или SSH. Она работает напрямую без сторонних зависимостей и реестров пакетов.

Зачем запускать rolecraft doctor?

Команда находит ошибки в обнаружении поддерживаемых агентов, проверяет целостность lockfile и выявляет проблемы с версией Node.js.

Исходный текст

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