클로드 스킬 점검 프롬프트 — 앤트로픽 공식 규칙 7가지로 내 스킬 고치기

낭만빌더 유튜브 「앤트로픽 피셜: 스킬 만드는 규칙 바뀜」 영상 설명란 자료. 근거: 앤트로픽 공식 문서 「Skill 작성 모범 사례」(platform.claude.com/docs/ko/agents-and-tools/agent-skills/best-practices), 「Claude Fable 5 프롬프팅」.

쓰는 법

1. 클로드 코드(또는 스킬 폴더를 연결한 클로드 채팅)를 엽니다.
2. 아래 상자 안 내용을 통째로 붙여 넣습니다. <스킬 폴더 경로>만 바꿔주세요. 비워두면 .claude/skills/를 봅니다.
3. 클로드가 먼저 점검표와 바꿀 내용 목록만 보여줍니다. 승인하신 것만 고칩니다.

---

<스킬 폴더 경로> 안에 있는 스킬을 전부 점검해줘. 경로가 비어 있으면 .claude/skills/ 를 봐.

중요: 이번 단계에서는 파일을 하나도 고치지 마. 먼저 점검 결과와 바꿀 내용만 보여주고, 내가 승인한 항목만 고쳐.

스킬마다 아래 7가지 규칙으로 점검해. 각 규칙은 통과 / 고칠 것 / 해당 없음 중 하나로 판정하고, 판정 근거로 파일 이름과 줄 번호를 적어.

1. 목차
   - 100줄이 넘는 참고 파일을 전부 찾아서 줄 수를 적어.
   - 맨 위에 목차가 없으면, 그 파일의 제목(##)에 맞춘 목차 초안을 보여줘.

2. 자유도
   - SKILL.md의 단계를 하나씩 나눠서, 단계마다 이렇게 물어봐: "클로드가 이 단계를 다르게 하면 무슨 일이 생기지?"
   - 별일 없는 단계(글쓰기, 아이디어, 리뷰)는 목표만 주고 방법은 열어둬도 되는지 봐.
   - 큰일 나는 단계(돈이 오가는 일, 삭제, 발송, 데이터 이전)는 글 지시 대신 정해진 스크립트로 잠겨 있는지 봐.
   - 잠겨야 하는데 글로만 써 있는 단계는 "스크립트로 바꿀 후보"로 따로 적어.

3. 모델
   - SKILL.md 맨 위 머리말(YAML frontmatter)에 어떤 모델용인지 적혀 있는지 봐. 없으면 넣을 줄을 제안해.
   - 하이쿠 기준: 안내가 충분한가? 빠지기 쉬운 단계가 있는가?
   - 소넷 기준: 군더더기 없이 명확한가?
   - 오퍼스 기준: 설명이 너무 많지 않은가? 대문자 강조, "반드시/절대" 반복처럼 예전 모델용으로 넣은 지시가 있는가?
   - 최신 모델에서 빼봐도 될 것 같은 지시는 "지워보고 비교할 후보"로 적어. 바로 지우지는 마.

4. 참조는 한 단계만
   - SKILL.md가 가리키는 파일 목록을 적어.
   - 다른 참고 파일을 거쳐야만 닿는 파일이 있으면(SKILL.md → A.md → B.md) 사슬을 그대로 적고, SKILL.md에서 바로 이을 줄을 제안해.
   - SKILL.md 본문이 500줄에 가까우면 따로 뺄 부분을 제안해.
   - 여러 분야를 다루는 스킬이면 참고 파일을 분야별로 나눌 수 있는지 봐.

5. 체크리스트
   - 순서가 중요한 긴 작업인데 체크리스트가 없으면 넣을 초안을 보여줘. 단계마다 짧은 설명 한 줄씩.
   - 확인 단계가 실패했을 때 몇 단계로 돌아갈지 적혀 있는지 봐("빠진 게 있으면 3단계로 돌아가라" 같은 줄).
   - 순서가 상관없는 작업에 체크리스트가 붙어 있으면 빼도 된다고 적어.

6. 피드백 루프
   - 결과를 검사하는 기준(스크립트, 스타일 가이드, 말투 문서 등)이 있는지 봐.
   - "검사 → 틀린 것 고치기 → 통과할 때까지 반복 → 통과해야 끝" 흐름이 있는지 봐.
   - 없으면 넣을 문단을 제안해. 기준 문서에 없는 이유로 걸렸을 때, 작업 끝에 새 규칙을 하나 제안하고 내 승인을 받으라는 줄도 넣어.

7. 설치
   - 스킬이 쓰는 도구, 패키지, 명령을 전부 찾아서 적어.
   - 설치돼 있다고 가정한 곳("pdf 라이브러리로 처리해라")에 설치 줄(예: pip install pypdf)과 패키지 이름이 있는지 봐.
   - 스크립트마다 옆에 설치 줄이 붙어 있는지 봐.

마지막에 이렇게 보여줘:
- 스킬별 점검표 (규칙 7개 × 판정 × 근거 줄)
- 바꿀 내용 목록: 번호, 스킬 이름, 파일, 바꾸기 전 → 바꾼 뒤(짧게), 이유가 된 규칙 번호
- 위험도 순서: 큰일 나는 단계(규칙 2)부터, 그다음 참조 사슬(4), 목차(1), 나머지

내가 "1, 3, 5번 진행"처럼 번호를 주면 그것만 고치고, 고친 뒤 바뀐 줄만 다시 보여줘.

---

이 프롬프트가 하지 않는 것

• 승인 전에는 파일을 고치지 않습니다.
• 스크립트를 실행하거나 패키지를 설치하지 않습니다. 설치 줄을 적어두기만 합니다.
• 스킬 밖의 파일은 건드리지 않습니다.