Claude Code 가이드 #11 — Skills 완벽 가이드

Skills란 무엇인가?

Skill 파일 구조 — frontmatter 완전 해설

기본 Skill 파일 구조 (.md)
---
name: commit
description: 스테이징된 변경사항을 분석해 커밋 메시지를 생성하고 커밋합니다
trigger: user-invoked
args:
  - name: message
    description: 커밋 메시지 힌트 (선택사항)
    required: false
---

# 커밋 생성

스테이징된 변경사항(`git diff --staged`)을 읽고 다음을 수행합니다:

1. 변경된 파일 목록과 내용을 분석합니다
2. 변경 목적에 맞는 커밋 메시지를 작성합니다
3. 형식: `[type]: description` (type: feat, fix, docs, refactor, test, chore)
4. `git commit -m "..."` 으로 커밋합니다

{{#if message}}
사용자 힌트: {{message}}
{{/if}}

user-invoked vs auto — 두 가지 트리거 모드

auto 트리거 Skill 예시 — 파일 저장 시 자동 lint
---
name: auto-lint
description: JS/TS 파일이 수정될 때 자동으로 lint를 실행합니다
trigger: auto
when: 사용자가 JavaScript 또는 TypeScript 파일을 수정할 때
---

# 자동 Lint 실행

수정된 JS/TS 파일에 대해 다음을 실행합니다:

```bash
npx eslint {{modified_files}} --fix
```

lint 결과에서 자동 수정 불가 에러가 있으면 사용자에게 보고합니다.

커스텀 Skill 만들기 — 단계별 실습

Step 1 — Skill 파일 생성
# 프로젝트 전용 skill 디렉토리 생성
mkdir -p .claude/skills

# skill 파일 생성
touch .claude/skills/review-pr.md

Step 2 — review-pr.md 내용 작성
---
name: review-pr
description: 현재 브랜치의 변경사항을 main과 비교해 코드 리뷰를 수행합니다
trigger: user-invoked
args:
  - name: focus
    description: 리뷰 집중 영역 (예: security, performance, style)
    required: false
---

# PR 코드 리뷰

다음 순서로 코드 리뷰를 수행합니다:

1. `git diff main...HEAD` 로 변경사항 확인
2. 변경된 파일 목록과 라인 수 요약
3. 아래 항목으로 리뷰:
   - 버그 가능성 (로직 오류, 엣지 케이스)
   - 보안 취약점 (SQL injection, XSS, 인증 누락)
   - 성능 이슈 (불필요한 루프, N+1 쿼리)
   - 코드 품질 (중복 코드, 명명 규칙)
4. 이슈는 심각도별로 분류: CRITICAL / WARNING / SUGGESTION

{{#if focus}}
특히 {{focus}} 영역에 집중해서 리뷰합니다.
{{/if}}

실전에서 바로 쓰는 Skill 예시 모음

post.md — 포스팅 초안 생성 Skill
---
name: post
description: 주제를 받아 포스팅 초안을 생성합니다
trigger: user-invoked
args:
  - name: topic
    description: 포스팅 주제
    required: true
  - name: id
    description: 포스트 ID (예: 3051)
    required: true
---

# 포스팅 초안 생성

1. `data/posts.js` 의 기존 포스트 구조를 참고합니다
2. `CLAUDE.md` 의 포스트 구조 표준을 따릅니다
3. `posts/{{id}}.js` 파일을 생성합니다
4. `data/posts.js` 에 메타데이터를 추가합니다

주제: {{topic}}
포스트 ID: {{id}}

update-sitemap.md — 사이트맵 자동 갱신 Skill
---
name: update-sitemap
description: posts.js 기준으로 sitemap.xml을 재생성합니다
trigger: user-invoked
---

# 사이트맵 갱신

다음 명령을 실행합니다:

```bash
node scripts/generate-sitemap.js
```

완료 후 `public/sitemap.xml` 파일이 갱신됐는지 확인하고,
최종 URL 수를 보고합니다.

Skills vs CLAUDE.md — 무엇을 어디에 쓸까?

Skills + Hooks 조합 — 더 강력한 자동화

Skills 트러블슈팅

요약 및 관련 편