Claude Skills 완벽가이드 5편: 스킬 제작 실전 가이드

핵심 요지#

• 문제 정의: 완성된 스킬 예시를 봐도 내 상황에 맞는 스킬을 어떻게 만들어야 할지 모름
• 핵심 주장: 스킬 제작은 설계 철학 → 자유도 선택 → 반복 개선의 과정을 따르면 누구나 할 수 있다
• 주요 근거: Anthropic 공식 베스트 프랙티스 기반 방법론

문서가 설명하는 범위#

• 스킬 설계 철학: “Concise is key”와 자유도(Degrees of Freedom) 개념
• 필드별 작성법 + Gerund 네이밍, Progressive Disclosure 패턴
• Evaluation-Driven Development: 테스트 → 관찰 → 수정 사이클
• Claude와 함께 스킬을 반복 개선하는 방법

읽는 시간: 10분 | 난이도: 중급

원칙 1: “Concise is key” — 간결함이 핵심이다#

Anthropic 공식 문서의 첫 번째 원칙:

“Claude is already extremely smart — you don’t need to teach it what a customer service email looks like or how to write Python code.”

Claude는 이미 충분히 똑똑합니다. 이메일 작성법이나 파이썬 코드 작성법을 가르칠 필요가 없습니다.

스킬에는 Claude가 모르는 것만 담으세요.

• ✓ 회사 고유의 톤앤매너
• ✓ 특정 출력 포맷 요구사항
• ✓ 도메인 특화 규칙
• ✕ “이메일은 인사로 시작해야 한다” (Claude가 이미 앎)
• ✕ “문장은 명확하게 써야 한다” (Claude가 이미 앎)

원칙 2: “Degrees of Freedom” — 자유도를 선택하라#

모든 스킬을 똑같은 상세도로 작성하면 안 됩니다. 태스크의 성격에 따라 Claude에게 줄 자유도를 결정하세요.

High Freedom 예시 (간결한 지침):

1
## Instructions
2

3
브레인스토밍 세션을 진행하고 창의적인 아이디어를 제안한다.
4
사용자의 피드백에 따라 아이디어를 발전시킨다.

Low Freedom 예시 (상세한 지침):

1
## Instructions
2

3
1. 입력된 JSON 데이터를 파싱한다
4
2. 아래 스키마에 맞게 변환한다
5
3. 필수 필드 누락 시 에러 메시지를 반환한다
6
4. 출력은 반드시 아래 형식을 따른다:
7
   ```json
8
   {"status": "success", "data": {...}}
9
   ```

TIP

자유도 선택 가이드

• 출력 형식이 엄격하게 정해져 있다 → Low Freedom
• 일반적인 업무 자동화다 → Medium Freedom
• 창의적이거나 탐색적인 작업이다 → High Freedom

질문 1: 어떤 반복 작업을 자동화할 것인가?#

나쁜 답변

• “문서 작성을 도와주는 스킬” (너무 모호)
• “업무를 편하게 해주는 스킬” (구체성 없음)

좋은 답변

• “고객 불만 이메일에 공감하며 해결책을 제시하는 답장을 작성하는 스킬”
• “매주 팀장에게 보고하는 주간 업무 보고서를 만드는 스킬”
• “회의 내용을 정해진 양식의 회의록으로 정리하는 스킬”

TIP

구체성 테스트: “이 스킬로 [입력]을 넣으면 [출력]이 나온다”를 한 문장으로 말할 수 있어야 합니다.

질문 2: 언제 활성화되어야 하는가?#

Claude는 description을 보고 스킬 활성화 여부를 판단합니다.
어떤 키워드나 상황에서 이 스킬이 필요한지 생각해보세요.

질문 3: 어떤 입력을 받고 어떤 출력을 내는가?#

스킬의 핵심은 입력 → 처리 → 출력입니다.

Step 1: name 정하기#

name은 스킬의 식별자입니다. 공식 스펙의 규칙을 지켜야 합니다.

규칙 (공식 스펙 기준)

• 소문자 영문(a-z), 숫자, 하이픈(-)만 사용
• 밑줄(_)이나 대문자는 사용 불가
• 하이픈으로 시작하거나 끝날 수 없음
• 연속 하이픈(--) 사용 불가
• 최대 64자
• 예약어 사용 불가: anthropic, claude
• XML 태그 포함 불가

Gerund 네이밍 컨벤션 (베스트 프랙티스)

Anthropic은 스킬 이름을 동명사(Gerund)로 시작하도록 권장합니다.

사고 과정

1
"고객 불만 응대 스킬"을 만들고 싶다
2
→ 한글은 안 됨
3
→ 영어로: responding to customer complaints
4
→ Gerund로 시작: responding-to-complaints
5
→ 좀 길다. 줄이자: responding-to-cs
6
→ 소문자 확인: ✓ (이미 소문자)

좋은 예시: responding-to-cs, processing-orders, writing-emails

