CLAUDE.md 완전 정복 -Skills 완전 가이드

슬래시 커맨드로 반복 작업을 자동화하는 커스텀 커맨드 만들기

Skills란 무엇인가

Claude Code Skills는 반복해서 사용하는 작업 절차를 슬래시 커맨드로 등록하는 기능입니다.

CLAUDE.md가 "항상 이렇게 해줘"라는 상시 적용 설정이라면, Skills는 "지금부터 이걸 해줘"라는 온디맨드 지시 템플릿입니다.

Skills는 .claude/skills/ 디렉토리에 배치하는 마크다운 파일입니다. 파일명이 그대로 슬래시 커맨드명이 됩니다.

.claude/
└── skills/
├── commit.md → /commit 으로 호출
├── review-pr.md → /review-pr 으로 호출
├── new-component.md → /new-component 으로 호출
└── migrate.md → /migrate 으로 호출

기본적인 Skill 작성법

Skill 파일은 마크다운으로 자유롭게 작성합니다. 단, 절차는 번호 붙인 리스트, 출력 형식은 명시하는 것이 핵심입니다.

예: 커밋 Skill

.claude/skills/commit.md:

변경 내용을 확인하고, 적절한 커밋 메시지를 생성하여 커밋해 주세요.

절차:
1. `git diff --staged`로 변경 내용을 확인한다
2. 변경이 스테이징되지 않은 경우, `git diff`로 확인하고 관련 파일을 스테이징한다
3. 변경 내용을 분석하여 Conventional Commits 형식의 메시지를 생성한다
4. `git commit`을 실행한다

커밋 메시지 규칙:
- 프리픽스: feat, fix, refactor, docs, test, chore
- 한국어로 기술한다
- 1행은 50자 이내
- 필요에 따라 본문에 상세 내용 기재 (왜 변경했는지 중심으로)

에러 처리:
- 커밋 실패 시 원인을 분석하고 수정 후 재시도한다
- 충돌이 있는 경우 사용자에게 알리고 중단한다

사용법: 채팅에서 /commit 이라고 입력하기만 하면 됩니다.

예: PR 리뷰 Skill

.claude/skills/review-pr.md:

지정된 PR을 리뷰해 주세요.

사용법: /review-pr {PR번호}

절차:
1. `gh pr diff {PR번호}`로 변경 차분을 취득한다
2. `gh pr view {PR번호}`로 PR 설명을 취득한다
3. 다음 관점에서 리뷰한다:
- 버그 또는 논리 오류가 없는지
- 보안상 문제가 없는지 (인증·인가 누락, SQL 인젝션 등)
- 퍼포먼스 문제가 없는지 (N+1 쿼리, 불필요한 재렌더링 등)
- 테스트가 충분한지 (엣지 케이스, 에러 케이스 포함)
- 팀 코딩 규약에 따르고 있는지
4. 문제가 있으면 코멘트 안을 작성한다
5. 문제가 없으면 LGTM임을 보고한다

리뷰 결과 출력 형식:
## PR #{ PR번호} 리뷰 결과

### � 수정 필요
- [ ] `파일명:행번호` — 설명 및 수정 제안

### � 개선 제안 (선택)
- `파일명:행번호` — 제안 내용

### � 좋은 점
- 구체적으로 좋은 점을 든다

### 종합 판정
LGTM / 수정 요청 / 논의 필요

사용법: /review-pr 123 으로 PR #123을 리뷰합니다.