rolecraft은(는) 무엇을 하나요?
87개(27개 검증됨) AI 에이전트에 걸쳐 단일 명령어로 스킬을 설치하고 관리하세요. 제로 의존성. 레지스트리 불필요.
사용 시점
- 스킬 설치 — 로컬 폴더, GitHub 저장소, GitLab 프로젝트, SSH git URL에서 설치
- 스킬 관리 — 설치된 스킬 목록, 업데이트, 제거, 검증
- CI/CD 파이프라인 —
rolecraft ci로 lockfile 기반 재설치 - 문제 해결 —
rolecraft doctor로 에이전트 감지, lockfile, Node.js 문제 진단 - 팀 온보딩 — 단일 명령어로 번들 설치
- 크로스 에이전트 설정 — 여러 에이전트에 동시에 동일한 스킬 설치
빠른 시작
# 설치 없이 사용해보기
npx rolecraft --help
# 스킬 생성
npx rolecraft init my-skill
# 소스에서 설치
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
# 특정 에이전트에 설치
npx rolecraft install user/repo --cursor --devin
# 업데이트 확인
npx rolecraft check
# 시스템 건강 점검 실행
npx rolecraft doctor
# 설치된 스킬 목록
npx rolecraft list
# SKILL.md와 .mdc 간 변환
npx rolecraft convert ./my-skill
명령어
| 명령어 | 목적 |
|---|---|
rolecraft install <source> | 스킬 설치 (로컬, GitHub, GitLab, SSH) |
rolecraft init [name] | 새로운 SKILL.md 스캐폴드 (--template, --list) |
rolecraft list | 설치된 스킬 목록 표시 |
rolecraft check | 사용 가능한 업데이트 확인 |
rolecraft remove <slug> | 스킬 제거 |
rolecraft update <slug> | 최신 버전으로 재설치 |
rolecraft rollback <slug> | 백업에서 이전 버전 복원 |
rolecraft bundle <sources> | 파일이나 인라인에서 여러 스킬 설치 |
rolecraft ci | lockfile에서 재설치 (CI 모드) |
rolecraft verify | 콘텐츠 해시로 스킬 무결성 확인 |
rolecraft watch [<slug>] | 스킬 변경 감지 및 자동 동기화 |
rolecraft search <query> | GitHub에서 스킬 검색 |
rolecraft doctor | 시스템 건강 점검 실행 |
rolecraft agents-xml [--write] | AGENTS.md용 스킬 XML 생성 |
rolecraft use <source> | 설치 없이 미리보기 |
| `rolecraft completions bash | zsh |
rolecraft convert <source> | SKILL.md와 .mdc 형식 간 변환 |
rolecraft test <skill-path> | 내장 어설션으로 스킬 품질 테스트 |
공통 플래그
| 플래그 | 목적 |
|---|---|
--cursor, --devin, --claude, --codex | 특정 에이전트 대상 |
--all | 지원되는 모든 에이전트에 설치 |
--yes / -y | 비대화형 모드 (CI/CD) |
--dry-run | 변경 없이 미리보기 |
--symlink | 복사 대신 심링크 |
--global / --project | 범위 선택 |
지원되는 에이전트 (총 87개 · 27개 검증됨)
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 외 45개.
예시
GitHub에서 설치
rolecraft install vercel-labs/agent-skills --skill frontend-design
여러 에이전트에 설치
rolecraft install ./my-team-rules --cursor --devin --copilot --all
CI 파이프라인 설치
rolecraft ci --yes
자신만의 스킬 생성 및 설치
rolecraft init my-skill
rolecraft install ./my-skill --all