B-6 스킬 — 절차 접어두기

개념한 문장

반복 절차를 접어둔다

테스트 실패 분석, 배포 순서, 릴리스 노트 작성 — 이런 절차를 매번 설명하고 있다면 스킬로 옮길 때입니다.

스킬은 필요할 때만 본문이 로드됩니다. 평소 문맥에는 이름과 설명 몇 줄만 올라가므로, 긴 참고 자료를 넣어도 쓰기 전까지는 비용이 거의 없습니다.

	CLAUDE.md	스킬
담는 것	항상 알아야 할 사실	가끔 필요한 절차
로드	세션 시작 시 항상	호출될 때만
길이	200줄 이내 권장	길어도 됨 (참고 자료 분리)

옮길 신호CLAUDE.md의 한 항목이 여러 단계짜리 절차로 자라고 있다면, 그건 스킬입니다.

만들기파일 하나

SKILL.md 쓰기

폴더 하나에 SKILL.md 한 장이면 끝입니다.

.claude/skills/release-notes/
├── SKILL.md
├── template.md          # "template.md를 읽어라"로 참조
└── scripts/collect.sh

---
name: release-notes
description: 릴리스 노트를 작성할 때 사용. 태그 사이 커밋을 모아 사용자 관점으로 정리한다.
allowed-tools: Bash, Read, Write
---

# 릴리스 노트 작성

1. `git log <이전태그>..HEAD --oneline` 으로 커밋 수집
2. 신규 / 개선 / 버그 수정 / 내부 변경 — 4분류로 묶는다
3. 사용자가 체감하는 변화로 바꿔 쓴다
   - X  refactor: extract validator
   - O  잘못된 날짜 입력을 저장 전에 걸러냅니다
4. 내부 변경은 한 줄로 합친다
5. `docs/release/<버전>.md` 에 저장

description이 전부스킬이 언제 불릴지는 이 한 문장이 정합니다. "릴리스 노트 작성"처럼 짧게 적으면 자동으로 불리지 않습니다. 어떤 상황에서 써야 하는지를 구체적으로 쓰세요.

호출두 가지 방법

자동으로 · 내가 직접

스킬은 상황에 맞으면 Claude가 알아서 부릅니다. 그리고 이름 앞에 /를 붙여 내가 직접 부를 수도 있습니다.

/release-notes v1.4.0

그래서 예전의 커스텀 슬래시 명령은 스킬로 통합됐습니다. 반복해서 길게 쓰던 지시를 단축키로 만들면 이렇게 됩니다.

# .claude/skills/handoff/SKILL.md
---
name: handoff
description: 작업을 마치고 기록을 남길 때 사용. 변경 요약과 검증 결과를 정해진 형식으로 적고 커밋한다.
---

방금 한 작업을 PROJECT.md의 `## Handoff Log` 형식(작업/변경/검증/다음)에
맞춰 한글로 추가하고, Work Board에서 내 행을 제거한 뒤 커밋해라. $ARGUMENTS

$ARGUMENTS 자리에 뒤에 적은 말이 들어갑니다 — /handoff badge-dup 처럼 씁니다.

실습15분

내 절차 하나를 스킬로

가장 자주 설명하는 절차를 고른다

매번 같은 순서로 시키는 일이면 후보입니다.

단계로 적는다

번호를 붙여 순서대로. 판단이 필요한 지점은 기준까지 적습니다.

description을 다듬는다

언제 불러야 하는지를 상황으로 서술합니다.

두세 번 시켜본다

불려야 할 때 불리는지, 안 불려야 할 때 안 불리는지 확인합니다.

절차와 사실의 차이를 설명할 수 있다
SKILL.md를 하나 만들었다
description에 호출 상황을 적었다
자동 호출과 / 직접 호출을 모두 써봤다

클로드코드 시작하기트랙 B · 개발자