Claude 스킬을 만들려면 파일 하나가 들어 있는 폴더 하나를 작성하면 됩니다. 폴더 안에는 이름과 설명으로 시작하고, 이어서 일반 언어로 작성한 지침이 포함된 SKILL.md 파일이 있어야 합니다. 폴더를 압축해 Claude에 업로드하거나(Claude Code에서는 ~/.claude/skills/에 넣으세요), Claude가 요청이 설명과 일치할 때마다 불러오도록 하세요. 코드도, SDK도, 빌드 단계도 필요하지 않습니다.
이 페이지
이것이 전체 작동 방식입니다. 요청할 때마다 실행되어 실제로 사용할 수 있는 결과물을 만드는 스킬과 전혀 실행되지 않는 스킬을 가르는 것은 대략 여섯 가지 결정이며, 이 가이드에서는 이를 순서대로 설명합니다. 마지막에는 복사해 사용할 수 있는 무료 템플릿과, 스킬을 실제로 사용하기 전에 테스트할 수 있는 체크리스트도 제공됩니다.
이 개념이 처음이라면 Claude Skills란 무엇인가요?부터 읽고 돌아오세요. 이 페이지는 스킬이 무엇인지 알고 있으며 직접 만들고 싶은 분을 대상으로 합니다.
시작하기 전에 필요한 것
- 코드 실행이 켜진 Claude 계정. 스킬은 Free, Pro, Max, Team, Enterprise 요금제에서 실행되지만 코드 실행 및 파일 생성 설정이 활성화되어 있어야 합니다. Team 및 Enterprise에서는 관리자가 먼저 조직의 스킬을 켜야 할 수도 있습니다.
- 텍스트 편집기. 일반 텍스트로 저장할 수 있는 도구면 됩니다. VS Code, 일반 텍스트 모드의 TextEdit, 메모장 등이 있습니다.
- 반복 가능한 작업 하나. "마케팅"처럼 포괄적인 작업이 아닙니다. "영업 통화 기록을 우리 형식의 CRM 메모로 변환하기" 또는 "계약서에서 표준 위험 신호 다섯 가지 검토하기"와 같은 작업입니다. 작업 범위가 좁을수록 스킬은 더 좋아집니다.
- 좋은 결과물의 실제 예시 두세 개. 기꺼이 보낼 수 있는 이전 보고서, 이메일, 브리프를 준비하세요. 이는 스킬을 만들기 위한 가장 좋은 원자료입니다.
1단계: 하나의 작업을 선택하고 "완료"를 정의하기
대부분의 실패한 스킬은 한 줄도 작성하기 전에 여기서 실패합니다. "마케팅 관리자가 하는 모든 일"을 다루려는 스킬은 설명이 모호해지고, 잘못된 순간에 실행되며, 실행되더라도 일반적인 답변을 내놓게 됩니다.
무엇보다 먼저 두 문장을 작성하세요:
- 트리거: "누군가 X를 요청하거나 Y를 전달할 때 사용합니다."
- 결과물: "출력물은 다음 섹션을 포함하는 Z이며, 이 분량과 이 어조로 작성됩니다."
예: "누군가 고객 통화 기록을 붙여넣고 메모를 요청할 때 사용합니다. 출력은 통화에 참여하지 않은 영업 관리자를 위해 작성한 200단어 이하의 CRM 메모이며, 요약, 문제점, 예산, 다음 단계, 위험 요소 섹션으로 구성됩니다." 이 두 문장을 작성할 수 없다면 작업을 두 개의 스킬로 나누세요.
2단계: 폴더와 SKILL.md 파일 만들기
스킬 이름과 일치하는 이름의 폴더가 스킬입니다. 폴더 안에서 유일하게 필요한 파일은 SKILL.md (파일 이름은 대소문자를 구분합니다). 선택 사항인 추가 파일은 그 옆에 둡니다:
| 경로 | 필수 여부 | 용도 |
|---|---|---|
call-notes/SKILL.md |
예 | 프런트매터와 Claude가 따르는 지시사항 |
call-notes/resources/example-output.md |
권장 | 제공물의 완성된 예시 |
call-notes/resources/style-guide.md |
선택 사항 | Claude가 필요할 때만 읽는 더 긴 참고 자료 |
call-notes/scripts/ |
선택 사항 | CSV 구문 분석처럼 정확해야 하는 단계에는 Python 또는 셸 스크립트를 사용하세요 |
폴더 이름은 call-notes처럼 소문자와 하이픈을 사용하세요. call-notes 또는 quarterly-report. 동일한 문자열이 이름 다음 단계의 필드.
3단계: 프런트매터 작성하기(스킬이 실행되는 시점을 결정하는 부분)
파일은 세 줄의 하이픈 두 개 사이에 있는 짧은 YAML 블록으로 시작합니다. 필수 필드는 두 개입니다:
-
name- 소문자, 숫자 및 하이픈으로 구성하며 최대 64자입니다. 식별자가 되며 Claude Code에서는 슬래시 명령어(/call-notes)가 됩니다. -
description- 최대 1,024자입니다. 설치된 모든 스킬에 대해 세션 시작 시 Claude가 읽는 유일한 부분입니다. 스킬이 로드될지 여부를 결정합니다.
요청이 자신의 담당인지 1초 안에 판단해야 하는 동료에게 설명하듯이 설명을 작성하세요. 먼저 스킬이 생성하는 결과물을 제시한 다음, 스킬을 활성화해야 하는 상황과 표현을 나열하세요. 비교:
- 약한 예: "영업 메모 작성을 돕습니다."
- 강력한 예: "영업 또는 디스커버리 콜 기록을 구조화된 CRM 메모(요약, 문제점, 예산, 다음 단계, 위험)로 변환하며 200단어 이내로 작성합니다. 사용자가 통화 기록, 회의 녹취 텍스트 또는 대략적인 통화 메모를 붙여 넣고 메모, 요약, CRM 항목 또는 후속 요약을 요청할 때 사용합니다."
강력한 버전은 입력, 출력 및 사람들이 실제로 입력하는 표현을 명시합니다. 이것이 안정적으로 작동하고 나머지 상황에서는 조용히 유지되도록 합니다.
4단계: 지시사항을 분위기가 아니라 방법으로 작성하기
프런트매터 아래의 모든 내용은 스킬이 로드된 후 Claude가 따르는 Markdown입니다. 흔히 저지르는 실수는 긴 페르소나("20년 경력의 세계적인 영업 전문가입니다...")만 작성하고 절차는 작성하지 않는 것입니다. Claude에게는 뒷이야기가 필요하지 않습니다. 단계, 규칙 및 목표 형식이 필요합니다. 대부분의 비즈니스 스킬에 적합한 구조는 다음과 같습니다:
- 입력 - 사용자가 제공할 내용과 누락된 경우 요청할 내용입니다(질문은 최대 두 개까지 한 후, 명시한 가정을 바탕으로 진행).
- 워크플로 - 신중한 전문가가 수행할 순서대로 번호를 매긴 단계입니다.
- 출력 형식 - 정확한 섹션, 제목, 분량 및 어조입니다.
- 규칙 - 항상 또는 절대 일어나서는 안 되는 일입니다("예산 수치를 지어내지 말고 '논의되지 않음'이라고 작성").
- 품질 점검 - Claude가 답변하기 전에 확인하는 짧은 목록입니다.
한두 화면에 들어갈 정도를 목표로 하세요. 파일이 대략 500줄을 넘기면 긴 스타일 가이드, 가격표, 정책 문서 같은 참고 자료를 resources/ 아래 파일로 옮기고, 작업에 필요할 때 SKILL.md에서 Claude에게 해당 파일을 열도록 안내하세요. Claude는 작업에 필요할 때만 이러한 추가 파일을 로드하므로 컨텍스트를 가볍게 유지할 수 있습니다. 파일 구조에 관한 자세한 내용은 SKILL.md 파일이란?을 참조하세요.
5단계: 완성된 출력 예시 하나 추가하기
어떤 설명보다도 예시가 형식을 더 빠르게 가르칩니다. 현실적이고 완성된 결과물 하나를 resources/example-output.md 워크플로에서 이를 참조합니다("resources/example-output.md의 구조와 길이를 맞추세요"). 대괄호로 가득 찬 자리 표시자가 아니라, 이름과 수치를 바꾼 실제 과거 작업물을 사용하세요. 자체 카탈로그도 같은 원칙을 따릅니다. 모든 Skill에는 예시 출력물이 포함되는데, 이는 누군가 실제로 해당 작업을 테스트했다는 가장 분명한 증거이기 때문입니다.
6단계: 패키징하고 설치하기
Claude(웹 및 데스크톱)에서: 폴더 자체가 zip 파일의 루트에 오도록 폴더를 압축합니다(call-notes.zip에 call-notes/SKILL.md가 포함되어야 함). 설정에서 Skills 섹션을 열고 zip 파일을 업로드한 다음 Skill을 켭니다. 새 채팅을 시작하고 설명과 일치하는 요청을 하세요.
Claude Code에서: zip 파일은 필요하지 않습니다. 모든 프로젝트에서 사용하려면 폴더를 ~/.claude/skills/에 넣고, 해당 저장소에서 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요. /call-notes를 입력하거나 작업을 설명하기만 하면 됩니다. Claude Code는 재시작 없이 폴더의 변경 사항을 반영합니다.
각 환경에 대한 전체 안내와 파일 위치, 업로드가 거부되었을 때의 대처 방법은 Claude Skill 설치 방법에 나와 있습니다. 주로 터미널에서 작업하는 개발자는 Claude Code Skills도 읽어야 합니다.
7단계: 제대로 테스트하기
한 번만 시도한 Skill은 테스트된 것이 아닙니다. 팀과 공유하기 전에 다음 검사를 실행하세요:
- 트리거 테스트(5개 프롬프트). 표현을 달리해 이 Skill이 실행되어야 하는 요청 5개를 작성합니다. 몇 개가 실행되는지 셉니다. 4개 미만이면 설명에 사용자의 실제 표현을 더 반영해야 합니다.
- 침묵 테스트(5개 프롬프트). 이 Skill이 실행되면 안 되는 서로 유사한 요청 5개를 작성합니다. 하나라도 실행되면 설명을 더 구체적으로 좁힙니다.
- 입력 누락 테스트. 입력의 절반만 제공합니다. 사실을 지어내지 말고 짧게 질문하거나 가정을 명시해야 합니다.
- 형식 테스트. 예시와 세 개의 출력을 나란히 비교하세요. 섹션, 길이 범위, 어조가 동일한가요?
- 엣지 케이스 테스트. 가지고 있는 가장 복잡한 실제 입력을 넣어 보세요. 장황한 대화 기록이나 내용이 일부 비어 있는 스프레드시트 등을 사용하세요.
트리거 문제는 설명을 수정하고, 출력 문제는 워크플로 또는 규칙을 수정하세요. 팀에서 어떤 버전을 사용 중인지 알 수 있도록 파일 하단에 짧은 변경 기록을 유지하세요.
무료 Claude Skill 템플릿(복사하여 수정)
대문자로 된 부분을 바꾸고, 필요하지 않은 내용은 삭제한 다음 저장하세요. SKILL.md 이름이 같은 폴더 안에 이름 필드.
---
name: your-skill-name
description: 특정 입력에서 특정 결과물(섹션, 길이)을 생성합니다. 사용자가 X를 요청하거나, Y를 붙여 넣거나, Z를 언급할 때 사용하세요. 다른 곳에 속하는 유사한 작업에는 사용하지 마세요.
---
# Skill 제목
## 목적
대상과 "완료"의 기준을 한두 문장으로 작성하세요.
## 입력
- 필수 사항: 사용자가 제공해야 하는 내용
- 선택 사항: 결과를 개선하는 요소
- 필수 입력이 누락된 경우 짧은 질문을 최대 두 개까지 하세요.
그런 다음 진행하고 출력 상단에 가정을 나열하세요.
## 워크플로
1. 입력 내용을 읽고 핵심 요소를 파악하세요.
2. 규칙 또는 기준에 따라 확인하세요.
3. 아래 형식으로 출력을 작성하세요.
4. 품질 검사를 실행하고, 실패한 항목을 수정한 다음 답변하세요.
## 출력 형식
- 섹션 1: 이름 - 들어갈 내용 (길이)
- 섹션 2: 이름 - 들어갈 내용 (길이)
- 섹션 3: 이름 - 들어갈 내용 (길이)
resources/example-output.md의 구조와 길이에 맞추세요.
## 규칙
- 수치, 이름 또는 날짜를 절대 지어내지 마세요. 대신 "제공되지 않음"이라고 쓰세요.
- 쉬운 영어를 사용하세요. 불필요한 도입부는 쓰지 마세요.
- 팀 또는 업계에만 해당하는 규칙.
## 품질 검사
- 모든 섹션이 빠짐없이 순서대로 있나요?
- 모든 주장을 입력 내용으로 추적할 수 있나요?
- 길이 제한을 지켰나요?
## 변경 기록
- v1.0 최초 버전, 날짜
완성된 Skill이 어떤 모습인지 보고 싶으신가요? Claude Skill 예시에서는 실제 SKILL.md 파일 12개를 줄마다 살펴보며, 어느 정도의 세부 정보가 충분한지 가장 빠르게 익힐 수 있습니다.
Skill을 쓸모없게 만드는 다섯 가지 실수
- 언제 사용할지가 아니라 Skill이 무엇인지 설명하는 설명입니다. "전문 카피라이터"는 절대 실행되지 않습니다. "사용자가 제품 설명, PDP 카피 또는 상품 등록 텍스트를 요청할 때 기능 목록을 바탕으로 제품 페이지 카피를 작성합니다"는 실행됩니다.
- 부서 전체에 Skill 하나만 사용합니다. 예산 편성, 급여, 감사를 한 파일에 넣으면 불완전한 답변 세 개가 나옵니다. Skill을 세 개 만드세요.
- 출력 형식이 없습니다. 형식이 없으면 실행할 때마다 결과가 달라져 아무도 신뢰하지 않습니다.
- 파일에 비밀 정보를 넣기. API 키, 비밀번호 또는 고객 데이터를 스킬에 절대 붙여 넣지 마세요. 스킬을 공유하는 누구나 그 내용을 읽을 수 있습니다.
- 다른 사람이 만든 스킬을 읽지 않고 설치하기. 스킬은 Claude가 따를 지침이며, 때로는 스크립트도 포함합니다. 실행하기 전에 스크립트를 읽는 것처럼 스킬도 읽어 보세요.
Claude가 첫 초안을 작성하게 하세요
빈 파일에서 시작할 필요는 없습니다. Claude가 작업에 대해 인터뷰하고, frontmatter와 워크플로 초안을 작성하고, 예시 출력을 생성하고, 위의 테스트 prompts를 제안할 수 있습니다. Anthropic은 바로 이런 용도를 위해 내장 skill-creator skill을 제공하며, 다음과 같이 평범한 말로 요청할 수도 있습니다. "매주 작성하는 고객 보고서를 어떻게 작성하는지 인터뷰한 다음, 이를 위한 SKILL.md를 작성해 줘." 초안은 특히 설명과 규칙을 직접 수정해야 하지만, 입력해야 할 내용 대부분을 줄여 줍니다.
채팅보다 양식을 선호하시나요? 무료 Claude Skill Builder는 작업에 대한 짧은 설명을 frontmatter와 워크플로가 포함된 바로 사용할 수 있는 SKILL.md로 변환해 줍니다. Claude.ai와 Claude Code에서 사용할 수 있도록 복사하거나 .zip으로 다운로드할 수 있습니다. 가입이 필요하지 않습니다.
인터뷰, 자체 테스트, 패키징까지 맡기고 싶으신가요? Claude Skill Creator($19)는 스킬을 만드는 스킬입니다. 작업 내용, 사람들이 실제로 입력하는 요청, 절대 일어나서는 안 되는 일을 질문하고, SKILL.md와 예시 출력이 포함된 완전한 스킬 폴더를 작성하며, 이 스킬이 실행되어야 하는 요청과 실행되면 안 되는 요청을 대상으로 설명을 테스트하고, Claude, Claude Code 및 API용 폴더를 패키징합니다. 직접 작성했거나 다운로드한 스킬을 점검하려면 Claude Skill Reviewer & Security Linter를 사용하거나, prompt, MCP 및 코드 검토 스킬까지 포함된 Build Your Own Claude Skills Kit($49)를 이용하세요.
직접 만들까요, 아니면 미리 만들어진 스킬로 시작할까요?
워크플로가 팀 고유의 것이거나, 외부인은 누구도 알 수 없는 내부 지식을 담고 있거나, 직접 반복해서 개선하는 과정을 즐긴다면 직접 만들어 보세요. 회계 처리, SEO 브리핑, 계약 검토, 지원 답변처럼 표준적인 역할의 작업이고 지침을 작성하기보다 오후 시간을 실제 업무에 쓰고 싶다면 미리 만들어진 스킬로 시작하세요. 저희 Claude 스킬 라이브러리의 미리 만들어진 스킬은 $19이며, 예시 출력이 포함되어 있고, 열어 편집할 수 있는 일반 Markdown 파일이므로 자신만의 버전을 만드는 출발점으로도 사용할 수 있습니다.
어느 쪽이든 다음 단계는 같습니다. 매주 반복하는 작업 하나를 고르고, 1단계에서 작성한 두 문장을 적은 다음, 오늘이 끝나기 전에 작동하는 스킬을 만들어 보세요.