클로드 스킬
Skill이란?
특정 작업에 대한 매뉴얼로, 반복적으로 수행해야하는 작업에 대한 프롬프트를 재사용할 수 있도록 만든 문서이다.
스킬의 작동 원리
클로드는 대화 시작 시 모든 스킬의 Frontmatter(스킬의 메타데이터)를 읽는다.
사용자의 요청과 관련된 스킬을 발견하면, 해당 스킬의 본문을 로딩(점진적 로딩)한다. 실제 작업이 필요할 때 동적으로 상세 지침과 관련 스크립트를 읽어들여 컨텍스트 윈도우를 효율적으로 관리한다.
스킬 정의
스킬 저장 위치
스킬 사용 범위에 따라 스킬 파일의 위치를 달리한다.
- 모든 프로젝트
~/.claude/skills/스킬 이름/SKILL.md - 특정 프로젝트
./claude/skills/스킬 이름/SKILL.md - 플러그인
/플러그인/skills/스킬 이름/SKILL.md
플러그인 활성화 시 적용된다.
위와 같은 순서로 탐색 순서 우선순위가 높다.
스킬의 구조
SKILL.md 파일은 스킬의 frontmatter와 본문으로 나뉜다.
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---
# My Skill Name
[Add your instructions here that Claude will follow when this skill is active]
## Examples
- Example usage 1
- Example usage 2
## Guidelines
- Guideline 1
- Guideline 21. Frontmatter
SKILL.md 파일 상단의 --- 마커 사이의 YAML frontmatter 필드를 사용하여 스킬을 설명한다.
해당 내용을 통해 클로드는 사용자의 요청와 관련된 스킬인지를 판별해낸다.
---
name: my-skill
description: What this skill does
disable-model-invocation: true
allowed-tools: Read Grep
---다음 필드로 구성될 수 있다.
필수 필드
| 필드 | 설명 |
|---|---|
name | 스킬 식별자. 소문자·숫자·하이픈만 허용, 최대 64자 |
description | 최대 1024자, XML 태그 불가. Claude가 스킬을 언제 쓸지 판단하는 핵심 트리거 |
호출 제어 필드
| 필드 | 설명 |
|---|---|
disable-model-invocation | true로 설정 시 Claude가 자동으로 호출하지 않고, 사용자가 /skill-name으로만 실행 가능. /commit, /deploy 같은 사이드 이펙트가 있는 워크플로우에 적합 |
user-invocable | false로 설정 시 Claude만 호출 가능. 사용자가 커맨드로 쓸 필요 없는 백그라운드 지식성 스킬에 적합 |
도구 및 실행 제어 필드
| 필드 | 설명 |
|---|---|
allowed-tools | 스킬 실행 중 사용할 수 있는 도구 화이트리스트. 예: Read Grep |
model | 이 스킬에서 사용할 Claude 모델 오버라이드 |
effort | 확장 사고(extended thinking)의 노력 수준 힌트 (low / medium / high) |
shell | 인라인 커맨드의 기본 셸 지정 (예: bash, zsh) |
슬래시 커맨드 관련 필드
| 필드 | 설명 |
|---|---|
argument-hint | 슬래시 커맨드로 호출할 때 사용자에게 보여주는 플레이스홀더 텍스트 |
arguments | 슬래시 커맨드 인수의 구조화된 스키마 정의 |
기타 선택 필드
| 필드 | 설명 |
|---|---|
when_to_use | 트리거 조건을 구체적으로 기술. 코드베이스에는 광범위하게 등장하지만 공식 문서에는 없는 비공식 필드 |
context | 스킬 실행 시 함께 로드할 추가 컨텍스트 파일 |
paths | 스킬이 동작할 파일 대상의 Glob 패턴 |
hooks | 스킬 실행 전/후에 실행할 셸 커맨드 |
dependencies | 스킬에 필요한 소프트웨어 패키지 |
compatibility | 플랫폼별 호환성 정보 |
2. 본문
클로드가 수행할 작업에 대한 구체적인 단계 및 지침을 마크다운 형식으로 작성한다.
예를 들어 블로그 포스트를 작성하는 스킬을 작성한다고 하자. 그럼 다음과 같이 안내할 수 있을 것이다.
---
# Frontmatter
name: blog-post
description: This skill should be used when the user wants to write or organize a Korean tech blog post. Use when the user says "블로그 글 써줘", "포스트 정리해줘", "공부한 거 글로 써줘", or wants to document something they learned. Follows the user's personal blog style — factual, modest, first-person, learning-oriented rather than tutorial-oriented.
allowed-tools: Read Write
---
# 블로그 포스트 정리 스킬
학습 내용을 개인 기술 블로그 포스트로 정리하는 스킬입니다.
## 글쓰기 원칙
- **어조**: 독자에게 가르치는 게 아니라 내가 배운 것을 기록하는 느낌
- **사실/추론 구분**: 확실하지 않은 내용은 "~인 것 같다", "~로 이해했다" 등으로 명시
- **과장 금지**: "완벽하게 이해했다", "이것만 알면 된다" 같은 표현 사용 안 함
- **길이**: 핵심만. 불필요한 도입부나 마무리 인사 없음
## 포스트 구조
1. 제목
2. 배경/계기
3. 핵심 개념
4. 내가 헷갈렸던 부분 (선택)
5. 참고
스킬을 잘 활용하는 법
스킬 생성
Anthropic에서 스킬을 생성을 위한 스킬 Skill Creator를 제공하고 있다.
클로드와의 대화를 통해 쉽게 SKILL.md 파일을 만들 수 있다.
이미 만들어진 스킬 사용하기
Anthropic 마켓플레이스에서 제공하는 공식적인 스킬들, 그 외의 여러 서비스에서 공식적으로 개발한 또는 커뮤니티에서 인정받은 스킬을 사용하는 것도 매우 유용한다.
Anthropic 마켓플레이스
사용 방법은 다음과 같다.
1. 마켓플레이스 추가
/plugin marketplace add anthropics/skills- 사용 가능한 스킬 목록 확인
/plugin2-1. Browse and install Plugins 선택 -> 플러그인 목록 확인 가능
- 스킬 설치
/plugin install example-skills@anthropic-agent-skills원하는 스킬 직접 찾기
검증된 스킬을 모아놓은 서비스나 자료를 잘 찾아보자.
