Claude 스킬 예시로 배우기: anthropics/skills 패턴과 작성 원칙

스킬을 잘 만들고 싶다면 Anthropic이 공개한 공식 예시 스킬을 읽어 보는 것이 가장 빠른 길입니다. anthropics/skills 저장소에는 실제로 쓰이는 패턴들이 담겨 있습니다. 이 글은 개념 설명이 아니라, 예시 스킬에서 배우는 실전 패턴과 작성 원칙을 공식 자료 기준으로 정리합니다. (기준 시점: 2026년 6월)

공식 예시 스킬은 어떤 게 있나

공개 저장소의 예시 스킬(대부분 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처럼 사용자가 확인해야 하는 파일은 어디 저장됐는지 안내

함께 보면 좋은 글

스킬의 기본 개념과 SKILL.md 구조는 Claude Code 스킬 가이드, 직접 만드는 단계별 방법은 스킬 직접 만들기, 용도별 활용은 용도별 스킬 활용법에서 다룹니다.