Skill 테스트하고 배포하기
Skill 반복 개선하고 팀과 공유하기
⏱ 예상 ~6분
01 · 읽기
Skill 작성은 작업의 절반에 불과해요. 테스트도 해야 해요 - 그리고 반복 개선해야 하죠.
종이 위에선 맞아 보이던 skill 이 실제로 쓰면 일관되지 않은 결과를 낼 수 있어요. Claude가 다섯 규칙 중 네 개만 따르고 하나를 놓칠 수도 있어요. 모호한 지시를 내 의도와 다르게 해석할 수도 있어요.
테스트 루프는 간단해요: skill 을 활성화하고, Claude에게 그걸 발동시킬 작업을 주고, 출력이 규칙을 따르는지 확인하고, 안 되면 skill 을 다듬어요.
코드처럼 skill 도 반복으로 더 좋아져요. 대부분의 skill 은 안정적으로 작동하기까지 2-3 회의 다듬기가 필요해요.
핵심 정리
- /skill 로 활성화하고 Claude에게 관련 작업을 줘서 skill 을 테스트해요
- skill 본문의 모든 규칙에 대해 출력을 확인해요
- 엣지 케이스를 테스트해요 - 이상한 입력에는 어떻게 되나요?
- 반복: 대부분의 skill 은 2-3 회의 다듬기가 필요해요
- git 으로 skill 의 버전을 관리해요 - skill 도 결국 파일이에요
02 · 단계별 설명
Skill 을 만들거나 업데이트할 때마다 이 흐름을 따라요.
1. skill 만들거나 업데이트하기
SKILL.md 파일을 작성하거나 수정해요. .claude/skills/your-skill/SKILL.md 에 저장해요. 업데이트라면 한 번에 한 군데씩 바꿔야 효과를 볼 수 있어요.
2. /skill 로 활성화하기
Claude Code 대화에서 /skill 을 타이핑하고 목록에서 내 skill 을 선택해요. Claude 는 이제 내 지시문을 불러왔고 남은 대화 동안 그걸 따라요.
3. Claude에게 관련 작업 주기
Claude에게 내 skill 규칙을 발동시킬 일을 부탁해요. Code review skill 이면 코드 리뷰를 부탁해요. 커밋 메시지 skill 이면 커밋을 부탁해요. 장난감 예시 말고 진짜 입력을 써요.
4. 출력 확인하기
출력이 skill 의 모든 규칙을 따르나요? 모든 bullet, 모든 형식 요구사항, 모든 제약을 하나씩 봐요. 꼼꼼하게요 - 부분적으로만 맞으면 skill 을 다듬어야 해요.
5. 다듬고 반복하기
안 맞는 게 있으면 skill 본문을 업데이트해요. Claude가 벗어난 곳을 더 명확하게 해요. 올바른 출력의 예시를 추가해요. 모호한 표현을 없애요. 그리고 같은 작업으로 다시 테스트해요.
6. git 으로 커밋하기
Skill 이 여러 테스트 케이스에서 안정적으로 작동하면 커밋해요. Skill 도 파일이에요 - 다른 것들처럼 버전 관리에 속해요. git add .claude/skills/ && git commit -m 'feat: add code-reviewer skill'
03 · 읽기
Skill 이 안정적으로 작동하면 어디에 둘지 결정해요. 첫 강의에서 두 가지 위치를 배웠어요: 프로젝트 skill (.claude/skills/) 은 git 에 커밋되어 팀과 공유되고, 사용자 skill (~/.claude/skills/) 은 개인용이고 내 모든 프로젝트에 적용돼요.
규칙은 간단해요: 팀 컨벤션이면 프로젝트 skill 로 커밋해요. 개인 선호면 사용자 skill 로 보관해요.
핵심 정리
- 프로젝트 skill: git 에 커밋 -> 팀 전체가 혜택을 봐요
- 사용자 skill: 로컬에 보관 -> 개인 선호용
- 프로젝트 skill 은 다른 코드 변경처럼 커밋해요
04 · 퀴즈
방금 팀 커밋 메시지 형식을 강제하는 skill 을 만들었어요: 모든 커밋은 'feat:' 나 'fix:' 같은 타입 접두사로 시작해야 해요. 이게 프로젝트 skill 일까요 사용자 skill 일까요?
- 프로젝트 skill - 팀 컨벤션이고 git 에 커밋되니까요
- 사용자 skill - 개인 용도로 ~/.claude/skills/ 에 보관하니까요
- 둘 다 괜찮아요
- skill 이 아니라 설정 파일에 있어야 해요
05 · 빈칸 채우기
~/.claude/skills/ 에 저장되는 skill 은 모든 프로젝트에 걸쳐 따라다니기 때문에 _____ skill 이라고 불러요.
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.