스킬 구조 가이드

규칙이 적고 한 파일에 담을 수 있을 때. 대부분의 스킬은 여기서 시작합니다.

coding-convention/
  └── SKILL.md

실제 예: Anthropic frontend-design, brand-guidelines

SKILL.md가 커지면 주제별 .md 파일로 분리합니다. 루트에 바로 두거나 references/ 디렉토리에 넣거나 자유.

api-design/
  ├── SKILL.md
  ├── rest-conventions.md
  ├── error-responses.md
  └── pagination.md

실제 예: Anthropic pptx (editing.md, pptxgenjs.md), skill-creator (references/)

배포 체크, 린트, 검증 등 AI가 실행할 수 있는 스크립트를 번들합니다.

deploy-checklist/
  ├── SKILL.md
  └── scripts/
        └── check-deploy.sh

실제 예: Anthropic docx, xlsx, pdf

템플릿, 폰트, 이미지 등 AI가 참조하거나 출력에 사용할 파일을 번들합니다.

ui-kit/
  ├── SKILL.md
  ├── assets/
  │     ├── template.html
  │     └── tokens.json
  └── examples/
        └── sample-output.md

실제 예: Anthropic canvas-design (폰트), skill-creator (assets/)

여러 언어나 환경에 대한 가이드를 제공할 때.

api-client/
  ├── SKILL.md
  ├── typescript/
  │     └── examples.md
  ├── python/
  │     └── examples.md
  └── shared/
        └── common-patterns.md

실제 예: Anthropic claude-api (8개 언어별 디렉토리 + shared/)

AI가 하위 에이전트를 생성해서 작업을 분배하는 복잡한 스킬.

review-pipeline/
  ├── SKILL.md
  ├── agents/
  │     ├── security-checker.md
  │     └── performance-reviewer.md
  ├── references/
  └── scripts/

실제 예: Anthropic skill-creator (agents/, references/, scripts/, assets/, eval-viewer/)