이 글은 Anthropic의 The Complete Guide to Building Skills for Claude PDF 가이드 중 1부를 번역한 글입니다.
목차
목차 보기
핵심 요약
📌 TL;DR (클릭하여 펼치기)
주요 내용
- 스킬이란? 폴더로 구성된 지시사항 모음으로, Claude에게 특정 작업을 처리하는 방법을 가르칩니다
- 점진적 공개 시스템: YAML frontmatter(항상 로드) → SKILL.md 본문(필요시 로드) → 링크된 파일(선택적 탐색)로 토큰 사용량을 최소화합니다
- MCP와의 시너지: MCP는 도구(what), 스킬은 워크플로우(how)를 담당합니다
- 핵심 설계 원칙: 점진적 공개, 조합성(여러 스킬 동시 사용), 이식성(모든 Claude 플랫폼에서 동일하게 작동)
실용 가이드
- 스킬 생성 시간: 첫 번째 스킬 구축 및 테스트에 약 15-30분 소요
- 두 가지 경로: 독립형 스킬(1-2장 집중) vs MCP 통합(3장 집중)
- 구성 요소: SKILL.md(필수), scripts/(선택), references/(선택), assets/(선택)
원문 작성일: 2025년 1월 29일
작성자: Anthropic Engineering Team
소개
스킬은 Claude에게 특정 작업이나 워크플로우를 처리하는 방법을 가르치는 지시사항 모음입니다. 간단한 폴더 형태로 구성되며 Claude를 특정 요구사항에 맞춰 커스터마이징하는 가장 강력한 방법 중 하나입니다. 매번 대화마다 선호사항, 프로세스, 도메인 전문지식을 다시 설명하는 대신, 스킬을 사용하여 Claude에게 한 번만 가르치면 이후 계속 활용할 수 있습니다.
스킬은 반복 가능한 워크플로우가 있을 때 강력합니다. 예를 들어 명세서에서 프론트엔드 디자인 생성하기, 일관된 방법론으로 리서치 수행하기, 팀의 스타일 가이드를 따르는 문서 작성하기, 다단계 프로세스 오케스트레이션하기 등이 있습니다. 스킬은 코드 실행이나 문서 생성 같은 Claude의 내장 기능과 잘 작동합니다. MCP 통합을 구축하는 분들에게는 스킬이 도구 접근을 신뢰할 수 있고 최적화된 워크플로우로 전환하는 강력한 레이어를 추가합니다.
이 가이드는 효과적인 스킬을 구축하는 데 필요한 모든 것을 다룹니다. 계획과 구조부터 테스트와 배포까지 포함됩니다. 본인을 위해, 팀을 위해, 또는 커뮤니티를 위해 스킬을 구축하든, 가이드 전반에 걸쳐 실용적인 패턴과 실제 사례를 찾을 수 있습니다.
배울 내용:
- 스킬 구조를 위한 기술 요구사항과 모범 사례
- 독립형 스킬과 MCP 강화 워크플로우를 위한 패턴
- 다양한 사용 사례에서 잘 작동하는 패턴
- 스킬을 테스트하고, 반복하고, 배포하는 방법
대상 독자:
- Claude가 특정 워크플로우를 일관되게 따르길 원하는 개발자
- Claude가 특정 워크플로우를 따르길 원하는 파워 유저
- 조직 전체에서 Claude가 작동하는 방식을 표준화하려는 팀
가이드 활용 경로
독립형 스킬을 구축하시나요? 기본 개념, 계획과 설계, 1-2장에 집중하세요. MCP 통합을 강화하시나요? “스킬 + MCP” 섹션과 3장이 적합합니다. 두 경로 모두 동일한 기술 요구사항을 공유하지만, 사용 사례에 맞는 부분을 선택하면 됩니다.
가이드를 통해 얻을 수 있는 것: 가이드를 마치면 한 번에 기능하는 스킬을 구축할 수 있습니다. skill-creator를 사용하면 첫 번째 작동하는 스킬을 구축하고 테스트하는 데 약 15-30분 정도 소요됩니다.
시작해봅시다.
1장: 기본 개념
스킬이란?
스킬은 다음을 포함하는 폴더입니다:
- SKILL.md (필수): YAML frontmatter가 포함된 Markdown 지시사항
- scripts/ (선택): 실행 가능한 코드(Python, Bash 등)
- references/ (선택): 필요에 따라 로드되는 문서
- assets/ (선택): 출력에 사용되는 템플릿, 폰트, 아이콘
핵심 설계 원칙
점진적 공개
스킬은 3단계 시스템을 사용합니다:
- 1단계 (YAML frontmatter): 항상 Claude의 시스템 프롬프트에 로드됩니다. Claude가 각 스킬을 언제 사용해야 하는지 알 수 있도록 충분한 정보만 제공하며, 모든 내용을 컨텍스트에 로드하지는 않습니다.
- 2단계 (SKILL.md 본문): Claude가 스킬이 현재 작업과 관련 있다고 판단할 때 로드됩니다. 전체 지시사항과 가이드를 포함합니다.
- 3단계 (링크된 파일): 스킬 디렉토리 내에 번들로 포함된 추가 파일로, Claude가 필요에 따라 탐색하고 발견할 수 있습니다.
이 점진적 공개 방식은 전문화된 지식을 유지하면서 토큰 사용량을 최소화합니다.
조합성
Claude는 여러 스킬을 동시에 로드할 수 있습니다. 스킬은 다른 스킬과도 잘 조합되어야 하며 스킬 하나만 사용할 수 있다고 가정해서는 안 됩니다.
이식성
스킬은 Claude.ai, Claude Code, API 전반에서 동일하게 작동합니다. 스킬을 한 번 만들고 나면 따로 수정 같은 거 없이도 모든 환경에서 작동합니다. 단, 사용 환경이 스킬 사용에 필요한 의존성을 지원해야 합니다.
MCP 개발자를 위한 가이드: 스킬 + 커넥터
MCP 없이 독립형 스킬을 구축하시나요? 계획과 설계로 건너뛰세요. 나중에 언제든 여기로 돌아올 수 있습니다.
작동하는 MCP 서버가 이미 있다면, 어려운 부분은 끝났습니다. 스킬은 그 위에 올라가는 지식 레이어입니다. 이미 알고 있는 워크플로우와 모범 사례를 담아서 Claude가 일관되게 적용할 수 있도록 합니다.
주방 비유
MCP는 전문 주방을 제공합니다: 도구, 재료, 장비에 대한 접근을 제공합니다.
스킬은 레시피를 제공합니다: 가치 있는 것을 만드는 방법에 대한 단계별 지시사항입니다.
둘을 함께 사용하면 사용자가 모든 단계를 직접 알아낼 필요 없이 복잡한 작업을 수행할 수 있습니다.
함께 작동하는 방식:
| MCP (연결성) | 스킬 (지식) |
|---|---|
| Claude를 서비스(Notion, Asana, Linear 등)에 연결 | Claude에게 서비스를 효과적으로 사용하는 방법을 가르침 |
| 실시간 데이터 접근과 도구 호출 | 워크플로우와 모범 사례를 담음 |
| Claude가 할 수 있는 것 | Claude가 어떻게 해야 하는지 |
MCP 사용자에게 중요한 이유
스킬 없이:
- 사용자가 MCP를 연결했지만 다음에 무엇을 해야 할지 모릅니다
- “이 통합된 환경에서 뭐를 어떻게 하나요?”라는 질문이 발생합니다
- 매 대화가 처음부터 시작됩니다
- 사용자가 매번 다르게 프롬프트하기 때문에 일관되지 않은 결과가 나옵니다
- 실제 문제는 워크플로우 가이드인데 사용자가 커넥터를 비난합니다
스킬 사용 시:
- 미리 구축된 워크플로우가 필요할 때 자동으로 활성화됩니다
- 일관되고 신뢰할 수 있는 도구 사용
- 모든 상호작용에 모범 사례가 내장됩니다
- 통합에 대한 학습 곡선이 낮아집니다