anthropics/skills — Claude를 도메인 전문가로 만드는
Agent Skills 공식 레퍼런스

Anthropic이 직접 운영하는 166k 스타·19.8k 포크의 공식 스킬 레포. SKILL.md 한 장으로 Claude에게 "PDF 다루기·Word 만들기·MCP 서버 짓기" 같은 작업을 가르치는 Progressive Disclosure 시스템의 표준 구현체. Claude.ai의 문서 생성 기능을 실제로 돌리는 docx/pdf/pptx/xlsx 스킬을 source-available로 공개.

1한 줄 요약

이 레포가 정확히 무엇을 하는가

이 레포 anthropics/skills는 Anthropic이 직접 만든 19개의 예제 스킬과 스킬을 만드는 표준 양식(spec)을 담은 공식 저장소다. algorithmic-art·brand-guidelines·canvas-design·claude-api·doc-coauthoring·docx·frontend-design·internal-comms·mcp-builder·pdf·pptx·skill-creator·slack-gif-creator·theme-factory·web-artifacts-builder·webapp-testing·xlsx 등.

이 중 docx/pdf/pptx/xlsx 네 개는 Claude.ai의 실제 문서 생성 기능을 돌리는 운영 스킬이고(source-available), 그 밖의 스킬은 개별 LICENSE.txt를 확인해야 한다. README는 문서 생성 기능에 사용되는 스킬을 참고 구현으로 제공한다고 설명한다. 실제 제품 동작은 공개 구현과 다를 수 있다는 주의도 함께 둔다.

2왜 지금 주목받는가

TrendShift 4위 진입 + 166k 스타의 의미

2-1. "Skills"가 LLM 업계의 새 인프라 레이어로 굳어지는 중

2026년 들어 LLM에게 "지속 가능한 도메인 지식"을 주는 표준으로 Agent Skill이 사실상의 표준이 됐다. MCP가 "도구를 어떻게 호출할지"의 표준이라면, Skill은 "언제 그 도구를 써야 하고, 어떤 순서로, 어떤 함정을 피해야 하는지" — 다시 말해 업무 지식과 휴리스틱을 모델에게 주입하는 표준이다.

2-2. agentskills.io 표준화 + 멀티 클라이언트 호환

이 레포는 이제 단순한 Anthropic 전용이 아니다. README 첫 줄에 "Agent Skills 표준은 agentskills.io를 보라"고 못 박았다. 즉 Cursor·Cline·Codex·Kiro·OpenCode 등 다른 코딩 에이전트도 이 양식을 따라 스킬을 인식한다. 이 레포는 표준의 레퍼런스 구현체 역할이다.

2-3. Claude Code Plugin Marketplace 1급 시민

레포를 /plugin marketplace add anthropics/skills 한 줄로 Claude Code에 등록할 수 있고, document-skills·example-skills·claude-api 세 개의 플러그인 번들로 묶여서 배포된다. "오픈소스 스킬을 npm처럼 설치"하는 시대의 본보기.

2-4. docx/pdf/pptx/xlsx 운영 코드의 공개

경쟁 제품(ChatGPT, Gemini)이 문서 생성 기능을 "블랙박스 API"로 감추는 동안, Anthropic은 자기네가 실제로 돌리는 스킬을 그대로 읽을 수 있게 공개했다. 라이선스만 source-available로 잠가두고 코드는 100% 공개. 개발자가 똑같이 따라 하면 동등한 수준의 문서 생성 파이프라인을 만들 수 있다. 이 결정 자체가 큰 신호다.

2-5. 경쟁 제품 대비 차이점

3기술 스택 전체 지도

언어 분포(파이썬 84%·HTML 12%·Shell 2%·JS 1%) — 왜 이런 비율인지

3-1. 핵심 형식: Markdown + YAML frontmatter

스킬 자체의 "선언 부분"은 코드가 아니라 마크다운 문서다.

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

요구 필드는 두 개뿐이다.

• name — 스킬 식별자 (소문자, 공백 대신 하이픈)
• description — 무엇을 하는지 + 언제 써야 하는지

3-2. Python (84.4%) — 부속 스크립트

스킬의 본체는 Markdown이지만, "반복적이고 결정론적인 작업"은 Python 스크립트로 번들한다. 예시:

• docx 스킬: npm docx 패키지(JS) · pandoc · XML 직접 편집
• pdf 스킬: pypdf·pdfplumber·reportlab·pytesseract 조합
• pptx 스킬: PptxGenJS(JS npm) · markitdown · XML 직접 편집
• xlsx 스킬: openpyxl + 수식·차트 자동화
• skill-creator: aggregate_benchmark.py·run_loop.py·generate_review.py 등 평가 자동화 스크립트

