SKILL.md 완전 가이드 — Claude & OpenClaw
SKILL.md Complete Guide — Claude & OpenClaw
SKILL.md는 Claude에게 특정 작업을 수행하는 방법을 가르치는 지침 파일입니다. 스킬 선택은 description 한 줄로 결정되고, 본문·scripts/·references/는 필요할 때만 로딩됩니다. 아래 레퍼런스에는 파일 구조부터 OpenClaw·Skill Gap까지 14개 섹션을 담았습니다.
한눈에 보기
| 단계 | 무엇이 로딩되나 | 핵심 |
|---|---|---|
| Level 1 | name + description | 항상 컨텍스트 · 스킬 선택의 유일한 기준 |
| Level 2 | SKILL.md 본문 | 트리거 후 로딩 · 500줄 이하 권장 |
| Level 3 | scripts/ · references/ · assets/ | 명시 참조 시만 · 용량 제한 없음 |
핵심: description에 무엇을 하는지와 언제 쓸지(트리거 키워드)를 함께 넣으세요. Claude는 스킬을 과소 사용하는 경향이 있어, “고려하세요”보다 “반드시 사용” 수준이 더 잘 트리거됩니다.
전체 레퍼런스 가이드
목차 사이드바, 코드 예시, 좋은/나쁜 예 비교, 체크리스트, OpenClaw·Universe Skills·Skill Gap까지 포함합니다.
스킬을 쓰는 이유
잘 설계된 스킬은 반복 워크플로를 고정하고, 전문가 판단 기준을 파일로 옮겨 Skill Gap을 줄입니다. Claude Code·Cowork뿐 아니라 OpenClaw 같은 에이전트 플랫폼에서도 같은 원칙(단일 책임, 명확한 트리거, 점진적 로딩)이 통합니다.