topic★★★★★난이도 · 약 20분

Skills & 커스텀 명령어 — 반복 작업을 한 줄로

자주 쓰는 프롬프트를 SKILL.md 파일로 저장하고 /skill-name 한 줄로 호출한다.

#Skills#SKILL.md#커스텀 명령어#자동화

왜 배우는가

매번 같은 지시를 반복 타이핑하는 건 시간 낭비다. Skills를 만들면 팀 전체가 동일한 품질로 작업을 재현할 수 있다.

Skills는 재사용 가능한 프롬프트 템플릿이다. 복잡한 지시사항을 마크다운 파일 하나에 담아두고, 슬래시 명령어(`/skill-name`)로 즉시 호출한다. 매번 프롬프트를 다시 작성할 필요가 없어지므로 일관성과 속도 두 마리 토끼를 잡을 수 있다.

도구 사용 — Skills는 자주 쓰는 프롬프트 패턴을 커스텀 도구로 승격시킨다

bash

# Skills 파일 구조
.claude/
└── skills/
    ├── review/
    │   └── SKILL.md      # /review 로 호출
    ├── deploy/
    │   └── SKILL.md      # /deploy 로 호출
    └── test-fix/
        └── SKILL.md      # /test-fix 로 호출

.claude/skills/ 디렉토리 아래에 폴더를 만들고, 각 폴더에 SKILL.md를 넣으면 자동 등록된다.

bash

# SKILL.md 예시 — 코드 리뷰 스킬
# /review

현재 브랜치의 변경사항을 리뷰해주세요.

## 체크리스트
1. 타입 안전성
2. 에러 핸들링 누락
3. 성능 이슈
4. 보안 취약점

## 출력 형식
- 심각도: HIGH / MEDIUM / LOW
- 파일명과 라인 번호 포함
- 수정 제안 코드 블록 포함

SKILL.md 첫 줄에 '# /명령어'를 적으면 해당 이름으로 호출할 수 있다.

항목	설명
저장 위치	`.claude/skills/{이름}/SKILL.md`
호출 방법	Claude Code에서 `/skill-name` 입력
인자 전달	`/review src/app` 처럼 뒤에 인자 추가 가능
팀 공유	Git에 커밋하면 팀 전체가 동일 스킬 사용
스코프	프로젝트 레벨(`.claude/`) 또는 사용자 레벨(`~/.claude/`)

팀에서 Skills를 공유하면 '코드 리뷰 기준이 사람마다 다르다' 같은 문제가 사라진다. 시니어가 만든 리뷰 스킬을 주니어도 그대로 쓸 수 있고, 새 팀원이 와도 `/review` 한 번이면 팀 표준을 적용할 수 있다.