클로드코드 /run-skill-generator: 내 앱 실행법을 스킬로 저장

/run으로 앱을 띄우려는데 "어떻게 빌드하고 실행하는지" 매번 설명해야 한다면 번거롭죠. /run-skill-generator는 내 프로젝트의 빌드·실행 방법을 스킬(작업 방법 설명서 묶음)로 만들어 둡니다. 한 번 설정해두면 이후 /run과 /verify가 그 방법을 알아서 따라가요.

정의 (뭐냐면)

/run-skill-generator는 /run과 /verify가 내 프로젝트를 빌드(소스를 실행 가능한 형태로 변환)하고 실행하는 방법을 스킬로 만들어 주는 명령어입니다.

/run은 앱을 실제로 띄워 확인하는 명령인데, 프로젝트마다 빌드·실행 명령이 다 다릅니다. 클로드코드가 그 방법을 모르면 매번 알려줘야 해요. 이 명령어는 그 실행 절차를 한 번 파악해서 재사용 가능한 스킬로 저장합니다. 그러면 다음부터 /run이나 /verify가 이 스킬을 참고해 자동으로 빌드·실행하게 돼요. 프로젝트 초기 설정 성격의 고급 명령어입니다.

어떻게 쓰나 (난이도별)

기초 — 실행 방법 스킬 생성

프로젝트에서 한 번 이렇게 칩니다.

/run-skill-generator

클로드코드가 내 프로젝트를 어떻게 빌드·실행하는지 파악해 스킬로 작성합니다. 이 작업은 프로젝트당 보통 한 번이면 충분해요.

흔한 함정

• 이건 한 번 해두는 설정 작업입니다. /run을 쓸 때마다 매번 실행할 필요는 없어요.
• 프로젝트의 빌드·실행 방식이 크게 바뀌면(예: 빌드 도구 교체) 스킬을 다시 생성해 주는 게 좋습니다. 옛날 방법으로 실행하려다 막힐 수 있어요.
• 생성된 스킬이 곧바로 인식되지 않으면 /reload-skills로 새로고침해 보세요.

실전 사례

새 프로젝트를 시작할 때 초기에 한 번 /run-skill-generator를 돌려두는 패턴이 대표적입니다. 이렇게 실행법을 스킬로 박아두면, 이후로는 /run만 쳐도 클로드코드가 알아서 앱을 빌드하고 띄워 줘요. 매번 설명하는 수고가 사라집니다.

이렇게 더 씁니다

여러 사람이 같은 프로젝트를 다룰 때, 실행 방법을 스킬로 공유해 통일하는 용도로도 쓸 수 있어요. 각자 머릿속에 있던 "이 프로젝트는 이렇게 실행한다"는 지식을 스킬로 굳혀두면, 새로 합류한 사람도 /run 한 줄로 바로 실행해 볼 수 있습니다.

정리

/run-skill-generator는 /run·/verify가 내 프로젝트를 빌드·실행하는 방법을 스킬로 만들어 주는 고급 명령어입니다. 프로젝트당 한 번 설정해두면 이후 실행이 자동화돼 반복 설명의 수고를 줄여줘요. 빌드 방식이 바뀌면 다시 생성하는 것만 기억하면 됩니다.

FAQ · 자주 묻는 질문

고급 명령어라는데, 입문자가 써도 프로젝트가 망가지지 않나요?

네, 부담 없이 써도 됩니다. 이 명령은 내 프로젝트를 어떻게 빌드·실행하는지 파악해 스킬이라는 설명서로 저장하는 설정 작업이에요. 코드를 바꾸는 게 아니라 실행 방법을 기록해 두는 것이라, 프로젝트 초기에 한 번 돌려두는 것으로 충분합니다.

언제, 얼마나 자주 실행해야 하나요?

새 프로젝트를 시작할 때 초기에 한 번 돌려두면 됩니다. /run을 쓸 때마다 매번 실행할 필요는 없어요. 한 번 스킬로 저장해 두면 이후로는 /run만 쳐도 클로드코드가 알아서 앱을 빌드하고 띄워 줘서, 매번 설명하는 수고가 사라집니다.

스킬을 만들었는데 동작하지 않으면 어떻게 하나요?

생성된 스킬이 곧바로 인식되지 않으면 /reload-skills로 새로고침해 보세요. 그리고 빌드 도구 교체처럼 프로젝트의 빌드·실행 방식이 크게 바뀌었다면, 옛날 방법으로 실행하려다 막힐 수 있으니 /run-skill-generator로 스킬을 다시 생성해 주는 게 좋습니다.

기준: Claude Code v2.1.154 (2026.05)