빠른 흐름

/run
  -> 앱을 실행하고 실제 동작 확인

/verify
  -> 변경이 의도대로 동작하는지 검증

/run-skill-generator
  -> 프로젝트별 실행 레시피를 skill로 기록

검증 흐름

bundled skill은 고정 명령보다 prompt 기반 작업 절차에 가깝다

Claude Code의 bundled skills는 모든 세션에서 사용할 수 있는 기본 skill 묶음입니다. /code-review, /batch, /debug, /loop, /claude-api처럼 특정 작업을 prompt 기반 절차로 실행합니다. built-in command가 정해진 로직을 바로 실행하는 표면에 가깝다면, bundled skill은 Claude가 도구를 사용해 절차를 수행하도록 지시하는 재사용 프롬프트에 가깝습니다.

built-in command
  -> Claude Code 자체 제어

bundled skill
  -> 작업 절차를 Claude에게 로드
  -> Claude가 도구와 판단을 사용해 수행

명령 목록에서는 둘 다 /로 호출되므로, 실제로는 "고정 제어 명령인지, 작업 절차 skill인지"를 구분해서 봐야 합니다.

/run과 /verify는 테스트만으로 부족한 변경 확인에 쓴다

/run은 앱을 띄워 실제 화면이나 동작을 확인하는 데 초점을 둡니다. /verify는 변경 사항이 의도한 동작을 만족하는지 확인하는 데 초점을 둡니다. 단순히 npm test가 통과했는지보다, 사용자가 체감할 결과가 실제 실행 환경에서 확인되는지를 보려는 흐름입니다.

코드 수정
  -> 단위 테스트 또는 빌드
  -> /run으로 실제 실행
  -> /verify로 변경 의도 확인

웹 앱, CLI, TUI, 브라우저 기반 도구처럼 "실행해서 봐야 하는 결과"가 있는 프로젝트에서 특히 유용합니다.

/run-skill-generator는 실행법이 복잡한 프로젝트에서 필요하다

기본 /run과 /verify는 README, package.json, Makefile 같은 흔한 단서를 보고 실행법을 추론합니다. 하지만 DB, 환경 변수, 시드 데이터, 여러 프로세스, GUI 세션이 필요한 프로젝트는 추론만으로 안정적이지 않습니다. 이때 /run-skill-generator로 프로젝트 실행 레시피를 기록해 두면 다음 검증부터 같은 방법을 재사용할 수 있습니다.

/run-skill-generator
  -> 설치 명령 확인
  -> 필요한 환경 변수 확인
  -> 실행 명령 확인
  -> .claude/skills/run-<name>/ 에 레시피 기록

실행 방식이 바뀌면 이 skill도 다시 갱신해야 합니다. 오래된 실행 레시피는 실패 원인을 오히려 숨길 수 있습니다.

실행 검증은 프로젝트 안전장치와 같이 써야 한다

/run과 /verify는 실제 앱 실행을 다루므로 포트 사용, 외부 API 호출, 데이터베이스 연결, 파일 쓰기 같은 side effect를 만들 수 있습니다. 로컬 전용 환경과 운영 자격 증명을 분리하고, destructive command가 들어간 실행 스크립트는 permissions와 settings에서 차단해야 합니다.

체크포인트

주의할 점

/run-skill-generator가 만든 실행 레시피는 프로젝트 지식이므로 저장소에 커밋할지, 개인 설정으로 둘지 결정해야 합니다. 팀 전체가 같은 방식으로 앱을 띄워야 한다면 project skill이 맞고, 개인 장비 경로가 들어가면 공유하면 안 됩니다.