Claude한테 매번 똑같은 설명 반복하느라 지치셨죠? Anthropic이 33페이지짜리 공식 가이드를 공개했어요. 폴더 하나 만들어서 업로드하면, 매번 알아서 해요. 메시지 15번이 2번으로, 토큰은 절반으로.
이게 뭔데?
2026년 1월 29일, Anthropic이 "The Complete Guide to Building Skills for Claude"라는 33페이지짜리 PDF를 공개했어요. 2025년 10월에 출시된 Agent Skills 기능의 공식 실전 매뉴얼인데요 — 이게 프롬프트 엔지니어링의 다음 단계라고 보시면 돼요.
스킬이 뭐냐면요, 폴더 하나에 "이렇게 일해"라는 지침을 담아서 Claude에 업로드하는 것이에요. 매번 대화할 때마다 "나는 마케터고, 이런 톤으로 써줘, 이 형식으로 해줘"라고 반복하잖아요. 스킬은 그 반복을 없애줘요. 한번 가르치면, Claude가 관련 대화가 시작될 때 자동으로 그 지침을 불러와요.
Anthropic의 비유가 좋은데요 — "MCP가 주방(도구와 재료)이라면, Skills는 레시피(어떻게 쓰는지)"예요. MCP로 Figma, Slack, GitHub 같은 외부 도구를 연결해놓고도, 정작 "이걸 어떻게 활용해야 하는지" 모르면 빈 주방에서 헤매는 거잖아요. 스킬이 그 빈자리를 채워요.
가이드에 나온 벤치마크가 인상적이에요. 스킬 없이 복잡한 프로젝트를 처리하면 15번의 메시지 핑퐁, 3번의 API 호출 실패, 12,000 토큰 소모. 같은 작업을 스킬로 하면? 확인 질문 2번, API 실패 0건, 토큰 6,000. 반으로 줄어요.
특히 재밌는 건 3단계 프로그레시브 디스클로저라는 구조예요. Claude가 스킬을 한꺼번에 다 읽지 않아요. 처음엔 이름과 설명(50~100 토큰)만 읽고, 관련 대화가 시작되면 본문을 불러오고, 실행 중 필요하면 참조 파일까지 꺼내요. 스킬이 20~50개 설치돼 있어도 실제 토큰 부담은 미미한 거죠.
스킬의 3단계 로딩
Level 1: YAML 메타데이터 (항상 로드, ~100 토큰) — "이 스킬이 뭔지" Claude가 파악
Level 2: SKILL.md 본문 (관련 대화 시 로드) — 실제 지침과 워크플로우
Level 3: 참조 파일·스크립트 (실행 중 필요 시) — 템플릿, 코드, 문서
뭐가 달라지는 건데?
지금까지 Claude를 잘 쓰는 방법은 크게 세 가지였어요 — 프롬프트, 프로젝트, MCP. 근데 각각 한계가 있었거든요.
| 기존 방식 (프롬프트/프로젝트) | Claude Skills | |
|---|---|---|
| 지침 전달 | 매번 복붙 또는 시스템 프롬프트에 500줄+ | 폴더 한 번 업로드, 자동 적용 |
| 토큰 효율 | 매 대화마다 전부 로드 (항상 소모) | 필요할 때만 로드 (50~100토큰 시작) |
| 일관성 | 사람마다 프롬프트가 달라 결과 들쭉날쭉 | 동일 스킬 = 동일 품질 |
| 공유 | 노션이나 슬랙에 프롬프트 공유 (관리 혼란) | 폴더째 배포, 조직 전체 적용 가능 |
| 멀티 플랫폼 | Claude.ai용, Code용, API용 각각 설정 | 한 번 만들면 모든 Surface에서 동작 |
좀 더 정밀하게 보면, 프로젝트와 스킬의 차이가 중요해요. 인포그랩 블로그의 비유가 좋은데 — 프로젝트가 "알아야 할 내용"이라면, 스킬은 "이렇게 해야 한다"에요. 프로젝트에는 배경 지식(회사 정보, 브랜드 가이드)을 넣고, 스킬에는 절차적 노하우(보고서 작성법, 코드 리뷰 체크리스트)를 넣는 거예요.
인포그랩은 이걸 "디지털 인수인계서"라고 표현했어요. 시니어가 구축한 스킬을 주니어와 공유하면, 주니어도 시니어 수준의 품질로 업무를 수행할 수 있다는 거예요. 팀 전체의 AI 활용 수준을 평준화하는 데 핵심이 되는 거죠.
이미 Asana, Atlassian, Canva, Figma, Sentry, Zapier 같은 기업들이 파트너 스킬을 만들어 배포하고 있고, Anthropic은 Agent Skills를 오픈 스탠다드로 공개해서 다른 플랫폼에서도 쓸 수 있게 했어요.
주의할 점
Skills는 무료 플랜에서는 사용할 수 없어요. Pro, Max, Team, Enterprise 플랜이 필요합니다. 또한 스크립트를 포함한 실행형 스킬은 보안 검토가 필요해요.
핵심만 정리: 시작하는 법
가장 빠른 방법은 Claude에게 스킬을 만들어달라고 하는 거예요. 내장된 skill-creator 스킬을 쓰면 15~30분이면 첫 스킬이 완성돼요.
- skill-creator로 시작 (가장 쉬움)
Claude.ai에서 "Use the skill-creator skill to help me build a skill for [내 업무]"라고 입력하세요. Claude가 질문하고, 구조를 잡고, SKILL.md를 생성해줘요. - SKILL.md 구조 이해하기
핵심은 YAML 메타데이터(이름 + 설명)와 마크다운 본문(지침) 두 부분이에요. description 필드가 가장 중요 — Claude가 이걸 읽고 "이 스킬을 지금 쓸지 말지" 결정하거든요. "무엇을 하는지 + 언제 쓰는지"를 명확히 써야 해요. - 트리거 테스트
"이 스킬을 언제 사용하겠어?"라고 Claude에게 직접 물어보세요. Claude가 description을 인용하며 대답해요. 빈틈이 보이면 description을 다듬으면 돼요. 10~20개 테스트 쿼리로 90% 트리거율을 목표로. - 업로드
Claude.ai: Settings → Capabilities → Skills에서 zip 파일 업로드. Claude Code:.claude/skills/ 디렉토리에 폴더 배치. API: /v1/skills 엔드포인트로 업로드. - 팀에 공유
조직 관리자는 워크스페이스 전체에 스킬을 배포할 수 있어요 (2025년 12월 18일부터). GitHub에 올려서 커뮤니티 공유도 가능. Anthropic 공식 저장소: github.com/anthropics/skills
