Claude Code skills를 쓰면, 채팅에 반복해서 붙여 넣던 검토 체크리스트를 저장할 수 있습니다. 각 스킬은 SKILL.md 파일이 들어 있는 디렉터리입니다. 요청이 설명과 맞으면 Claude가 사용할 수 있고, /review-notes 같은 명령으로 직접 시작할 수도 있습니다.
프로젝트의 기본 규칙을 적는 CLAUDE.md와는 용도가 다릅니다. CLAUDE.md는 대화가 시작될 때마다 참고하고, 스킬 본문은 해당 작업에 필요할 때 읽습니다. 테스트 명령이나 팀 규칙은 CLAUDE.md에, 코드 검토나 배포처럼 여러 단계가 있는 작업은 스킬에 두면 정리하기 쉽습니다.
1. 스킬 폴더와 파일 만들기
프로젝트 안에 다음 경로로 파일을 만드세요.
.claude/skills/review-notes/SKILL.mdreview-notes는 이번에 만들 스킬의 이름입니다. 프로젝트 안에 두면 해당 프로젝트에서 사용할 수 있고, Git으로 공유하면 팀원도 같은 파일을 사용할 수 있습니다.
개인용 경로는 ~/.claude/skills/<name>/SKILL.md이며, 이 머신의 모든 프로젝트에서 불러옵니다. Cowork나 클라우드 세션에서는 불러오지 않습니다. 그 디렉터리에서만 쓰는 작업은 <subdir>/.claude/skills/<name>/SKILL.md에 둡니다. 그 디렉터리보다 위에서 시작한 세션은 Claude가 그곳의 파일을 다룰 때 이 스킬을 불러옵니다.
2. 실행할 작업과 순서 적기
보고만 하는 첫 스킬은 신뢰하기 쉽습니다. 현재 파일과 마지막 Git 커밋의 차이를 읽은 뒤 검토 노트를 작성합니다. 예제의 네 가지 지시는 모델에게 보고만 하라고 전하며, 파일 편집 도구나 git 도구를 거두지는 않습니다. 아래 내용을 SKILL.md에 저장하세요.
---
name: review-notes
description: 현재 diff를 짧게 검토합니다. 사용자가 무엇이 바뀌었는지 묻거나, 커밋 전 노트를 원하거나, 위험 목록을 요청할 때 사용합니다. 보고만 하고, 파일을 수정하거나 커밋을 만들지 않습니다.
---
## 현재 변경 내용
!`git diff HEAD`
## 검토 순서
1. 주요 변경 내용을 세 항목 이내로 요약합니다.
2. 위험을 나열합니다. 빠진 테스트, 비밀 정보, 실수로 보이는 동작입니다.
3. 변경 내용이 없으면 없다고 알리고 종료합니다.
4. 파일을 수정하지 않습니다. git 쓰기 명령을 실행하지 않습니다.프로젝트 스킬이나 개인 스킬에서는 디렉터리 이름이 입력하는 슬래시 명령이고, frontmatter의 name은 목록에 보이는 라벨입니다. 예제에서는 둘을 일부러 같게 둡니다. 파일 맨 위의 YAML frontmatter가 Claude에게 언제 사용할지를 알려 주고, 그 아래 마크다운이 절차입니다.
Claude Code는 git diff HEAD를 실행하고, Claude가 지시를 보기 전에 그 ! 행을 명령 출력으로 바꿉니다. git diff HEAD는 Git이 이미 추적하는 파일을 그 커밋과 비교합니다. 아직 Git에 추가하지 않은 새 파일은 포함되지 않습니다. 주입된 명령이 거부되거나 실패하면 Claude가 스킬을 보기 전에 스킬이 중단됩니다. 커밋이 있는 Git 프로젝트에서 사용하는 예제입니다.
3. 스킬 실행하고 결과 확인하기
프로젝트 폴더에서 Claude Code를 실행한 뒤 다음 명령을 입력하세요. 설명만으로 Claude가 스킬을 불러올 수 있으면 “내가 무엇을 바꿨지?”라고 물어보세요.
/review-notes변경 내용을 짧게 요약하고, 확인이 필요한 항목을 정리하는지 살펴보세요. 예를 들어 마감일 입력 기능을 추가했다면 “날짜를 입력하지 않은 경우의 테스트가 있는지”처럼 변경과 관련된 검토가 나오는지 확인하면 됩니다. 이는 기대하는 검토의 예이며, 실제 결과는 프로젝트와 변경 내용에 따라 달라집니다.
스킬의 설명이 요청과 맞으면 Claude가 스스로 선택해 사용할 수도 있습니다. 지시는 그 작업에 집중해서 적습니다. 한번 불러오면 스킬은 대화의 일부로 남고, 모델이 쓸 수 있는 컨텍스트의 일부를 사용합니다. 명시적으로 요청할 때만 실행하려면, --- 표시 사이의 YAML frontmatter에서 description 옆에 disable-model-invocation: true를 추가하고 /review-notes로 시작합니다.
disable-model-invocation: true커스텀 명령은 스킬로 합쳐졌습니다. .claude/commands/deploy.md와 .claude/skills/deploy/SKILL.md는 모두 /deploy를 만듭니다. 기존 명령 파일은 그대로 동작합니다. 새로 만드는 작업은 스킬로 둡니다. 보조 파일을 둘 수 있고, 사용자와 Claude 중 누가 호출할지를 정할 수 있으며, 관련 있을 때 스스로 불러옵니다.