/run-skill-generator와 /run은 너무 저평가됨. 토큰 절약에 진짜 도움 됨.

Claude Code 스킬 중 충분히 주목받지 못하는 두 가지가 있습니다. 바로 /run-skill-generator와 /run입니다.

이 기능들이 해결하는 문제는 지루하지만 끊임없이 발생합니다. 에이전트는 여러분의 앱을 빌드하고 실행하는 방법을 모릅니다. 그래서 매 세션마다 레포지토리를 뒤져서 알아내죠. 이건 느리고, 일관성이 없으며, 매번 토큰 비용을 지불하게 만듭니다.

/run-skill-generator는 그 탐색 과정을 딱 한 번만 수행합니다. 어떻게 빌드하고, 어떻게 실행하고, 어떻게 앱을 구동할지를요. 그리고 이 모든 것을 프로젝트별 스킬로 작성합니다. 그 후에는 /run이 그 스킬을 읽고 바로 실행합니다. 한 번만 기록해 두세요. 매번 다시 알아내게 하지 마세요.

오늘 Spring Boot 앱에 실행해 봤습니다. curl 스모크 테스트 스크립트를 생성하더군요. Gradle 래퍼로 빌드하고, 포트에 있는 프로세스를 죽이고, jar를 실행하고, 시작을 기다렸다가 7개의 엔드포인트를 호출하고 깔끔하게 종료합니다. --keep-running 옵션을 쓰면 /run이 앱을 띄워둔 채로 계속 작업할 수도 있습니다.

또한 이 앱에만 해당하고 뻔하지 않은 내용들도 기록했습니다. 9000번 포트의 자체 서명 인증서 때문에 모든 curl에 -sk가 필요하다는 점, 폼 로그인 CSRF 토큰은 같은 세션 쿠키를 타야 한다는 점, 포트가 점유되었을 때의 조용한 바인드 실패, 실패처럼 보이지만 실제론 아닌 Gradle 경고 등이죠. 이런 건 추측할 수 있는 게 아닙니다. 에이전트는 매번 실행할 때마다 이걸 다시 알아내느라 턴을 낭비하거나 틀릴 겁니다. 이제는 스킬 안에 다 들어있죠.

이걸 설정해야 할 세 가지 이유입니다.

토큰. 가장 큰 이유죠. 스킬이 없으면 에이전트는 매 세션마다 레포에서 실행 단계를 다시 빌드합니다. /run이 집중된 스킬 하나만 읽게 하면 그 지출을 없앨 수 있습니다.

가벼운 CLAUDE.md. 실행 메커니즘은 매 턴마다 로드되는 파일에 있을 필요가 없습니다. 스킬은 /run이 필요할 때만 로드됩니다. 그 전에는 아니죠.

테스트. 에이전트가 앱을 안정적으로 실행하고 구동할 수 있게 되면, 실제로 앱을 테스트할 수 있습니다. 기능, 의존성, 라이브 타겟에 대한 보안 테스트까지요. 앱을 먼저 실행할 수 없다면 실행 중인 앱을 테스트할 수는 없으니까요.

혹시 프로젝트별 실행 스킬을 운영하고 계신 분 있나요? 어떻게 구성하셨는지 궁금하네요.