같은 절차를 세 번째 설명하고 있다면 스킬로 만들 때다.

이 장에서 기억할 핵심은 세 가지다.

• 핵심 파일 하나 — 폴더 하나와 SKILL.md 파일 하나로 구성
• 두 가지 호출 방법 — 자동 선택 또는 /이름으로 직접 호출
• 두 가지 저장 위치 — 사용자 전체 · 현재 프로젝트

CLAUDE.md와 스킬의 차이

둘 다 지침을 미리 기록하는 장치지만 컨텍스트에 포함되는 시점이 다르다.

• CLAUDE.md — 대화가 시작될 때마다 포함되므로 간결하게 유지한다.
• 스킬 — 호출될 때만 본문이 포함되므로 여러 단계의 절차를 담을 수 있다.

여러 단계로 구성되거나 특정 상황에서만 사용하는 절차라면 스킬로 만든다.

스킬의 기본 구성

스킬의 기본 구조는 폴더 하나와 SKILL.md 파일 하나다. 파일은 다음 두 부분으로 나뉜다.

• 머리말 — --- 사이에 작성하는 description. 언제 이 스킬을 사용해야 하는지를 알려 준다.
• 본문 — 스킬을 호출했을 때 따를 구체적인 지침

폴더 이름은 직접 호출할 때 사용할 명령 이름이 된다. summarize-changes 폴더를 만들면 /summarize-changes로 호출한다.

첫 번째 스킬 — 공식 예제