3-3. HTML (12.4%) — 평가 뷰어 & 산출물

두 곳에서 등장한다.

1. 평가 뷰어(eval-viewer/generate_review.py) — 스킬 결과를 사람이 검토할 수 있게 HTML로 뽑아준다. 두 탭(Outputs / Benchmark) + 자동 저장 피드백 + 직전 iteration과 diff 비교.
2. canvas-design / web-artifacts-builder / theme-factory — 스킬의 산출물이 HTML이라서.

3-4. Shell + JavaScript (3.2%) — 글루 코드

패키징 스크립트(package_skill.py가 내부에서 zip 호출), 일부 웹 아티팩트의 인라인 JS.

3-5. 메타: .claude-plugin/marketplace.json

이 레포는 동시에 Claude Code 플러그인 마켓플레이스이기도 하다. 루트의 manifest는 다음 기존 3개 묶음에 academy-guide·discernment-nudge를 더한 5개 플러그인을 노출한다.

{
  "name": "anthropic-agent-skills",
  "plugins": [
    { "name": "document-skills",
      "skills": ["./skills/xlsx","./skills/docx","./skills/pptx","./skills/pdf"] },
    { "name": "example-skills",
      "skills": ["./skills/algorithmic-art","./skills/brand-guidelines","./skills/canvas-design",
                  "./skills/doc-coauthoring","./skills/frontend-design","./skills/internal-comms",
                  "./skills/mcp-builder","./skills/skill-creator","./skills/slack-gif-creator",
                  "./skills/theme-factory","./skills/web-artifacts-builder","./skills/webapp-testing"] },
    { "name": "claude-api",
      "skills": ["./skills/claude-api"] }
  ]
}

즉 사용자는 /plugin install document-skills@anthropic-agent-skills 한 줄로 4개 스킬을 한꺼번에 받는다.

4아키텍처 심화 분석 — Progressive Disclosure

스킬이 토큰을 어떻게 절약하는가

4-1. 3단계 로딩 시스템

4-2. Domain Organization 패턴

스킬이 여러 변형(클라우드 프로바이더, 언어, OS 등)을 지원할 때는 본 SKILL.md는 분기 로직만 두고, 변형별 디테일은 references/ 아래로 분리한다.

cloud-deploy/
├── SKILL.md          (워크플로 + 어느 references/ 파일을 읽을지)
└── references/
    ├── aws.md
    ├── gcp.md
    └── azure.md

이러면 사용자가 GCP 작업을 요청해도 aws.md나 azure.md는 컨텍스트에 안 들어온다. mcp-builder가 정확히 이 패턴이다 — reference/node_mcp_server.md vs reference/python_mcp_server.md 분기.

4-3. SKILL.md 작성의 4가지 원칙 (skill-creator가 가르치는 것)

4-4. 검증 루프 — 스킬을 "측정"하는 방법

이 레포가 다른 스킬 모음과 결정적으로 다른 부분이다. skill-creator는 스킬을 코드처럼 평가하는 표준 워크플로를 강제한다.

핵심 통찰: "with-skill"과 "baseline"을 동시에 돌리는 비교 실험 구조. 스킬이 정말 도움이 되는지를 정량적으로 본다. 또한 "with-skill보다 baseline이 더 잘 푸는 assertion"이 있다면 그건 스킬이 모델을 오히려 방해하고 있다는 신호 — 그 문장을 제거할 단서가 된다.

4-5. 트리거 description 자동 최적화

스킬은 description이 좋아야 발화한다. skill-creator는 run_loop.py로 description을 자동 튜닝하는 루프까지 제공한다.

1. 사용자가 "should-trigger / should-not-trigger" 쿼리 20개를 검토 (HTML로 보여줌)
2. 현재 description을 각 쿼리에 대해 3회씩 돌려 트리거율 측정
3. 실패 패턴을 Claude에게 보여주고 description 개선안 제안
4. train/test 60:40 분할 — test 점수 기준으로 best를 선정(과적합 방지)
5. 최대 5 iteration 반복 후 best_description으로 SKILL.md 업데이트

5디렉토리 구조 해부

루트와 19개 스킬 폴더의 역할

5-1. 레포 루트

2026-10-31: 지식 추천과 답변 검토 조건을 독립 플러그인으로

