스킬은 작업 절차나 지식을 폴더에 정리해 두고 Claude Code가 필요할 때만 읽게 하는 구조다.
평소 컨텍스트에는 스킬의 이름과 설명만 들어 있다. 본문은 그 작업을 할 때 처음 읽힌다. 그래서 긴 절차나 참고 자료를 넣어도 안 쓰는 동안에는 부담이 거의 없다. 여기가 CLAUDE.md와 가장 다른 점이다.
스킬이 절약에 효과 있는 두 가지 이유
고정비가 준다
CLAUDE.md에서 특정 작업 절차를 옮기면 그만큼 매 요청에서 빠진다(3장).
탐색 변동비가 준다
예를 들어 "프로젝트 구성"을 스킬로 만들어 두면 Claude Code가 파일을 여기저기 읽으며 구성을 조사하는 대신 스킬 하나만 읽으면 끝난다. 공식 문서도 이 사용법을 절약 사례로 든다.
스킬 만드는 법
두는 곳은 두 군데다.
나만 쓴다: ~/.claude/skills/<스킬명>/SKILL.md
팀과 공유한다: 리포지터리의 .claude/skills/<스킬명>/SKILL.md
SKILL.md에는 맨 위에 이름과 설명, 그 아래에 본문을 쓴다.
---
name: release
description: 이 프로젝트의 릴리스 절차. 버전을 올리거나, 릴리스하거나, 태그를 찍을 때 사용
---
# 릴리스 절차
1. `pnpm test`가 전부 통과하는지 확인한다
2. `package.json`의 version을 올린다
3. CHANGELOG.md에 변경 사항을 추가한다
4. `git tag v<버전>`을 찍고 push한다