나쁜 예시: CS_Complaint (대문자, 밑줄), -complaint (하이픈 시작), complaint-handler (Gerund 아님)

1
name: responding-to-cs

Step 2: description 작성하기#

description²은 Claude가 스킬을 선택할 때 보는 유일한 정보입니다.

Progressive Disclosure 패턴 (베스트 프랙티스)

Anthropic은 스킬 정보를 단계적으로 공개하도록 권장합니다.

글자 제한

• Claude: 최대 1024자 (모든 등록 방법 동일)
• 권장: ~100 tokens (약 300-400자)로 핵심만

공식 스펙 (Claude Help Center)

1
[무엇을 하는가] + [언제 사용하는가]

사고 과정

1
무엇을 하는가?
2
→ "고객 불만 이메일에 공감하며 해결책을 제시하는 답변을 작성한다"
3

4
언제 사용하는가?
5
→ "컴플레인 답장", "불만 메일 회신", "클레임 답변" 요청 시
6

7
Progressive Disclosure 체크
8
→ 핵심만 담았나? ✓
9
→ 상세 지침은 SKILL.md body에 있나? ✓

좋은 예시 (공식 문서 스타일):

1
description: 고객 불만 이메일에 공감과 해결책을 담은 CS 답변 작성. '컴플레인 답장', '불만 회신', '클레임 답변' 요청 시 사용.

나쁜 예시:

1
description: 이메일 작성 도움.

WARNING

반드시 3인칭으로 작성하세요. description은 시스템 프롬프트에 주입되므로, 일관된 시점을 유지해야 합니다.

• ✓ “고객 불만 이메일에 공감과 해결책을 담은 CS 답변 작성.” (3인칭)
• ✕ “고객 불만 이메일에 답변을 작성해 드립니다.” (1인칭)

TIP

Progressive Disclosure 핵심:
description은 ~100 tokens로 간결하게.
상세 지침은 SKILL.md body에,
참고 자료는 reference/에 분리하세요.

Step 3: Instructions 설계하기#

Instructions는 Claude가 따라야 할 단계별 지시사항입니다.
앞서 선택한 자유도에 따라 상세도를 조절하세요.

자유도별 Instructions 작성법

사고 과정 (Medium Freedom 예시)

1
화난 고객 이메일에 답장하려면 뭘 해야 하지?
2
→ 자유도: Medium (일반적인 업무 자동화)
3

4
1단계: 불만 이메일 분석
5
→ 고객의 감정 상태, 핵심 불만, 원하는 해결책 파악
6

7
2단계: 공감 표현
8
→ 감정 인정, 불편 사과, 책임 회피 안 함
9

10
3단계: 해결책 제시
11
→ 구체적 보상/처리 방안, 재발 방지 약속
12

13
"Concise is key" 체크
14
→ "이메일은 인사로 시작해야 한다" 같은 건 안 씀 (Claude가 이미 앎)
15
→ 회사 고유의 톤앤매너와 구조만 명시

Medium Freedom 예시 (CS 답변 스킬):

1
## Instructions
2

3
### 1. 분석 (출력하지 않음)
4

5
입력된 이메일에서 파악:
6

7
- 감정 강도: 낮음/중간/높음
8
- 불만 유형: 배송/품질/서비스/환불/기타
9
- 요구사항: 환불/교환/보상/사과/정보요청
10

11
### 2. 답변 구조
12

13
[인사] 고객명 + 정중한 인사
14
[사과] 불편에 대한 진심어린 사과
15
[확인] 파악한 문제 요약
16
[해결] 구체적 처리방안 (일정 포함)
17
[마무리] 재발방지 + 연락처

TIP

“Concise is key” 적용하기 위 예시에서 “문장은 명확하게 써야 한다”, “고객을 존중해야 한다” 같은 내용은 의도적으로 뺐습니다. Claude는 이미 알고 있기 때문입니다.

Step 4: Examples 작성하기#

Examples는 few-shot learning을 위한 핵심입니다.
최소 1개는 실제 출력 전문을 포함하고, 나머지는 핵심 요약으로 작성하면 효과적입니다.

사고 과정

1
모든 예시를 전체로 쓰면 너무 길다
2
→ 첫 번째 예시는 실제 출력 전문 (정확도 향상)
3
→ 나머지는 핵심만 요약 (간결성 유지)

1
## Examples
2

3
### Example 1: 배송 미수령 (실제 출력)
4

5
**Input:** 배송완료인데 물건 없음, 여행 전 급함, 환불 또는 재배송 요구
6
**Output:**
7
김OO 고객님, 안녕하세요.
8

9
먼저 배송 문제로 불편을 드린 점 진심으로 사과드립니다.
10
[실제 이메일 본문 전체...]
11

12
### Example 2: 제품 불량 (핵심 요약)
13

