Skills & Slash Commands: Dynamic Context Injection

SKILL.md 파일의 기본 구조:

---
name: my-skill          # 표시 이름 (커맨드 이름이 아님)
description: 무엇을 하는지, 언제 사용하는지
when_to_use: 트리거 문구들
disable-model-invocation: true   # 모델이 자동 트리거 못하게
user-invocable: false             # /메뉴에서 숨김
allowed-tools: Read Grep          # 이 스킬에서 허용할 도구
disallowed-tools: AskUserQuestion # 이 스킬에서 차단할 도구
model: claude-opus-4-7            # 이 스킬용 모델 오버라이드
effort: high                      # 노력 수준 오버라이드
context: fork                     # 포크된 서브에이전트에서 실행
paths: "src/**/*.ts"             # 이 경로에서만 활성화
---

## 지시사항
!`git diff HEAD`  ← 동적 컨텍스트: 실행 시 현재 diff 주입

가장 중요한 필드는 description이다. Claude는 이 설명을 기반으로 어떤 스킬이 관련있는지 판단한다. 좋은 description은 '무엇을'과 '언제'를 모두 담는다.

context: fork는 스킬을 메인 세션과 격리된 서브에이전트에서 실행한다. 긴 작업이나 독립적인 태스크에 유용하다.

스킬의 커맨드 이름은 name 필드가 아니라 파일 경로에서 결정된다. 이 규칙을 이해하지 못하면 커맨드를 찾지 못한다.

중첩 스킬에서 충돌이 생기면 : 네임스페이스로 구분된다. 플러그인 스킬은 플러그인 이름이 네임스페이스가 된다.

자동 발견 규칙: 스킬은 현재 작업 디렉토리와 모든 조상 디렉토리의 .claude/skills/에서 자동 발견된다. 서브디렉토리 스킬도 CLAUDE.md와 마찬가지로 지연 로딩된다.

실시간 변경 감지: SKILL.md 파일의 변경은 재시작 없이 즉시 반영된다.

Skills의 가장 강력한 기능은 스킬이 실행될 때 쉘 명령을 실행하고 그 출력을 Claude의 컨텍스트에 주입하는 것이다.

---
name: code-review
description: 현재 브랜치의 변경 사항을 리뷰한다
---

아래 변경 사항을 리뷰해주세요:

!`git diff HEAD`

또한 현재 테스트 상태:

!`npm test --silent 2>&1 | tail -20`

/code-review를 실행하면, Claude는 git diff HEAD의 실제 현재 출력과 테스트 결과를 컨텍스트에 받은 상태로 리뷰를 시작한다. 오래된 스니펫이 아닌 실제 현재 상태다.

이것이 CLAUDE.md의 정적 지시와 Skills의 근본적인 차이다 — Skills는 실행 시점의 실제 데이터를 컨텍스트에 포함할 수 있다.

쉘 스크립트 블록도 지원된다:

!```bash
echo '## 현재 브랜치:'
git branch --show-current
echo '## 변경된 파일:'
git diff --name-only HEAD

Claude Code에는 기본 내장 스킬들이 있다 — /code-review, /debug, /batch, /loop, /verify, /run. 이것들은 프롬프트 기반(고정 로직이 아닌 Claude의 지시)이며, 커스터마이즈할 수 없지만 참고할 수 있다.

disableBundledSkills: true 설정으로 번들 스킬을 비활성화할 수 있다 (팀 스킬과 충돌하는 경우).

실용적인 팀 스킬 예시:

# .claude/skills/pr/SKILL.md
---
name: pr
description: PR을 생성하고 팀 체크리스트를 적용한다
---

다음 단계로 PR을 생성해주세요:

현재 변경 사항:
!`git log main..HEAD --oneline`

1. PR 제목: [type]: [짧은 설명] (type: feat/fix/refactor/docs)
2. 체크리스트 확인:
   - [ ] 테스트 추가/업데이트 완료
   - [ ] 타입 체크 통과
   - [ ] 보안 취약점 검토
3. gh pr create 실행

팀이 이 스킬을 쓰면 모든 PR이 동일한 구조와 체크리스트를 가진다.