Skill (스킬)¶
한 줄 정의¶
자주 하는 작업을 마크다운 파일 하나에 저장해두고,
/명령어로 실행하는 것.
비유¶
레시피북. 요리사(Claude)에게 "이 레시피대로 만들어"라고 하는 것. 요리사는 자기 주방(현재 대화)에서 레시피를 보고 직접 요리한다.
핵심 특징¶
| 항목 | 내용 |
|---|---|
| 실행 주체 | 지금 대화 중인 Claude가 직접 실행 |
| 실행 환경 | 현재 대화 안에서 (맥락 공유) |
| 저장 형식 | .claude/skills/이름/SKILL.md (마크다운 파일) |
| 실행 방법 | /스킬이름 또는 Claude가 자동 판단 |
| 반복 사용 | O (한 번 만들면 계속 재사용) |
| 코딩 필요 | X (마크다운 자연어로 작성) |
파일 구조¶
.claude/skills/lecture-content/
├── SKILL.md ← 필수. 메인 지시문
├── references/ ← 선택. 참고 자료
│ └── tone-guide.md
└── scripts/ ← 선택. 실행할 스크립트
└── resize.py
SKILL.md 기본 형태¶
---
name: lecture-content # 스킬 이름 (/명령어)
description: > # Claude가 언제 이 스킬을 쓸지 판단하는 설명
강의 후 콘텐츠 자동화...
argument-hint: "[폴더 경로]" # 사용자에게 보여줄 입력 힌트
---
여기에 Claude가 따를 지시문을 자연어로 작성한다.
단계별로 뭘 해야 하는지, 결과물 형식은 어떤지 등.
주요 설정 옵션¶
| 옵션 | 의미 | 예시 |
|---|---|---|
name |
/명령어 이름 |
lecture-content → /lecture-content |
description |
스킬 설명 (Claude 자동 판단용) | "강의 후 콘텐츠 자동화..." |
argument-hint |
입력 힌트 | "[폴더 경로]" |
disable-model-invocation: true |
Claude 자동 실행 차단 | 위험한 작업에 사용 |
context: fork |
Sub-agent처럼 분리 실행 | 대량 조사 시 |
allowed-tools |
사용 가능 도구 제한 | Read, Grep, Glob (읽기만) |
실전 사용 예시¶
강의 콘텐츠 자동화¶
→ 사진 선별 → 글 작성 → 노션 업로드 → 인스타 문안유튜브 콘텐츠 재활용¶
→ 스크립트 분석 → 노션/블로그/인스타 콘텐츠 생성Skill이 최적인 경우¶
- 매주/매달 반복하는 작업
- 한 명의 Claude가 순서대로 하면 되는 작업
- 결과물 형식이 정해져 있는 작업
- 비개발자가 자동화하고 싶은 첫 번째 선택지
Skill이 부족한 경우¶
- 조사량이 너무 많아서 대화 맥락이 넘칠 때 → Sub-agent
- 여러 독립된 관점이 필요할 때 → Agent Team
- 일회성 파일/이미지 작업 → Cowork
참고¶
- 공식 문서
- Skill은 Claude Code의 가장 기본이자 가장 강력한 자동화 도구
- "잘 쓴 SKILL.md 하나 = 전문 팀원 하나"