Claude 블로그 되짚어보기 #83 — 32-page Skills Playbook, 표준 정착의 선언 (2026)
원문 정보
- 제목: A complete guide to building skills for Claude
- 링크: claude.com/blog/complete-guide-to-building-skills-for-claude
- 발행: 2026년 1월 29일 (32-page playbook 공개)
- 카테고리: Claude Code
글의 요지
Skills 빌드의 결정판 가이드 — 32페이지 종합 PDF. October 2025 Skills 출시 후 3개월의 학습 결정체. 계획·구조·테스트·배포 의 모든 단계 커버. 누가 빌드하나? 4가지 segments 식별:
1. 개발자 — 일관된 워크플로
2. Power user — 반복 작업 자동화
3. 팀 — 조직 표준화
4. MCP connector 빌더 — 통합 + 워크플로
가이드의 핵심 — Use Case First
본문 강조:
"Before writing any code, identify 2-3 concrete use cases your skill should enable."
(코드 쓰기 전 2-3개 구체 use case 식별)
각 use case 정의:
- Trigger (사용자가 뭐라고 말하나)
- Sequence (단계)
- Result (기대 결과)
이 "use-case-first" 접근이 흔한 실패 모드 방지:
- 기술적으로 완벽
- 그러나 실제 쿼리에 trigger X
- "never used" 운명
3-tier Progressive Disclosure (재요약)
| Level | 내용 | 로딩 |
|---|---|---|
| 1 | YAML frontmatter | 항상 (시스템 prompt) |
| 2 | SKILL.md body | 관련 시 |
| 3 | references/ | 필요 시만 |
이 token efficiency가 수백 Skills 등록 가능하게 함.
YAML Frontmatter — 가장 중요
본문이 강조:
"The YAML frontmatter is how Claude decides whether to load your skill. Get this right or your skill never triggers."
(YAML frontmatter가 로드 결정. 잘 쓰지 않으면 trigger 안 됨)
좋은 description 예:
description: Analyzes Figma design files and generates
developer handoff documentation. Use when user uploads
.fig files, asks for "design specs", "component
documentation", or "design-to-code handoff".특징:
- 구체적 + actionable
- Trigger phrases 명시
- Value proposition 명확
3가지 Skill 카테고리
1) Document & Asset Creation
- Reports, presentations, UI designs, code
- Anthropic 사례:
frontend-design,docx,pptx,xlsx - Style guides, output templates, quality checklists 임베드
2) Workflow Automation
- 멀티 단계 프로세스
- 일관된 방법론
- Sprint planning, customer onboarding, etc.
3) MCP Enhancement
- 도메인 전문성 + 도구 접근
- 사례:
sentry-code-review(Sentry MCP + Skill) - "Raw API connectivity → guided workflows"
빌드 시간
본문 추정:
"If you know the top 2-3 workflows you want to automate, expect about 15-30 minutes to build and test your first working skill using the skill-creator."
(상위 2-3 워크플로 알면 첫 Skill 빌드+테스트 15-30분)
Cross-Surface Portability
본문 강조:
"Skills work identically across Claude.ai, Claude Code, and API. Create a skill once and it works across all surfaces without modification."
(Claude.ai, Claude Code, API 동일 작동. 한 번 만들면 모든 surface에서)
Common Patterns (Anthropic 내부 사례)
Tort Mario (Anthropic 엔지니어) 인용 — "수백 Skills in production":
| 패턴 | 예시 |
|---|---|
| Code Style | code-style — Claude 기본 스타일 강제 |
| Testing | testing-practices — 테스트 작성·내용 가이드 |
| CI/CD | babysit-pr — flaky CI 재시도, 머지 충돌 해결, auto-merge |
| Deploy | deploy-service — build → smoke test → gradual rollout |
| Investigation | log-correlator — request ID 기반 multi-system 로그 |
가장 가치 있는 부분 — Gotchas
본문 강조:
"The most valuable content in any skill is the Gotchas section — common mistakes."
이게 "운영 지혜의 캡슐화":
- 실제 Claude가 만난 실수
- 시간 지나며 업데이트
- 새 Skill 사용자가 즉시 회피
2026년에 다시 읽으며 — 내가 본 것
1. "32-page Playbook"의 시그널
이 가이드 자체가 시그널이다.
October 2025 Skills 출시:
- 짧은 블로그 포스트
- "새 기능 있음"
January 2026 (이 글):
- 32 페이지 PDF
- 모든 패턴 + 케이스
- "이게 표준이다"
이 격차가 Skills의 시장 정착 속도를 보여준다:
- 3개월에 거대 사용 사례 누적
- 베스트 프랙티스 명확화
- 표준 문서화 시점 도달
비교 — MCP 표준화:
- 2024년 11월 출시
- 2025년 6월 표준 문서
- 7개월
Skills:
- 2025년 10월 출시
- 2026년 1월 표준 문서
- 3개월
이 가속이 "Skills가 MCP보다 빠르게 정착" 의 시그널이다.
2. "수백 Skills in production"의 운영 검증
Tort Mario (Anthropic 엔지니어) 인용:
"Here at Anthropic, we use skills heavily inside Claude Code — we now have hundreds of them in production."
이게 "dogfooding 검증":
- Anthropic 자체 = 수백 Skills 실사용
- 이 검증된 패턴이 가이드의 토대
- "우리도 이 정도, 너희도"
비교 — 외부 가이드 vs 내부 데이터:
- 외부: "이론적 좋은 패턴"
- 내부: "실제 운영하는 패턴"
Anthropic이 둘 다 하니까 가이드 신뢰성 높음.
3. "Skills 2.0" 의 인식
AI Maker 인용:
"The recent update turned Skills into something completely different: full workflow packages. The AI community started calling this 'Skills 2.0' because the jump is that significant."
(최근 업데이트가 Skills를 완전 다른 것으로. "Skills 2.0" 명칭이 커뮤니티에서 등장)
진화:
- Skills 1.0 (October 2025): 단순 Markdown 프롬프트 캡슐화
- Skills 2.0 (January 2026): 풀 워크플로 패키지
- 스크립트 실행
- 파일 생성
- 실제 deliverable
- Smart loading (progressive disclosure)
- Pre-built (Excel, PowerPoint, Word, PDF)
3개월에 "interesting feature" → "infrastructure" 변환.
4. "MCP = Kitchen, Skills = Recipes" 의 정확한 비유
Amanraj Medium 인용:
"MCP is the kitchen. Skills are the recipes. MCP gives Claude access to your tools and data. Skills tell Claude how to use them."
이 비유가 "#74 글 (Skills + MCP)" 의 가장 명확한 정의다:
- 주방 (도구) + 레시피 (절차) = 요리
- MCP + Skills = 자동화
좋은 비유의 효과:
- 비기술자 즉시 이해
- 결정 명확 ("MCP만? 아니, 둘 다")
- Marketing simplicity
5. "Frontend Design Skill"의 구체 사례
본문 인용:
- Anthropic 엔지니어가 iteratively 빌드
- 사용자와 함께
- "Claude의 design taste 개선"
- "clichés 회피" (Inter font, purple gradients)
이 사례가 흥미로운 이유:
- AI 모델 자체에 "디자인 trend" 학습 X
- Skill로 추가 학습
- "Inter font 그만" 같은 구체 가이드
이게 모델 한계 보완의 패턴이다:
- 모델 = 일반 능력
- Skill = 전문 + 시대적 trend
- 모델 업데이트 없이 trend 따라가기
6. "Gotchas Section"의 운영 지혜
본문 강조 — "Gotchas가 가장 가치 있는 부분".
전통 문서:
- "이렇게 하세요" (positive)
- "이건 안 됩니다" (some negative)
Skill의 Gotchas:
- "실제 Claude가 만난 실수" (구체)
- "왜 실패했는지" (이유)
- "어떻게 회피" (해결)
이게 Tribal knowledge의 명문화다:
- 시니어가 알지만 안 쓰는 지식
- "이런 함정", "이런 패턴"
- Skill에 캡슐화 → 모든 사용자
이 "실패 사례 documentation" 이 진짜 운영 가치다.
7. "15-30분 빌드"의 마찰 0
본문 추정 "첫 Skill 15-30분" 의 의미:
비교 — 도입 마찰:
- Custom GPT 빌드 (OpenAI): 15-30분
- Workflow 자동화 (Zapier): 1-2 시간
- Custom plugin (전통): 며칠
- Claude Skill: 15-30분
이 마찰 0에 가까움이 자기 자동화 폭발의 동력이다:
- 비기술자도 시도 가능
- 실패 비용 낮음
- "안 되면 다시" 가능
이게 #78 (Austin) 의 "일주일에 2개 빌드" 가능했던 이유.
8. "Sentry, PayFlow, Linear" 사례의 시장 방향
본문이 인용한 회사들:
- Sentry: 에러 모니터링 → MCP + Skill
- PayFlow: 결제 → Customer onboarding Skill
- Linear: 프로젝트 관리 → Sprint Skill
- Figma: 디자인 → Handoff Skill
이 패턴의 시장 시그널:
- 각 SaaS가 자기 도메인 Skill
- AI 통합 = 마케팅 우위
- "Claude와 잘 작동" 차별점
미래 예측:
- 모든 거대 SaaS가 자기 Skill 출시
- Skills Marketplace 폭발
- 회사 스택 = "여러 Skill 조합"
이게 AI 시대 SaaS 생존의 결정적 길이다.
마무리
이 글은 "Skills 가이드" 같지만, 실제로는 AI 자동화 기술의 표준화 선언이다.
- 32-page Playbook: 표준 문서
- 수백 Skills in production: 내부 검증
- Skills 2.0 인식: 패러다임 진화
- MCP = Kitchen, Skills = Recipes: 명확 비유
- Frontend Design Skill: 모델 한계 보완
- Gotchas Section: tribal knowledge 명문화
- 15-30분 빌드: 마찰 0
- Sentry/PayFlow/Linear: SaaS 생존 길
2026년 1월 29일 시점은 "Skills 어떻게?" 질문이 "Skills 어디에?" 로 진화한 시점이다.
흥미로운 건 이 가이드가 "기술 문서" 가 아니라 "표준 정착 도구" 라는 점이다:
- 32페이지 PDF = 진지함의 시그널
- 빌드 시간 명시 = 마찰 제거
- 사례 다수 = 검증
- 카테고리 분류 = 시장 형성
이 모든 요소가 표준 정착의 가속을 의미한다. 다른 회사가 "우리도 비슷한 거 만들까" 결정 시 → "Anthropic 표준이 이미 있음" → 따라옴 또는 호환.
다음 5년의 AI 자동화 시장은 Skills 위에서 빌드된다. Anthropic이 이 표준 정의 + 가장 잘 활용. MCP의 패턴 정확히 반복:
1. 출시 (Oct 2025)
2. 검증 (3개월)
3. 표준 문서 (이 글)
4. 다른 회사 채택 (예측)
5. 산업 표준 정착
이 가속이 $30B 매출 달성의 동력이다. 단순 모델 X, 인프라 + 표준 베팅.
