스킬 크리에이터

스킬은 Claude의 능력을 확장하는 모듈식 패키지입니다. "특정 영역에 대한 온보딩 가이드"처럼 작동합니다.

스킬 구조

.claude/skills/
├── {category}/              # 카테고리 (write, export, data, util)
│   └── {skill-name}/
│       ├── SKILL.md         # 필수: 스킬 정의
│       ├── scripts/         # 선택: 실행 스크립트
│       ├── references/      # 선택: 참고 자료
│       └── assets/          # 선택: 템플릿

SKILL.md 필수 형식

---
name: skill-name           # 영문 소문자, 하이픈
description: 스킬 설명     # "사용 시점"을 명확히 포함
---

본문 구성:

1. 개요 (1-3줄): 스킬의 핵심 목적
2. 사용법 (실행 단계): Step 1, 2, 3...
3. 입출력: 입력 데이터, 출력 파일
4. 체크리스트: 완성도 검증 항목
5. 관련 스킬: 연관 스킬 링크

작성 원칙 (3가지)

1. 간결함 (Conciseness)

"문맥 윈도우는 공공재" - Claude가 이미 아는 내용은 제외

제한: SKILL.md 500줄 이하

2. 적절한 자유도

3. 점진적 공개

메타데이터 (항상 로드)
    ↓ 스킬 활성화 시
SKILL.md 본문
    ↓ 필요 시
번들 리소스 (scripts/, references/)

새 스킬 생성

Step 1: 카테고리 선택

Step 2: 디렉토리 생성

mkdir -p .claude/skills/{category}/{skill-name}

Step 3: SKILL.md 작성

---
name: {skill-name}
description: {스킬 설명 - 사용 시점 명시}
---

# {스킬 제목}

## 개요
{1-3줄 핵심 목적}

## 사용법
### Step 1: ...
### Step 2: ...

## 입출력
| 입력 | 출력 |
|------|------|

## 체크리스트
- [ ] 항목 1
- [ ] 항목 2

## 관련 스킬
- `/related-skill`: 설명

Step 4: README.md 업데이트

.claude/skills/README.md에 스킬 추가

Step 5: CLAUDE.md 업데이트

프로젝트 가이드에 스킬 추가

스킬 점검 체크리스트

메타데이터

• name: 영문 소문자, 하이픈 사용
• description: "사용 시점" 포함 (예: "~할 때 사용")
• description: 50자 이내 간결한 설명

본문 품질

• 500줄 이하
• 개요가 핵심 목적 명시
• Step-by-step 사용법 제공
• 입출력 명시
• 체크리스트 포함
• 관련 스킬 링크

작성 스타일

• 명령형/부정사형 사용 (예: "작성한다", "확인할 것")
• 중복 내용 제거
• Claude가 이미 아는 내용 제외
• 프로젝트 특화 정보만 포함

구조

• 카테고리 적절
• 파일명 일관성 (SKILL.md)
• README.md에 등록
• CLAUDE.md에 등록

스킬 보완 작업

문제 유형별 해결

분리 전략

SKILL.md (핵심 워크플로우)
    └── references/
        ├── detailed-guide.md   # 상세 가이드
        ├── examples.md         # 예시 모음
        └── troubleshoot.md     # 문제 해결

이 프로젝트 스킬 현황

카테고리별 스킬 수

주요 스킬

• /write-portfolio: 포트폴리오 작성 (Markdown)
• /export-pptx: 포트폴리오 PPTX 생성
• /jd-match: JD 분석 + 회사 조사
• /sync-all: 전체 동기화

관련 파일

• .claude/skills/README.md: 스킬 목록
• CLAUDE.md: 프로젝트 가이드