ilhae.ai

CHAPTER 05 / 10

4. 스킬로 분리: 필요할 때만 읽히기

『Claude Code 사용 한도 절약법: 토큰 줄이는 설정과 습관 정리』 · 김재우 · 2026년 11월 8일

스킬은 작업 절차나 지식을 폴더에 정리해 두고 Claude Code가 필요할 때만 읽게 하는 구조다. 이 장에서 다루는 것: 스킬이 절약에 효과 있는 두 가지 이유 · 스킬 만드는 법 · 가장 중요한 건 description · 절약에 효과 있는 스킬 예시 · 확인하기

미리 읽기

스킬은 작업 절차나 지식을 폴더에 정리해 두고 Claude Code가 필요할 때만 읽게 하는 구조다.

평소 컨텍스트에는 스킬의 이름과 설명만 들어 있다. 본문은 그 작업을 할 때 처음 읽힌다. 그래서 긴 절차나 참고 자료를 넣어도 안 쓰는 동안에는 부담이 거의 없다. 여기가 CLAUDE.md와 가장 다른 점이다.

스킬이 절약에 효과 있는 두 가지 이유

  1. 고정비가 준다 CLAUDE.md에서 특정 작업 절차를 옮기면 그만큼 매 요청에서 빠진다(3장).
  2. 탐색 변동비가 준다 예를 들어 "프로젝트 구성"을 스킬로 만들어 두면 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한다

이 장의 나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.

이어서 읽기

이 장에서 다루는 것

  1. 스킬이 절약에 효과 있는 두 가지 이유
  2. 스킬 만드는 법
  3. 가장 중요한 건 description
  4. 절약에 효과 있는 스킬 예시
  5. 확인하기

ilhae.ai 안내 도우미대기 중

글자를 치면 사이트 자료를 바로 찾아요. AI 대화는 하루 20번까지이고, 질문 앞부분은 서비스 개선을 위해 30일 보관해요. 개인정보는 적지 마세요.