코드를 검토할 때마다 “변경 내용을 요약하고, 빠진 테스트와 위험한 부분을 알려줘”라는 요청을 반복한다면 스킬로 저장할 수 있습니다. 스킬은 Claude에게 시킬 작업과 순서를 적어 둔 SKILL.md 파일입니다. 저장한 스킬은 /review-notes 같은 명령으로 불러 사용할 수 있습니다.
프로젝트의 기본 규칙을 적는 CLAUDE.md와는 용도가 다릅니다. CLAUDE.md는 대화가 시작될 때마다 참고하고, 스킬 본문은 해당 작업에 필요할 때 읽습니다. 테스트 명령이나 팀 규칙은 CLAUDE.md에, 코드 검토나 배포처럼 여러 단계가 있는 작업은 스킬에 두면 정리하기 쉽습니다.
1. 스킬 폴더와 파일 만들기
프로젝트 안에 다음 경로로 파일을 만드세요.
.claude/skills/review-notes/SKILL.mdreview-notes는 이번에 만들 스킬의 이름입니다. 프로젝트 안에 두면 해당 프로젝트에서 사용할 수 있고, Git으로 공유하면 팀원도 같은 파일을 사용할 수 있습니다.
여러 프로젝트에서 혼자 사용할 스킬이라면 ~/.claude/skills/review-notes/SKILL.md에 저장합니다.
2. 실행할 작업과 순서 적기
이번 예제는 코드를 수정하지 않고 변경 내용만 검토합니다. 아래 내용을 SKILL.md에 저장하세요.
---
name: review-notes
description: 현재 코드의 변경 내용을 검토합니다. 사용자가 변경 요약이나 커밋 전 검토를 요청할 때 사용합니다. 파일을 수정하거나 커밋하지 않고 검토 결과만 보고합니다.
---
## 현재 변경 내용
!`git diff HEAD`
## 검토 순서
1. 주요 변경 내용을 세 항목 이내로 요약합니다.
2. 빠진 테스트, 노출된 비밀 정보, 의도하지 않은 동작이 있는지 살펴봅니다.
3. 변경 내용이 없으면 없다고 알리고 종료합니다.
4. 파일을 수정하거나 Git 기록을 바꾸는 명령을 실행하지 않습니다.파일 맨 위의 --- 사이에는 이름과 설명을 적습니다. name은 스킬 이름이고, description은 어떤 요청에 이 스킬을 사용하면 되는지 알려 주는 설명입니다. 그 아래에는 실제 작업 순서를 작성합니다.
!`git diff HEAD` 는 이 스킬을 읽기 전에 명령을 실행하고, 그 결과를 작업 자료로 넣는 문법입니다. git diff HEAD는 Git이 이미 관리 중인 파일을 마지막 커밋과 비교합니다. 따라서 아직 Git에 추가하지 않은 새 파일은 이 예제의 검토 자료에 포함되지 않습니다. 커밋이 있는 Git 프로젝트에서 사용하는 예제입니다.
3. 스킬 실행하고 결과 확인하기
프로젝트 폴더에서 Claude Code를 실행한 뒤 다음 명령을 입력하세요.
/review-notes변경 내용을 짧게 요약하고, 확인이 필요한 항목을 정리하는지 살펴보세요. 예를 들어 마감일 입력 기능을 추가했다면 “날짜를 입력하지 않은 경우의 테스트가 있는지”처럼 변경과 관련된 검토가 나오는지 확인하면 됩니다. 이는 기대하는 검토의 예이며, 실제 결과는 프로젝트와 변경 내용에 따라 달라집니다.
스킬의 설명이 요청과 맞으면 Claude가 스스로 선택해 사용할 수도 있습니다. 직접 명령을 입력했을 때만 실행되게 하려면 파일 맨 위 설정에 다음 줄을 추가하세요.
disable-model-invocation: true기존에 .claude/commands/에 만든 커스텀 명령도 계속 사용할 수 있습니다. 새로 만드는 반복 작업은 SKILL.md로 작성하면, 필요에 따라 참고 자료와 보조 파일을 같은 폴더에 모아 관리할 수 있습니다.
관련 글
YouTube
지시 200개 스킬 한도는 아직 유효한가?