14
**Input 핵심:** 고가 제품 작동 불량, AS 떠넘기기 경험
15
**Output 핵심:**
16

17
- 사과: 제품 신뢰 손상에 대한 사과
18
- 해결: ①전액 환불 ②또는 신품 교환 ③불편 보상

TIP

Examples 베스트 프랙티스

• 첫 번째 예시는 실제 출력 전문을 포함 (Claude 정확도 향상)
• 나머지 예시는 핵심 요약으로 간결하게 유지

Step 5: Guidelines 추가하기 (선택)#

엣지케이스나 스타일 규칙이 있다면 Guidelines에 추가합니다.
DO/DON’T 테이블과 필수/금지 리스트로 구분하면 명확합니다.

1
## Guidelines
2

3
| DO               | DON'T                      |
4
| ---------------- | -------------------------- |
5
| 감정 먼저 인정   | 변명, 책임 전가            |
6
| 구체적 일정 제시 | "빠른 시일 내" 모호한 표현 |
7
| 선택지 제공      | 일방적 해결책 강요         |
8

9
**필수:** "죄송합니다" (첫 문단), 처리 예상 일정
10
**금지:** 이모지, 고객 탓 암시

Step 6: Output Format 지정하기 (선택)#

최종 결과물의 형식을 명시합니다. Claude가 어떤 형태로 출력할지 결정하는 데 도움이 됩니다.

1
## Output Format
2

3
CS 답변 이메일 본문 텍스트 (복사하여 바로 사용 가능)

TIP

일반적인 Output Format 예시

• 문서: .docx, .md, .pdf
• 데이터: JSON, CSV, 표 형식
• 코드: Python, JavaScript 등

Step 1: 최소 스킬로 시작하기#

처음부터 완벽한 스킬을 작성하려고 하지 마세요.
description + 기본 Instructions만으로 시작합니다.

1
---
2
name: responding-to-cs
3
description: 고객 불만 이메일에 공감과 해결책을 담은 CS 답변 작성. '컴플레인 답장', '불만 회신' 요청 시 사용.
4
---
5

6
# CS 답변 스킬
7

8
## Instructions
9

10
고객 불만 이메일을 분석하여 공감 → 해결책 구조의 답변을 작성한다.

Step 2: 테스트 실행#

새 대화를 열고 테스트합니다.

1
컴플레인 답장 작성해줘.
2

3
주문번호 ORD-2024-98765, 이영수입니다.
4
2주 전 구매한 청소기가 작동 안 됨. AS센터도 본사 연락하래서 답답함.
5
80만원짜리인데 금요일까지 환불 안 되면 소보원 신고 예정.

Step 3: 실패 관찰 및 분석#

출력을 보고 기대와 다른 부분을 기록합니다.

Step 4: 지침 수정#

관찰된 실패를 바탕으로 필요한 부분만 추가합니다.

1
## Tone by Emotion Level
2

3
| 감정 강도 | 톤                    | 특징                 |
4
| --------- | --------------------- | -------------------- |
5
| 낮음      | 친절, 간결            | 표준 응대            |
6
| 중간      | 공감 강화             | 불편 인정            |
7
| 높음      | 책임 인정 + 즉시 해결 | 변명 없음, 추가 보상 |
8

9
## Legal Sensitivity
10

11
- 소비자원/소송 언급 시 → 방어적 표현 금지

Step 5: 반복#

다른 테스트 케이스로 다시 테스트 → 관찰 → 수정을 반복합니다.

WARNING

과도한 지침 추가 금지
실패가 관찰되지 않은 부분은 추가하지 마세요.
”혹시 몰라서” 추가하면 토큰 낭비 + 오히려 성능 저하가 발생합니다.

방법 1: 스킬 선택 후 피드백 요청#

1. 대화에서 해당 스킬을 활성화
2. Claude에게 질문

1
이 스킬의 SKILL.md를 보고 개선점을 제안해줘.
2
특히:
3
- 불필요하게 장황한 부분
4
- 누락된 엣지케이스
5
- 더 명확하게 표현할 수 있는 부분

방법 2: 테스트 결과와 함께 개선 요청#

1
이 스킬로 아래 입력을 처리했는데, 출력이 기대와 다릅니다.
2

3
[입력]
4
주문번호 ORD-2024-98765...
5

6
[실제 출력]
7
...
8

9
[기대한 출력]
10
...
11

12
SKILL.md를 어떻게 수정하면 될까요?

방법 3: 워크플로우 패턴 적용#

복잡한 작업은 워크플로우 패턴으로 구성할 수 있습니다.

1
## Workflow
2

3
1. 입력 분석 후 중간 결과를 사용자에게 보여준다
4
2. 사용자 피드백을 받아 수정한다
5
3. 최종 결과물을 생성한다

TIP

Claude는 좋은 스킬 리뷰어입니다 Claude는 이미 수많은 스킬을 학습했습니다.
스킬 개선에 Claude를 활용하세요.