Claude Skills 완벽가이드 4편: 커스텀 스킬 개념과 구조

요약#

핵심 요지#

  • 문제 정의: 동일한 형식의 요청을 반복할 때 매번 전체 지시를 입력해야 하는 상황
  • 핵심 주장: 커스텀 스킬을 정의하면 키워드 기반 자동 활성화로 반복 입력을 제거할 수 있다
  • 주요 근거: Claude Help Center 공식 문서에서 제공하는 커스텀 스킬 기능

문서가 설명하는 범위#

  • 바로 쓰는 SKILL.md1 템플릿 (최소/전체)
  • description2 필드 작성법과 자동 활성화 메커니즘
  • 스킬 등록 방법 3가지
  • 실전 예시: 회의록 자동 정리 스킬

읽는 시간: 7분 | 난이도: 초급~중급


참고 자료#


이런 경험 있으세요?#

“주간 보고서 만들어달라고 할 때마다 슬라이드 구성, 디자인, 형식을 매번 설명해야 해요.”

“회의록 정리할 때마다 같은 양식을 계속 알려줘야 해서 번거로워요.”

“반복되는 요청인데 매번 처음부터 다시 설명하는 느낌이에요.”

해결책이 있습니다. 커스텀 스킬을 등록하면 키워드만으로 원하는 형식의 결과물을 받을 수 있습니다.


바로 쓰는 SKILL.md 템플릿#

커스텀 스킬의 핵심은 SKILL.md 파일입니다. 아래 템플릿을 복사해서 [] 안의 내용만 채우세요.

NOTE

마크다운 문법이 낯설다면? SKILL.md는 마크다운으로 작성합니다.

