Claude에 나만의 전문 능력을 추가하는 방법 — SKILL.md 작성부터 패키징, 배포까지 단계별로 알아봅니다.
01 클로드 스킬이란?
클로드(Claude)는 기본적으로 매우 다양한 작업을 수행할 수 있지만, 특정 도메인에서 반복적으로 고품질 결과를 내려면 스킬(Skill)이라는 시스템을 활용할 수 있습니다.
스킬은 Claude가 특정 유형의 요청을 받았을 때 자동으로 참조하는 지침 문서입니다. 마치 숙련된 전문가에게 업무 매뉴얼을 쥐어 주는 것처럼, 스킬은 Claude에게 "이런 상황에서는 이렇게 해"라고 알려주는 역할을 합니다.
현재 Claude.ai에 기본 내장된 스킬로는 docx (Word 문서), pdf (PDF 처리), pptx (프레젠테이션), xlsx (스프레드시트) 등이 있으며, 개인이 직접 만든 스킬을 추가로 설치해서 사용하는 것도 가능합니다.
02 스킬의 구조와 파일 구성
스킬은 하나의 폴더로 구성됩니다. 최소한 SKILL.md 파일 하나만 있으면 되고, 필요에 따라 스크립트나 참고 문서를 추가할 수 있습니다.
├── SKILL.md ← 필수: 핵심 지침 파일
├── scripts/ ← 선택: 실행 가능한 코드
│ └── process.py
├── references/ ← 선택: 참고 문서
│ └── guide.md
└── assets/ ← 선택: 템플릿, 폰트, 이미지
└── template.docx
3단계 로딩 시스템
Claude는 스킬을 다음과 같이 단계적으로 불러옵니다:
메타데이터 (항상 로드)
이름과 설명(description)만 항상 Claude의 컨텍스트에 존재합니다. 스킬을 언제 쓸지 결정하는 핵심 트리거입니다. 약 100단어 이내로 작성하세요.
SKILL.md 본문 (스킬 실행 시 로드)
스킬이 트리거될 때 본문 전체를 읽습니다. 500줄 이내가 이상적입니다.
번들 리소스 (필요 시 로드)
scripts/, references/, assets/ 등은 필요할 때만 불러옵니다. 용량 제한 없이 추가할 수 있습니다.
03 SKILL.md 작성법
SKILL.md는 YAML 프론트매터(frontmatter)와 마크다운 본문으로 이루어집니다. 아래는 기본 구조입니다.
--- name: my-report-writer description: 월간 보고서를 자동으로 작성하는 스킬. 사용자가 "보고서", "월간 리포트", "실적 정리"를 언급할 때 반드시 이 스킬을 사용하세요. --- # 월간 보고서 작성 스킬 ## 개요 이 스킬은 사용자가 제공한 데이터를 기반으로 일관된 형식의 월간 보고서를 Word 문서로 생성합니다. ## 보고서 구조 1. 표지 (제목, 날짜, 담당자) 2. 요약 (핵심 지표 3가지) 3. 상세 분석 4. 다음 달 계획 ## 작성 규칙 - 어조: 공식적이고 간결하게 - 숫자는 반드시 단위와 함께 표기 - 그래프 대신 표를 우선 사용
description 잘 쓰는 법
description은 스킬의 트리거입니다. Claude는 이 설명을 읽고 스킬을 사용할지 결정합니다. 너무 짧으면 트리거가 잘 안 됩니다.
04 단계별 스킬 제작 과정
Step 1 — 목적 정의하기
스킬을 만들기 전에 아래 세 가지를 먼저 명확히 하세요.
- 이 스킬이 Claude에게 무엇을 시킬 것인가?
- 어떤 상황(키워드/문맥)에서 자동으로 실행되어야 하는가?
- 최종 결과물의 형식은 무엇인가? (Word, PDF, 코드, 텍스트 등)
Step 2 — SKILL.md 초안 작성
폴더를 만들고 SKILL.md를 작성합니다. 처음부터 완벽하지 않아도 됩니다. 일단 동작하는 초안을 만드는 것이 목표입니다.
mkdir my-skill cd my-skill touch SKILL.md
Step 3 — 테스트 프롬프트 실행
작성한 스킬을 실제로 사용해 보세요. 스킬이 제대로 트리거되는지, 결과물이 의도한 대로 나오는지 확인합니다. 최소 3~5개의 다양한 테스트 케이스를 준비하세요.
Step 4 — 결과 검토 & 개선
테스트 결과를 보면서 부족한 부분을 찾아 SKILL.md를 수정합니다. 이 과정을 만족할 때까지 반복하세요. 실제로 좋은 스킬은 보통 3~5번의 반복 개선 과정을 거칩니다.
개선 루프
초안 작성 → 테스트 → 결과 검토 → SKILL.md 수정 → 재테스트. 이 사이클을 반복하다 보면 완성도가 높아집니다.
05 잘 만드는 핵심 팁
📌 500줄 법칙
SKILL.md 본문은 500줄 이하로 유지하세요. 내용이 많아지면 references/ 폴더에 별도 파일로 분리하고, SKILL.md에서는 "자세한 내용은 references/guide.md를 참고하라"고 안내하면 됩니다.
📌 도메인별 파일 분리
하나의 스킬이 여러 상황을 지원해야 한다면 파일을 분리하세요. 예를 들어 클라우드 배포 스킬이라면:
├── SKILL.md ← 공통 워크플로우
└── references/
├── aws.md ← AWS 전용 지침
├── gcp.md ← GCP 전용 지침
└── azure.md ← Azure 전용 지침
📌 description을 "적극적으로" 쓰기
Claude는 스킬을 쓰지 않으려는 경향이 있습니다. 이를 막으려면 description에서 트리거 조건을 명시적으로 강조하세요.
description: 보고서를 작성합니다.
description: 보고서, 실적 정리, 월간 리포트를 작성하는 스킬. 사용자가 "보고서", "정리", "리포트", "실적"을 언급하거나 데이터를 문서화하고 싶어할 때 반드시 이 스킬을 사용하세요.
📌 예상치 못한 입력 처리
스킬을 만들 때 엣지 케이스(예외 상황)도 미리 생각하세요. "데이터가 없을 경우엔 어떻게 할 것인가?", "파일 형식이 다를 경우는?" 등을 SKILL.md에 명시해 두면 훨씬 안정적으로 동작합니다.
06 패키징 & 배포
스킬 제작이 완료되면 .skill 파일로 패키징할 수 있습니다. 이 파일을 공유하면 다른 사람도 동일한 스킬을 설치해서 사용할 수 있습니다.
# Claude Code 환경에서 실행 python -m scripts.package_skill ./my-skill/ # 결과: my-skill.skill 파일 생성
/tmp/ 같은 임시 폴더에 복사한 뒤 수정하고, 같은 이름으로 패키징하세요. 버전 이름(v2, v3)을 붙이면 기존 스킬과 충돌할 수 있습니다.
마치며
클로드 스킬은 반복적인 전문 작업을 자동화하고 싶은 누구에게나 강력한 도구입니다. 처음에는 간단한 스킬부터 시작해서 점점 정교하게 만들어 나가는 것이 좋습니다.
핵심을 정리하면: 명확한 목적 → SKILL.md 초안 → 반복 테스트 → 패키징. 이 네 단계만 기억하면 어떤 스킬이든 만들 수 있습니다.
나만의 스킬을 만들어 Claude를 진정한 개인 전문 비서로 활용해 보세요.
