슬래시 명령어와 Skills

같은 지시를 반복해서 타이핑하고 있다면, 그건 절차로 묶어야 할 신호입니다. 방법은 두 가지입니다. 이 글은 둘을 나란히 놓고 "무엇을 언제 쓰나"를 가르는 개요이고, 슬래시 명령어를 직접 만드는 절차는 커스텀 커맨드 입문부터 이어지는 4편의 코스에, Skills 파일 작성법은 SKILL.md 작성법에 있습니다.

슬래시 명령어 — 내가 부를 때 실행

.claude/commands/ 아래에 마크다운 파일을 만들면 그대로 명령어가 됩니다.

.claude/commands/release-note.md   →   /release-note

파일 내용은 그냥 프롬프트입니다.

---
description: 지난 태그 이후 커밋으로 릴리스 노트 초안 작성
---

`git log <최신 태그>..HEAD --oneline` 결과를 읽고,
사용자에게 의미 있는 변경만 골라 다음 형식으로 정리해줘:

## 새 기능
## 개선
## 버그 수정

내부 리팩터링과 의존성 업데이트는 제외할 것.

인자를 받을 수도 있습니다. $ARGUMENTS가 호출 시 입력한 텍스트로 치환됩니다.

Skills — 필요할 때 스스로 꺼내 쓰는 절차

Skills는 설명(description)을 보고 Claude가 알아서 불러오는 지식 묶음입니다. 폴더 구조는 이렇습니다.

.claude/skills/pdf-report/
  SKILL.md          ← 절차 본문 + 언제 쓰는지
  templates/        ← 참조 파일
  scripts/          ← 실행 스크립트

SKILL.md의 프론트매터가 핵심입니다.

---
name: pdf-report
description: 월간 매출 데이터를 사내 표준 양식 PDF 리포트로 변환한다.
  사용자가 "월간 리포트", "매출 PDF" 같은 요청을 할 때 사용한다.
---

description이 곧 발동 조건입니다. 여기가 모호하면 영영 안 불립니다.

무엇을 언제 쓰나

간단히 말해 부를 때 쓰는 건 명령어, 알아서 쓰이길 원하면 Skill입니다.

Skills 작성 요령

1. description에 트리거를 구체적으로 쓴다

"PDF를 만든다" (X) → "월간 매출 데이터를 사내 표준 PDF로 변환한다. '월간 리포트', '매출 PDF' 요청 시 사용" (O)

2. 본문은 절차로 쓴다

설명문이 아니라 순서대로 따라 할 수 있는 단계로 쓰세요.

3. 판단이 필요한 지점을 명시한다

"데이터가 비어 있으면 사용자에게 물어본다"처럼 예외 처리를 적어 두면 엉뚱한 결과가 줄어듭니다.

4. 스크립트로 대체할 수 있으면 스크립트로

매번 같은 변환이라면 프롬프트로 설명하는 것보다 스크립트를 넣고 "이걸 실행하라"고 하는 편이 정확하고 저렴합니다.

팀에 배포하기

두 방식 모두 저장소에 커밋하면 팀 전체가 공유합니다. 사내 절차, 코드 리뷰 기준, 배포 체크리스트처럼 사람마다 다르게 하고 있던 일을 여기에 담으면 편차가 사라집니다.