스킬 시스템 - 재사용 가능한 능력 만들기
이 장에서 배우는 것
- 스킬이 무엇인지
- SKILL.md 작성법
- 트리거 설정
- 공식 스킬 레포 활용
스킬이란?
Claude Code에게 특정 작업 방법을 가르치는 방법입니다.
Anthropic 공식 정의: “스킬은 Claude가 특정 작업을 반복적으로 수행하도록 가르치는 폴더 구조입니다.”
| CLAUDE.md | 스킬 (SKILL.md) |
|---|---|
| 프로젝트 맥락 | 작업 수행 방법 |
| 항상 적용 | 트리거 조건 충족 시 적용 |
| 규칙, 설정 | 절차, 템플릿 |
공식 스킬 레포지토리
참고: anthropics/skills - 61,000+ 스타
Anthropic이 공식 관리하는 스킬 컬렉션으로, 창작, 기술, 비즈니스 등 다양한 영역의 스킬이 있습니다.
스킬이 필요한 상황
- 같은 형식의 문서를 반복 작성할 때
- 특정 작업 절차가 정해져 있을 때
- 팀 전체가 동일한 방식으로 작업해야 할 때
예시:
- 회의록 작성
- 주간 보고서
- 이메일 답장
- 경쟁사 분석
- PRD 작성
폴더 구조
프로젝트별 스킬
.claude/skills/
├── meeting-notes/
│ └── SKILL.md
├── weekly-report/
│ └── SKILL.md
└── email-reply/
└── SKILL.md전역 스킬 (모든 프로젝트에서 사용)
~/.config/claude/skills/
├── my-writing-style/
│ └── SKILL.md
└── korean-business-email/
└── SKILL.mdSKILL.md 기본 구조
공식 스펙: anthropics/skills/spec
최소 구조
my-skill/
└── SKILL.mdSKILL.md 형식
---
name: my-skill-name
description: 이 스킬이 무엇을 하는지 명확하게 설명
---
# 스킬 제목
[Claude가 따를 지침을 여기에 작성]
## 예시
- 사용 예시 1
- 사용 예시 2
## 가이드라인
- 가이드라인 1
- 가이드라인 2필수 프론트매터
| 필드 | 설명 | 예시 |
|---|---|---|
name | 고유 식별자 (소문자, 하이픈) | meeting-notes |
description | 스킬 기능 설명 | 회의 내용을 구조화된 회의록으로 작성 |
스킬 매칭 방식
Claude가 스킬을 선택하는 방법
Claude는 사용자 요청과 스킬의 name, description을 비교하여 적합한 스킬을 선택합니다.
---
name: meeting-notes
description: 회의 내용을 구조화된 회의록으로 작성합니다. 참석자, 안건, 결정사항, 액션아이템을 정리합니다.
---사용자가 “회의 내용 정리해줘”라고 하면, description의 키워드와 매칭되어 이 스킬이 적용됩니다.
효과적인 description 작성
1. 구체적으로 작성
# 나쁜 예 - 너무 일반적
description: 보고서 작성
# 좋은 예 - 구체적
description: 주간 업무 보고서를 작성합니다. 핵심 성과, 진행 현황, 이슈, 다음 주 계획을 포함합니다.2. 키워드 포함
description: 비즈니스 이메일 답장을 작성합니다. 수락, 거절, 일정 조율, 정보 요청 등 다양한 상황에 대응합니다.3. 고유하게 작성
여러 스킬의 description이 유사하면 혼란이 발생합니다.
실전 스킬 예시
회의록 스킬
---
name: meeting-notes
description: 회의 내용을 구조화된 회의록으로 작성합니다. 참석자, 안건, 결정사항, 액션아이템을 체계적으로 정리합니다.
---
# 회의록 작성 스킬
## 목적
회의 내용을 구조화된 형식으로 정리합니다.
## 입력
회의 중 메모한 내용, 녹취록, 또는 구두 설명
## 절차
1. 회의 기본 정보 정리 (일시, 참석자, 안건)
2. 논의 내용 요약
3. 결정 사항 정리
4. 액션 아이템 추출 (담당자, 기한 포함)
5. 다음 회의 안건 정리
## 출력 형식회의록: [회의 제목]
기본 정보
- 일시: YYYY-MM-DD HH:MM
- 참석자:
- 장소/방식:
안건
논의 내용
안건 1: [제목]
안건 2: [제목]
결정 사항
- [ ]
액션 아이템
| 항목 | 담당자 | 기한 |
|---|---|---|
다음 회의
- 일시:
- 안건:
## 주의사항
- 발언자 이름은 정확히 기록
- 민감한 정보는 [민감정보]로 표시
- 결정되지 않은 사항은 "논의 중"으로 표기
- 액션 아이템은 반드시 담당자와 기한 명시이메일 답장 스킬
---
name: email-reply
description: 비즈니스 이메일 답장을 작성합니다. 수락, 거절, 일정 조율, 정보 요청 등 상황에 맞는 답장을 작성합니다.
---
# 이메일 답장 스킬
## 목적
받은 이메일에 대한 적절한 비즈니스 답장을 작성합니다.
## 입력
- 받은 이메일 내용
- 답장 방향 (수락/거절/문의/요청 등)
- 추가 정보 (있으면)
## 절차
1. 원본 이메일의 핵심 요청 파악
2. 적절한 인사말 선택
3. 본문 작성 (요청에 대한 응답)
4. 다음 단계 또는 후속 조치 제시
5. 마무리 인사
## 출력 형식제목: Re: [원본 제목]
[상대방 이름/직함]님,
[인사말 - 상황에 맞게]
[본문 - 요청에 대한 응답]
[다음 단계 또는 추가 정보]
[마무리 인사]
[내 이름] [직함/소속]
## 톤앤매너
- 공손하지만 간결하게
- 애매한 표현 피하기
- 구체적인 날짜/시간 명시
- 요청사항은 명확하게
## 상황별 템플릿
### 수락
"말씀하신 [요청 내용]에 대해 검토 결과, 진행 가능합니다.
[구체적인 진행 방법/일정]으로 진행하겠습니다."
### 거절
"검토 결과, 현재로서는 [구체적 이유]로 인해 어려울 것 같습니다.
대안으로 [대안 제시]을 제안드립니다."
### 추가 정보 요청
"진행을 위해 아래 사항에 대해 확인 부탁드립니다.
1. [필요 정보 1]
2. [필요 정보 2]"
### 일정 조율
"제안해주신 일정 중 [가능 일정]이 가능합니다.
[장소/방식]으로 진행하면 어떨까요?"주간 보고서 스킬
---
name: weekly-report
description: 주간 업무 보고서를 작성합니다. 핵심 성과, 완료/진행 업무, 이슈, 다음 주 계획을 포함합니다.
---
# 주간 보고서 스킬
## 목적
한 주간의 업무를 정리하여 보고서를 작성합니다.
## 입력
- 이번 주 완료한 업무 (간단히 나열해도 됨)
- 진행 중인 업무
- 이슈/블로커
- 다음 주 계획
## 절차
1. 핵심 성과 3개 선정
2. 완료 업무 정리 (성과 중심)
3. 진행 중 업무 상태 업데이트
4. 이슈 및 해결 방안 정리
5. 다음 주 계획 수립
## 출력 형식주간 보고서
보고자: [이름] 기간: YYYY.MM.DD - YYYY.MM.DD
핵심 성과 (Top 3)
- [성과 1 - 숫자로 표현]
- [성과 2 - 숫자로 표현]
- [성과 3 - 숫자로 표현]
완료 업무
| 업무 | 성과/결과 | 비고 |
|---|---|---|
진행 중 업무
| 업무 | 진척률 | 예상 완료일 | 블로커 |
|---|---|---|---|
| __% |
이슈 및 블로커
| 이슈 | 영향도 | 해결 방안 | 상태 |
|---|---|---|---|
| 높음/중간/낮음 | 해결됨/진행중/대기 |
다음 주 계획
| 업무 | 우선순위 | 예상 소요 |
|---|---|---|
| P0/P1/P2 |
기타 공유사항
## 작성 규칙
- 성과는 **숫자로 표현** (예: "고객 문의 30건 처리" not "고객 문의 많이 처리")
- 진척률은 **구체적으로** (예: "70%" not "거의 완료")
- 이슈는 **해결 방안과 함께** 제시
- 다음 주 계획은 **우선순위 포함**스킬 만드는 방법
방법 1: 직접 작성
# 폴더 생성
mkdir -p .claude/skills/my-skill
# 파일 생성 (에디터로)
# .claude/skills/my-skill/SKILL.md 작성방법 2: Claude에게 요청
> 내가 자주 하는 작업이 있어.
> [작업 설명]
> 이걸 스킬로 만들어서 .claude/skills에 저장해줘.방법 3: 공식 스킬 레포에서 가져오기
anthropics/skills에서 원하는 스킬을 찾아서 복사:
> anthropics/skills 레포에서 [스킬명] 스킬 찾아서
> .claude/skills에 복사해줘.방법 4: 커뮤니티 스킬 활용
스킬 사용하기
자동 적용
요청 내용이 스킬의 name이나 description과 매칭되면 자동으로 적용됩니다.
> 오늘 회의 내용 정리해서 회의록 만들어줘.
> [회의 내용]→ description의 “회의록”, “회의 내용” 키워드로 meeting-notes 스킬 자동 적용
명시적 호출
스킬 이름을 직접 지정할 수도 있습니다.
> meeting-notes 스킬 사용해서 정리해줘스킬 목록 확인
> 현재 사용 가능한 스킬 목록 보여줘스킬 관리 팁
1. 작게 시작
처음엔 간단한 스킬부터:
- 이메일 서명
- 일일 보고
- 간단한 템플릿
2. 점진적 개선
사용하면서 다듬기:
> 이 스킬에서 [부분]을 [수정사항]으로 바꿔줘3. 팀과 공유
좋은 스킬은 git에 커밋해서 팀과 공유:
git add .claude/skills/
git commit -m "Add weekly-report skill"
git push4. 버전 관리
스킬도 git으로 관리하면 변경 이력 추적 가능.
공식 스킬 레포 구조
anthropics/skills 레포의 구조:
skills/
├── creative/ # 창작 (아트, 음악, 글쓰기)
├── technical/ # 기술 (테스팅, MCP 서버)
├── business/ # 비즈니스 (보고서, 분석)
└── productivity/ # 생산성 (할일, 일정)스킬 가져오기 예시
> anthropics/skills 레포의 business/competitor-analysis 스킬을
> 내 프로젝트의 .claude/skills에 복사해줘고급: 스킬 체이닝
여러 스킬을 연결해서 복잡한 작업 수행:
> 다음 순서로 작업해줘:
> 1. competitor-analysis 스킬로 경쟁사 분석
> 2. 분석 결과를 weekly-report 스킬로 보고서 작성
> 3. email-reply 스킬로 팀에게 공유 메일 작성실습: 나만의 스킬 만들기
과제
자주 하는 반복 작업 하나를 스킬로 만들어보세요.
예시 아이디어:
- 일일 업무 정리
- 고객 응대 템플릿
- 제안서 초안
- SNS 포스트
- 회의 안건 작성
단계
- 반복 작업 선정
- 절차 정리
- Claude에게 스킬 생성 요청
- 테스트 및 수정
> 내가 매일 하는 [작업]이 있어.
> 절차는 이래:
> 1. [단계1]
> 2. [단계2]
> 3. [단계3]
>
> 이걸 스킬로 만들어줘.
> name은 [스킬이름], description은 "[작업 설명 - 키워드 포함]"으로 설정해줘.
> .claude/skills/[스킬이름]/SKILL.md에 저장해줘.참고 자료
| 리소스 | 설명 |
|---|---|
| anthropics/skills | Anthropic 공식 스킬 레포 (61k+ 스타) |
| Agent Skills Spec | 공식 스킬 명세서 |
| Skills API Quickstart | 공식 스킬 문서 |
| Claude Skills Support | 스킬 생성 가이드 |
| awesome-claude-skills | 커뮤니티 스킬 큐레이션 |
| awesome-agent-skills | 200+ 스킬 모음 |
다음 단계
스킬 시스템을 이해했다면, 이제 에이전트 팀을 구성해봅시다.