Cmd. /run-skill-generator
/run·/verify가 clean environment에서 앱을 빌드·실행·구동하는 방법을 학습하도록 프로젝트별 실행 스킬을 작성하는 번들 스킬(v2.1.145+).
핵심 요약
/run-skill-generator는/run·/verify가 앱을 빌드·실행·구동하는 방법을 담은 프로젝트별 스킬을 작성하는 번들 스킬입니다.- 한 번 실행 절차를 스킬 파일로 문서화해 두면 이후
/run·/verify가 매번 추론하지 않고 같은 절차를 따릅니다. - 데이터베이스·환경변수·멀티 서비스처럼 표준 실행을 벗어나는 프로젝트에서 특히 유용합니다.
- v2.1.145 이상이 필요하며, 미만 버전에서는 사용할 수 없습니다.
- 생성된 스킬은 production code처럼 리뷰하고, 구조가 바뀌면
/reload-skills(v2.1.152+)로 갱신하세요.
명령어 원본 선언
/run-skill-generator별도의 인자나 별칭(alias)은 없습니다. 메시지 맨 앞에서 /run-skill-generator만 입력하면 됩니다.
공식 설명 요약
/run-skill-generator는 Claude Code에 내장된 **번들 스킬(bundled skill)**입니다. 현재 프로젝트에서
/run과 /verify가 앱을 빌드(build), 실행(launch), 구동(drive)하는 방법을 학습하도록 프로젝트별
스킬(per-project skill)을 작성합니다. clean environment에서 앱을 띄우고 동작을 관찰하는 절차를
프로젝트 전용 스킬 파일로 문서화해 두면, 이후 /run·/verify가 그 절차를 그대로 따릅니다.
번들 스킬이므로 직접 작성한 스킬과 똑같이 동작합니다. 사용자가 명시적으로 호출할 수도 있고, 관련 상황에서 Claude가 알아서 실행할 수도 있는 프롬프트로 취급됩니다.
공식 문서 원문(요지):
Skill. Teach
/runand/verifyhow to build, launch, and drive your project's app from a clean environment by writing a per-project skill.
최소 지원 버전
v2.1.145이상 (Commands 문서 기준, "Requires Claude Code v2.1.145 or later")- 관련 번들 스킬
/run,/verify도 동일하게v2.1.145+를 요구합니다. - 디스크에 새로 만들어진 스킬을 세션 재시작 없이 다시 읽어들이는
/reload-skills는v2.1.152+가 필요합니다.
사용법
/run-skill-generator생성된 프로젝트별 스킬은 이후 /run·/verify가 참조하는 "앱 실행/검증 runbook" 역할을 합니다.
공식 문서의 Run and verify your app
절을 참고하세요.
좋은 사용 예
- 새 프로젝트에서 Claude가 dev server, build, browser check 순서를 모를 때
- CI와 로컬 실행 절차가 달라서 명시적인 runbook이 필요할 때
- 프론트엔드/백엔드/worker가 함께 떠야 하는 복합 앱
- clean environment(클론 직후 등)에서 반복 가능한 실행 절차를 한 번 정의해 두고 싶을 때
비슷한 명령어 추천
| 명령어 | 분류 | 차이점 | 언제 선택 |
|---|---|---|---|
/run-skill-generator | 번들 스킬 | 실행 스킬 생성 | 실행 절차를 먼저 가르칠 때 |
/run | 번들 스킬 | 앱 실행·구동·관찰 | 실행 스킬이 이미 있을 때 |
/verify | 번들 스킬 | 빌드·실행 후 결과 검증 | acceptance 기준을 확인할 때 |
/reload-skills | 명령어 (v2.1.152+) | 스킬 디렉터리 재스캔 | 생성·수정한 스킬을 즉시 반영할 때 |
활용 사례
- 신규 레포에 합류한 직후,
/run-skill-generator로 "앱을 어떻게 띄우는지"를 한 번 가르쳐 두면 이후/run·/verify가 매번 빌드/실행 명령을 추론하지 않고 일관된 절차를 따릅니다. - 멀티 서비스(프론트+백엔드+워커) 프로젝트에서 기동 순서와 헬스 체크 방법을 스킬에 담아 두면,
변경 검증 때
/verify가 같은 환경에서 동작을 관찰합니다.
주의사항
- 생성된 스킬은 production code처럼 리뷰하고, 위험한 명령이나 환경변수를 노출하지 않는지 확인하세요.
- 프로젝트 구조가 바뀌면
/reload-skills(v2.1.152+)로 변경 사항을 다시 반영하거나 세션을 재시작하세요./reload-skills는 스킬·명령어 디렉터리를 다시 스캔해 추가/삭제된 스킬 수를 보고합니다. - 이 명령은 번들 스킬이므로 v2.1.145 미만 버전에서는 사용할 수 없습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Skills (Run and verify your app): https://code.claude.com/docs/en/skills#run-and-verify-your-app