Skills & Hooks

Skills (스킬) 마스터하기

스킬이란?

스킬 파일 위치와 구조

~/.claude/skills/         # 전역 스킬 (모든 프로젝트)
.claude/skills/           # 프로젝트 스킬 (Git 공유 가능)
/skills                   # 사용 가능한 스킬 목록 보기

스킬 파일은 YAML 프런트매터 + 마크다운 본문:

---
name: cafe24-order-cleaner
description: 카페24 스토어의 주문 데이터를 정리합니다. 카페24 엑셀 정리가 필요할 때 사용하세요.
---
# 카페24 주문 데이터 정리
1. input 폴더의 카페24 주문 엑셀 읽기
2. 불필요한 칼럼 제거 (카페24 기본 내보내기에 포함된 시스템 칼럼 등)
3. 칼럼명 한글 통일 (영문/영문+한글 혼합 → 한글)
4. SKU별 주문수/매출/평균단가 요약 시트 추가
5. 기간별(일/주/월) 집계 시트 추가
6. output 폴더에 정리된 엑셀 저장

실전 스킬 3가지

---
name: weekly-brand-report
description: 주간 브랜드별 매출 리포트를 생성합니다. 매주 월요일 리포트 정리할 때 사용하세요.
---
# 주간 브랜드 리포트
1. 브랜드별 주간 매출 집계 (8개 브랜드)
2. 전주 대비 증감률 계산
3. 채널별 매출 비중 (자사몰/쿠팡/네이버/기타)
4. Top 10 SKU 랭킹
5. 특이사항 (전주 대비 30% 이상 증감 SKU 자동 추출)
6. 마크다운 + 엑셀 두 형태로 output/ 저장

---
name: competitor-monitor
description: 경쟁사 가격/프로모션 데이터를 정리합니다. 경쟁사 분석이 필요할 때 사용하세요.
---
# 경쟁사 모니터링
1. 경쟁사 제품별 가격 추출 (스크린샷 또는 엑셀)
2. 우리 제품과 1:1 매칭 (유사 카테고리 기준)
3. 가격 차이 계산, 프로모션 정보 정리
4. "우리가 비싼 제품 / 우리가 싼 제품" 분류
5. output/ 에 비교 테이블 엑셀 저장

스킬 vs CLAUDE.md vs 서브에이전트

판단 기준: "매번 같은 패턴" -> 스킬 / "항상 적용할 규칙" -> CLAUDE.md / "병렬 처리" -> 서브에이전트

Hooks (훅) 활용하기

훅이란?

주요 훅 이벤트

실전 설정 예시 3가지

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code 확인 필요\" with title \"Claude Code\" sound name \"Ping\"'"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "write|edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

먼저 .claude/hooks/protect-files.sh 스크립트를 만듭니다:

#!/bin/bash
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

# 보호할 파일 패턴
PROTECTED=(".env" ".env.local" "package-lock.json" "yarn.lock")

for pattern in "${PROTECTED[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "BLOCKED: $FILE_PATH 는 수동으로만 편집하세요" >&2
    exit 2
  fi
done
exit 0

그리고 settings.json에 훅을 등록합니다:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/protect-files.sh"
          }
        ]
      }
    ]
  }
}

exit 2로 종료하면 해당 도구 실행이 차단되고, stderr 메시지가 Claude에게 피드백됩니다. "이 파일 수정하지 마"라고 말하는 것보다 확실합니다.

설정 파일 위치와 우선순위

우선순위: 프로젝트 로컬 > 프로젝트 공유 > 전역.

Prompt 기반 훅과 Agent 기반 훅

{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "prompt",
        "prompt": "사용자가 요청한 모든 작업이 완료되었는지 확인하세요. 미완료 항목이 있으면 계속 진행하세요."
      }]
    }]
  }
}

{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "agent",
        "prompt": "npm test를 실행하고 모든 테스트가 통과하는지 확인하세요. 실패하면 수정하세요."
      }]
    }]
  }
}

prompt는 AI가 판단만, agent는 서브에이전트가 실제 도구를 실행하여 검증합니다.