스킬을 잘 만들고 싶다면 Anthropic이 공개한 공식 예시 스킬을 읽어 보는 것이 가장 빠른 길입니다. anthropics/skills 저장소에는 실제로 쓰이는 패턴들이 담겨 있습니다. 이 글은 개념 설명이 아니라, 예시 스킬에서 배우는 실전 패턴과 작성 원칙을 공식 자료 기준으로 정리합니다. (기준 시점: 2026년 6월)
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
공식 예시 스킬은 어떤 게 있나
공개 저장소의 예시 스킬(대부분 Apache 2.0 오픈소스)은 창작부터 기술·업무까지 폭넓습니다. 카테고리별로 대표적인 것들을 보면:
- 개발·기술:
webapp-testing(Playwright로 로컬 웹앱 UI 검증),mcp-builder(MCP 서버 생성),frontend-design - 문서 생성:
pdf·docx·xlsx·pptx— Claude의 문서 생성 기능을 실제로 떠받치는 스킬들로, 저장소의 document-skills/ 아래에 있습니다. - 창작·디자인:
canvas-design,algorithmic-art,theme-factory - 업무·협업:
doc-coauthoring,internal-comms,brand-guidelines, 그리고 메타 스킬skill-creator
처음 만들 때는 저장소의 template-skill을 시작점으로 삼으면 좋습니다.
패턴 1 — 핵심은 SKILL.md, 상세는 references/
잘 만든 예시 스킬의 공통점은 SKILL.md를 핵심 지침만으로 간결하게 유지한다는 것입니다. 상세 문서나 스키마는 references/ 디렉터리로 분리하고 링크로 연결합니다. 예를 들어 skill-creator는 evals·grading 같은 JSON 구조 설명을 references/schemas.md로 빼두었습니다. 이렇게 하면 점진적 공개(progressive disclosure)가 제대로 작동해, 평소엔 짧은 핵심만 로드하고 필요할 때만 상세가 들어옵니다. 실행 스크립트나 자료는 scripts/·assets/로 번들합니다(선택).
패턴 2 — 워크플로를 단계로 설계 (doc-coauthoring 예시)
좋은 스킬은 작업을 명확한 단계로 안내합니다. doc-coauthoring 스킬은 문서 공동 작성을 세 단계로 진행합니다: ① 맥락 수집(Claude가 질문하며 배경·범위·톤을 확보) → ② 정제·구조화(섹션별 brainstorm과 편집 반복) → ③ 리더 테스트(맥락이 없는 새 Claude 인스턴스로 문서를 검증해, 작성자에겐 당연하지만 남에겐 헷갈릴 사각지대를 찾기). 서브에이전트를 쓸 수 있으면 예상 질문 5~10개를 새 Claude에게 던져 자동으로 점검합니다. 이처럼 "단계 → 점검 → 반복" 구조를 스킬에 녹이면 결과 품질이 안정됩니다.
예시에서 배우는 작성 원칙
예시 스킬들을 관통하는 원칙을 정리하면 다음과 같습니다.
- description를 명확하고 약간 "강하게": skill-creator는 모호한 설명("내부 데이터를 보여주는 대시보드") 대신 언제 써야 하는지가 분명한, 다소 적극적인 설명을 권합니다. description은 사람용 문서가 아니라 Claude가 스킬을 고르는 핵심 신호이기 때문입니다.
- 핵심만 SKILL.md, 상세는 references/로 분리
- 트리거가 맞으면 자동 활성화되도록 설계(직접 호출도 가능)
- 산출 파일은 저장 위치를 알려주기: .docx·.xlsx처럼 사용자가 확인해야 하는 파일은 어디 저장됐는지 안내
참고: 예시 스킬의 구체적 구현은 데모·교육용이며, Claude가 실제로 보이는 동작은 저장소 구현과 다를 수 있다고 공식 안내합니다. 또 document-skills/의 문서 스킬은 source-available(오픈소스 아님)입니다.
함께 보면 좋은 글
스킬의 기본 개념과 SKILL.md 구조는 Claude Code 스킬 가이드, 직접 만드는 단계별 방법은 스킬 직접 만들기, 용도별 활용은 용도별 스킬 활용법에서 다룹니다.
고지: 본 글은 Anthropic 공개 저장소(anthropics/skills)와 공식 스킬 문서(2026년 6월 열람, 2026년 9월 재확인)를 바탕으로 작성되었습니다. 저장소의 스킬 목록·구성은 이후 변동될 수 있습니다. 본 사이트는 Anthropic 공식 사이트가 아닙니다.