academy-guide는 사용자가 기능을 배우려는 의도가 분명할 때 학습 카탈로그에서 관련 자료를 찾도록 구성한다. 이미 진행 중인 작업에 무관한 강좌를 붙이지 않고, 확인하지 않은 제목·URL을 만들지 않는 조건이 본문에 있다. discernment-nudge는 행동으로 이어질 답변 뒤에 확인 질문 2~3개를 붙이는 예제이며, 대화당 한 번·단순 조회·코드 작성·이미 검토를 요청한 경우의 제외 조건을 별도로 둔다.

둘 다 모델이나 실행 서버를 추가하는 코드가 아니라 SKILL.md의 트리거·제외 조건을 설계한 사례다. 스킬 디렉터리 19개와 marketplace의 플러그인 5개는 서로 다른 단위다. 폴더 하나를 더한 것과 설치 묶음을 바꾼 것을 구분해 실습한다.

skill-creator/scripts/quick_validate.py는 frontmatter를 YAML로 읽고 허용 키·필수 name/description·문자열 길이 등을 검사한다. 형식 검증이 “적절한 상황에만 호출되는가”라는 행동 평가를 대신하지 않는다.

대조: 고정 커밋 ca45fc496a34의 README, marketplace.json, 두 새 SKILL.md, quick_validate.py. 여기서는 저장소 내용을 분석했으며 스킬 설치나 모델 호출은 수행하지 않았다.

5-2. 한 개 스킬 폴더의 표준 구조

5-3. 기존 예제 스킬을 4개 카테고리로 정리

5-4. 운영 스킬 4종의 라이선스 주의

6학습 포인트 (기술별)

각 스킬에서 무엇을 훔쳐올 수 있나

6-1. skill-creator — 메타 학습의 정수

6-2. mcp-builder — MCP 서버 표준 매뉴얼

6-3. pdf — Python PDF 처리 베스트 프랙티스

6-4. docx / pptx / xlsx — 운영 사례 그대로

Claude.ai에서 실제로 매일 돌아가는 코드. npm docx(JS)·pandoc·XML 직접 편집으로 Word 파일 생성/편집, PptxGenJS로 신규 생성·markitdown/XML로 편집, openpyxl로 수식·차트·피벗을 어디까지 자동화할 수 있는지의 한계선이 한 곳에 정리돼 있다.

6-5. brand-guidelines / internal-comms — 회사 톤의 표준화

Anthropic이 어떻게 자기 톤/색/타이포를 모델에 주입하는지의 실물 샘플. "왜 그렇게 쓰는지의 이유"가 잔뜩 적혀 있어서 다른 회사가 자기 가이드를 만들 때 그대로 따라할 수 있는 골격.

6-6. web-artifacts-builder / frontend-design — 인터랙티브 산출물

React + Tailwind + shadcn/ui로 멀티 컴포넌트 아티팩트를 짜는 가이드. 단일 파일 HTML/JSX와의 트레이드오프, 상태 관리·라우팅이 필요할 때만 쓸 것 등 의사결정 기준 명시.

7시스템 요구사항 & 라이선스

실제로 깔아서 돌리려면

7-1. 클라이언트 요구사항

7-2. 스킬별 부속 의존성

• pdf: pypdf, pdfplumber, reportlab, (OCR 시) pytesseract + pdf2image + Tesseract 시스템 바이너리
• docx: npm docx 패키지(JS), pandoc
• pptx: PptxGenJS(JS npm), markitdown
• xlsx: openpyxl, 차트를 위해 matplotlib 등 추가될 수 있음
• algorithmic-art: p5.js (CDN), 별도 설치 불필요
• webapp-testing: Playwright
• skill-creator: claude CLI (description 자동 튜닝 시)

7-3. 라이선스 요약

8직접 해볼 수 있는 실습 과제

난이도별 5개

9관련 기술 심화 학습 로드맵

8주 코스

10핵심 키워드 사전

처음 보면 헷갈리는 용어 정리

11참고 링크

더 깊이 파고들 때

• GitHub 레포 — github.com/anthropics/skills
• Agent Skills 표준 — agentskills.io (스펙은 /specification)
• What are skills? — Anthropic 공식 도움말 (support.claude.com)
• Using skills in Claude — 사용자 가이드
• Creating custom skills — 직접 만들기 가이드
• Engineering 블로그 — "Equipping agents for the real world with Agent Skills" (anthropic.com/engineering)
• Claude API Skills 가이드 — docs.claude.com/en/api/skills-guide
• MCP 사양 — modelcontextprotocol.io
• Trendshift 페이지 — trendshift.io/repositories/15786
• Notion Skills for Claude (파트너 예시) — Notion이 자기 앱용 스킬을 어떻게 만들었는지 사례