헤더(##), 리스트(-), 코드 블록 등 기본 문법이 필요하다면,
마크다운 완벽가이드 시리즈를 참고하세요.

최소 템플릿 (입문용)#

---
name: [영문 소문자, 숫자, 하이픈(-)만 사용 가능. 스킬 이름 예시: weekly-report, meeting-notes]
description: [스킬이 하는 일. '키워드1', '키워드2' 요청 시 사용.]
---
## Instructions
[Claude가 따라야 할 단계별 지시사항]
## Examples
### Input
[사용자가 입력할 요청 예시]
### Output
[Claude가 생성할 결과 예시]

전체 템플릿 (권장)#

---
name: [영문 소문자, 숫자, 하이픈(-)만 사용 가능. 예시: sales-summary, ai-review]
description: [스킬이 하는 일. '키워드1', '키워드2' 요청 시 사용.]
---
# [스킬 제목]
## Overview
[이 스킬의 목적과 핵심 기능 1-2문장]
## Instructions
### Step 1: [단계명]
- [구체적 행동 지시]
### Step 2: [단계명]
- [구체적 행동 지시]
## Examples
### Input
[실제 사용자 요청 예시 - 구체적일수록 좋음]
### Output
[Claude가 생성할 결과 예시 - 형식과 내용 모두 포함]
## Guidelines
- [문체/톤 지침]
- [하지 말아야 할 것]
- [엣지 케이스 처리 방법]
## Output Format
[출력 형식: .docx, .md, JSON 등]

각 요소의 중요도#

요소중요도설명
name★★★스킬 식별자. 소문자, 숫자, 하이픈만 (최대 64자)
description★★★Claude가 스킬 선택 시 이것만 봄 (최대 1024자)
Examples★★★입출력 예시. few-shot learning으로 품질 향상
Instructions★★복잡한 워크플로우일수록 필수
Guidelines엣지케이스가 많을 때 유용
선택적 필드license, metadata 등 (팀 공유/배포 시 유용)

섹션 헤더는 자유롭게 정해도 됩니다#

SKILL.md는 두 영역으로 나뉩니다.

영역처리 방식고정 여부
frontmatter (name, description)시스템이 파싱필수, 형식 고정
본문 (섹션 헤더, 내용)Claude가 자연어로 이해자유

## Instructions## 처리 절차## How It Works든 Claude는 다 이해합니다.
다만 의미 없는 헤더(## AAA, ## 1234)나 빈 섹션은 피하세요.

TIP

헤더 작성 원칙

  1. 이름은 자유지만, 의미는 명확하게
  2. 일관성 유지 (한국어면 한국어, 영어면 영어)
  3. ## Examples는 거의 필수 (few-shot 효과)

description 작성 공식#

공식 스펙 (Claude Help Center):

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

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

  • ✓ “주간 업무 보고서 PPT 생성.” (3인칭)
  • ✕ “주간 업무 보고서 PPT를 만들어 드립니다.” (1인칭)
  • ✕ “주간 업무 보고서 PPT를 만들 수 있습니다.” (1인칭)
# ✕ 모호한 예시
description: "문서를 도와줍니다"
# ✓ 공식 스펙을 따른 예시
description: "주간 업무 보고서 PPT 생성. '주간 보고', '업무 보고' 요청 시 사용."
WARNING

name 필드 규칙 (공식 스펙)

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

커스텀 스킬이란?#

flowchart LR A[사용자 요청] --> B{description과<br/>일치하는가?} B -->|일치| C[스킬 자동 활성화] C --> D[SKILL.md 로드] D --> E[지시사항에 따라 실행] E --> F[결과물 출력] B -->|불일치| G[일반 응답]

커스텀 스킬은 Claude에게 특정 작업의 수행 방법을 정의한 문서입니다.
사용자의 요청이 스킬의 description과 일치하면 Claude가 해당 스킬을 자동으로 로드해서 실행합니다.

예시로 이해하기#

주간 보고서를 만들 때마다 이렇게 요청했다고 가정합니다.

주간 업무 보고 PPT를 만들어줘.
슬라이드 구성:
1. 표지 (팀명, 날짜)
2. 이번 주 완료 업무
3. 진행 중인 업무 (진행률)
4. 다음 주 계획
5. 이슈 및 건의사항
디자인은 파란색 계열로 깔끔하게...

커스텀 스킬을 등록하면 이렇게 간단해집니다.

이번 주 보고서 만들어줘.
- 완료: 고객 미팅 3건
- 진행중: 프로젝트 기획 60%
- 이슈: 인력 부족

Claude가 “주간 보고서”라는 키워드를 인식하고 등록된 스킬을 자동으로 활성화합니다.


기본 스킬 vs 커스텀 스킬#

flowchart TB subgraph 커스텀["커스텀 스킬 (사용자 정의)"] B1[사내 보고서 양식] B2[특정 형식 회의록] B3[업무 자동화 스킬] end subgraph 기본["기본 스킬 (Anthropic 제공)"] A1[PPT] --- A2[엑셀] A2 --- A3[워드] A3 --- A4[PDF] end
구분기본 스킬 (Anthropic 제공)커스텀 스킬
예시PPT, 엑셀, 워드, PDF사내 보고서 양식, 특정 형식의 회의록
범용성일반적인 문서 생성 기능특정 요구사항에 최적화된 기능
설정사전 정의됨사용자가 직접 정의

핵심 특징#

특징설명
자동 활성화요청 내용과 스킬 설명이 일치하면 Claude가 자동으로 해당 스킬을 사용한다
컨텍스트 효율성필요한 시점에만 스킬 내용을 로드해서 token3 사용량을 절약한다
재사용성한 번 정의하면 이후 동일한 패턴의 요청에 반복 사용할 수 있다

스킬 등록 방법 3가지#

스킬 등록 화면

Claude에서 커스텀 스킬을 등록하는 방법은 3가지입니다.

방법 1: Claude와 함께 창작하기#

대화를 통해 스킬을 생성하는 방법입니다.
복잡한 스킬도 대화로 요구사항을 전달하면 Claude가 최적의 스킬을 생성해줍니다.

  1. claude.ai 접속
  2. 설정 → 기능 → 스킬
  3. ”+ 추가” 클릭
  4. “Claude와 함께 창작하기” 선택
  5. 원하는 스킬을 대화로 설명
커스텀 스킬을 만들고 싶어요.
회의 녹취록을 붙여넣으면 자동으로 회의록으로 정리해주는 스킬이에요.
결정사항, 액션아이템, 담당자를 자동으로 추출해야 해요.

방법 2: 스킬 지침 작성#

SKILL.md를 만들지 않고, 직접 입력하는 방법입니다.
간단한 스킬에 적합합니다.

  1. “스킬 지침 작성” 선택
  2. name은 스킬 이름, description은 설명, 섹션 헤더의 내용들은 지침에 넣습니다.
  3. 저장
WARNING

.md 파일을 업로드하는 것이 아닙니다. 텍스트 내용을 복사해서 입력창에 붙여넣으세요. description은 1024자 제한이 적용됩니다.

방법 3: ZIP 파일 업로드#

여러 파일로 구성된 복잡한 스킬을 업로드하는 방법입니다.

meeting-minutes/
├── SKILL.md
├── example-input.txt
└── template-guide.md
  1. 폴더를 .zip으로 압축
  2. “커스텀 스킬 추가” → “스킬 업로드” 선택
  3. .zip 파일 업로드
TIP

단순한 스킬은 “스킬 지침 작성”에서 텍스트를 복사 붙여넣기 하면 됩니다.
ZIP 업로드는 참조 파일이 여러 개 필요한 복잡한 스킬에만 사용하세요.


실전 팁 & 주의사항#

스킬 품질 높이기#

설명
예시 포함Examples 섹션에 입출력 예시를 넣으면 품질 향상
제약 조건 명시”5장 이내”, “이모지 미사용” 등 구체적 제한
500줄 이하 유지긴 내용은 별도 파일로 분리 (ZIP 업로드 시)

선택적 필드 (공식 스펙)#

namedescription 외에도 선택적 필드가 있습니다.

필드용도예시
license라이선스 명시license: MIT
compatibility환경 요구사항compatibility: Claude Code 전용
metadata추가 정보author: my-team
TIP

대부분의 스킬은 namedescription만 있으면 충분합니다. 선택적 필드는 팀 내 공유나 오픈소스 배포 시 유용합니다.

커스텀 스킬의 한계#

가능어려움
텍스트 기반 규칙외부 서비스 연동
파일 생성 (PPT, 엑셀 등)실시간 데이터 가져오기
형식 지정복잡한 프로그래밍 로직

자동 활성화가 안 될 때#

  1. description 점검: “무엇을 하는가”와 “언제 사용하는가”가 명확한가?
  2. 키워드가 요청 문장에서 자주 쓰이는 표현인가?
  3. 명시적 호출: “meeting-minutes 스킬 사용해줘”로 직접 호출

사용 가능한 플랜#

  • Pro, Max, Team, Enterprise: 커스텀 스킬 생성 및 사용 가능
  • claude.ai: 개별 사용자별로 관리됨 (팀원 각자 업로드 필요)
  • Claude API: 워크스페이스 전체에서 공유 가능
  • 무료 플랜: 커스텀 스킬 사용 불가 (코드 실행 환경 필요)

실전 예시: 회의록 자동 정리 스킬#

음성 녹취 텍스트를 구조화된 회의록으로 변환하는 스킬 예시입니다.

NOTE

아래 예시는 SKILL.md 파일 형식입니다. description은 모든 등록 방법에서 1024자 이내로 작성해야 합니다.

---
name: meeting-minutes
description: 회의 녹취록을 구조화된 회의록으로 변환. 결정사항과 액션아이템 추출. '회의록 정리', '미팅 노트', '회의 요약', '녹취록 정리', '미팅 내용 요약' 요청 시 사용.
---
# 회의록 자동 정리 스킬
## Overview
음성 녹취 텍스트(클로바노트, 다글로 등)를 **정제 → 추출 → 구조화** 단계로 회의록을 생성한다.
## Instructions
### 1. 정제 (출력하지 않음)
- 추임새, 반복 표현 제거
- 발화자별 분류, 불완전 문장 보완
### 2. 추출 (출력하지 않음)
- 안건, 결정사항, 액션아이템 식별
- 담당자 + 기한 매칭
### 3. 회의록 구조
[회의 개요] 회의명, 일시, 참석자
[논의 내용] 안건별 요약
[결정 사항] 확정 내용 (numbered)
[액션 아이템] 할 일 + 담당자 + 기한 (표)
[다음 회의] 일정, 예정 안건
## Examples
### Example 1: 짧은 점검회의 (실제 출력)
**Input:** 2분 녹취, 화자 3명, 안건 2개
**Output:**
**팀 점검회의 회의록**
**회의 개요**
- 일시: [확인 필요]
- 참석자: 화자1, 화자2, 화자3
- 소요 시간: 약 2분
**논의 내용**
1. 고객 피드백 현황: 배송 불만 40%, 물류센터 확인 필요
2. 행사 준비: 장소 계약 완료, 케이터링/음향 확정 필요
**결정 사항**
1. 물류센터 미팅 진행
2. 케이터링/음향 화요일까지 확정
**액션 아이템**
| 할 일 | 담당자 | 기한 |
|-------|--------|------|
| 물류센터 미팅 잡기 | 화자3 | 이번 주 |
| 케이터링/음향 확정 | 화자2 | 화요일 |
**다음 회의**
- 일시: [확인 필요]
### Example 2: 긴 회의 (핵심 요약)
**Input 핵심:** 14분 녹취, 화자 3명, 안건 6개
**Output 핵심:**
- 논의: 출시 22일 연기, 예산 400만원 승인, 배송불만 40%
- 결정: ①출시일정 확인 ②플랜B 수립 ③A사 계약 진행
- 액션: 9개 항목 (담당자, 기한 포함 표)
## Guidelines
| DO | DON'T |
| ------------------------ | --------------- |
| 개조식 문장 | 서술형 문장 |
| 담당자명 원본 유지 | 임의 변경 |
| 불명확시 [확인 필요] | 추측으로 채우기 |
| 액션아이템은 동사로 시작 | 명사형 나열 |
**필수:** 결정사항 번호, 액션아이템 표 형식
**금지:** 이모지, 추임새/군더더기
## Edge Cases
- 참석자 정보 누락 → 발화자 중심 정리 (화자1, 화자2...)
- 날짜/시간 불명확 → "[확인 필요]"로 표기
- 안건 구분 모호 → 시간 구간 기준으로 분할
- 담당자 미지정 → "[담당자 미정]"으로 표기
- 기한 언급 없음 → "[기한 미정]"으로 표기
## Output Format
Microsoft Word 문서 (.docx)

description에 “회의록 정리”, “미팅 노트” 등 키워드를 포함했기 때문에, “회의록 정리해줘”라는 요청만으로 Claude가 자동으로 이 스킬을 활성화합니다.

테스트#

새 대화를 열고 테스트합니다. 아래는 실제 AI 녹취 서비스 출력 형태의 예시입니다.

회의록 정리해줘.
[00:00] 화자1: 네 그러면 회으 시작할겡요 오늘 안건이 세 가지인데 먼저 신규 서비스 론칭 일정이랑 마케팅 예산 그리고 고객 피드백 대응 방안이에요
[00:15] 화자2: 네 알겠습니다
[00:18] 화자1: 먼저 신규 서비스 론칭 건부터 볼겡요 개발팀에서 진척 상황 어떠게 되고 있어요
[00:28] 화자3: 아 네 현재 개발 진행률이 한 팔십오 퍼센트 정도고요 테스트 서버에 배포까지는 완료된 상태에요 근데 큐에이 과정에서 버그가 몇 개 발견돼서 수정 중이에요
[00:45] 화자1: 버그가 얼마나 심각한 거에요 일정에 영향 있어요
[00:50] 화자3: 크리티컬한 건 두 건이고 나머지는 마이너해서 이번 주 내로 다 잡을 수 있을 것 같아요 그래서 원래 15일 론칭 예정이었는데 안전하겡 22일로 미루는 게 좋을 것 같아요
[01:08] 화자2: 22일이면 마게팅 일정도 조정해야 하는데 저희 인플루언써 컨택이 이미 다 된 상탱라서요
[01:18] 화자1: 음 그거 조정 가능해요
[01:22] 화자2: 네 일단 확인해 볼겡요 오늘 중으로 연락해서 가능 여부 파악하고 공유 드릴겡요
[01:32] 화자1: 좋아요 그럼 론칭일은 22일로 잠정 확정하고 마케팅 일정 조율되는 대로 최종 컨펌합시다
[01:42] 화자3: 네 알겠습니다
[01:45] 화자1: 두 번째 안건 마게팅 예산 건이에요 지난번에 오백 요청했었는데 결과가 어떠게 됐어요
[01:55] 화자2: 아 그게요 기획팀에서 사백까지만 승인해 줬어요 전체 예산 조정 때문에 잘렸다고 하더라고요
[02:05] 화자1: 에이 사백으로는 원래 계획대로 진행이 안 되는데
[02:10] 화자2: 네 그래서 플랜비가 필요할 것 같아요 인플루언서 마케팅 규모를 좀 줄이고 퍼포먼스 마게팅 비중을 늘리는 방향으로요
[02:22] 화자1: 그 방향으로 수정된 플랜 언제까지 받아볼 수 있어요
[02:28] 화자2: 수요일까지 정리해서 공유 드릴겡요
[02:32] 화자1: 네 좋아요 그리고 기획팀이랑 한 번 더 협의해 봐요 추가 예산 확보 가능한지
[02:40] 화자2: 넵 알겠습니다
[02:43] 화자1: 세 번째 안건 고객 피드벡 대응이에요 지난달 시에스팀에서 받은 피드백 분석 결과 공유해 주세요
[02:55] 화자3: 네 제가 정리한 거 말씀드릴겡요 크게 세 가지로 나뉘는데요 첫 번째가 배송 관련이에요 배송 지연이랑 포장 상태 불만이 전체 문의에 한 사십 퍼센트였어요
[03:12] 화자1: 사십 퍼센트면 꽤 높네요 원인이 뭐에요
[03:17] 화자3: 주로 지방 배송이 문제에요 울류센터가 수도권에만 있다 보니까 지방은 하루 이틀 더 걸리고 그 과정에서 포장 상태도 안 좋아지는 것 같아요
[03:32] 화자2: 물류센터 추가 설치는 비용 문제가 있을 텐데요
[03:38] 화자1: 일단 현황 파악부터 하죠 물류팀이랑 미팅 잡아서 개선 가능한 부분이 있는지 확인해 봐요
[03:48] 화자3: 네 제가 이번 주 내로 물류팀이랑 미팅 잡아볼겡요
[03:55] 화자1: 두 번째 불만은 뭐였어요
[03:58] 화자3: 앱 유아이 관련이에요 결제 프로세스가 복잡하다는 의견이 한 이십오 퍼센트 정도였어요 특히 결제 수단 선택하는 화면에서 이탈이 많대요
[04:15] 화자1: 그 부분은 저번에도 얘기 나왔었는데
[04:20] 화자2: 네 근데 개발팀 리소스가 없어서 못 하고 있었자나요 이번 론칭 끝나면 여유 생기니까 그때 유아이 개선 작업 들어가면 어떨까요
[04:35] 화자1: 좋아요 론칭 끝나는 대로 유아이 개선 프로젝트 시작합시다 개발팀한테 미리 일정 공유해 놔요
[04:45] 화자3: 네 제가 개선 요청 사항 정리해서 개발팀한테 전달해 놓을겡요
[04:52] 화자1: 세 번째는요
[04:55] 화자3: 고객 응대 시간이에요 평균 응대 시간이 지금 마흔여덟 시간인데 경쟁사는 이십사 시간 이내라서 불만이 있어요
[05:08] 화자1: 마흔여덟 시간은 좀 긴데 시에스팀 인원이 부족한 거야 아니면 프로세스 문제야
[05:18] 화자2: 둘 다인 것 같아요 인원도 부족하고 티케팅 시스템도 좀 개선이 필요하대요
[05:28] 화자1: 알겠어요 시에스팀장이랑 내가 직접 미팅 잡을겡 인원 충원 건은 인사팀이랑도 협의해야 하고
[05:40] 화자3: 그리고 자주 묻는 질문 정리해서 에프에이큐 업데이트하면 문의량 자체를 좀 줄일 수 있을 것 같아요
[05:52] 화자1: 좋은 생각이네 그것도 같이 진행해요
[05:58] 화자2: 제가 시에스팀이랑 협업해서 에프에이큐 컨텐츠 초안 만들어 볼겡요 다음 주까지요
[06:08] 화자1: 네 좋아요 그럼 오늘 회의 내용 정리하면 론칭일 22일로 잠정 확정 마케팅 플랜비 수요일까지 작성 배송 개선 위해 물류팀 미팅 유아이 개선은 론칭 후 진행 시에스 응대시간 개선 위해 팀장 미팅 이렇겡 다섯 가지네요
[06:35] 화자2: 네 맞아요
[06:38] 화자3: 다음 회의는 언제로 할까요
[06:42] 화자1: 금요일 오후 세 시에 다시 모여서 진행 상황 공유해요
[06:50] 화자2: 네 알겠습니다
[06:52] 화자3: 넵 수고하셨습니다

테스트 화면

TIP

자동 활성화가 안 되면?

  • “meeting-minutes 스킬 사용해줘”로 직접 호출
  • description 키워드가 요청과 일치하는지 확인
  • 새 대화에서 다시 시도

정리#

항목내용
커스텀 스킬Claude에게 특정 작업 방법을 정의한 문서
핵심 파일SKILL.md
필수 필드name (소문자, 숫자, 하이픈만, 64자), description (최대 1024자)
선택적 필드license, compatibility, metadata
description 공식기능 + 사용 시점
등록 방법Claude와 대화, 지침 복사붙여넣기, ZIP 업로드

핵심: description이 스킬 성공의 핵심입니다. 활성화 키워드와 사용 시점을 명확히 포함하세요.


다음 글 예고#

다음 글에서는 스킬을 만드는 사고 과정을 단계별로 안내합니다.

  • 스킬 제작 전 3가지 사전 질문
  • 각 필드를 채우는 구체적인 사고 과정
  • 실전 예시로 처음부터 끝까지 만들기

Footnotes#

  1. SKILL.md: 커스텀 스킬의 메타데이터와 동작 지침을 포함하는 마크다운 파일이다.

  2. description: 스킬의 용도와 활성화 조건을 설명하는 필드로, 자동 활성화 판단의 기준이 된다.

  3. token: AI 모델이 텍스트를 처리하는 기본 단위로, 대략 한글 1-2글자 또는 영문 4글자에 해당한다.

공유

이 글이 도움이 되었다면 다른 사람과 공유해주세요!

Claude Skills 완벽가이드 4편: 커스텀 스킬 개념과 구조
https://moodturnpost.net/posts/ai/claude-skills-custom-intro/
작성자
Moodturn
게시일
2026-01-09
Moodturn

목차