[Claude Code 입문 E24] Claude Code Skills 입문: SKILL.md 구조와 호출 방식, 번들 스킬 정리

Claude Code Skills의 개념과 기본 사용법을 정리합니다. CLAUDE.md/rules와 달리 호출됐을 때만 본문이 컨텍스트에 들어오는 on-demand 워크플로 패키지가 Skill입니다. SKILL.md 디렉토리 구조와 frontmatter 옵션, progressive disclosure 3단계, 직접 호출과 Claude 자동 호출, 4계층 위치와 우선순위, 번들 스킬과 built-in command 차이까지 다룹니다. 📌 다루는 내용 - Skills란: CLAUDE.md(매 세션)/path-scoped rule(매칭 파일)과 다른 on-demand 로드 모델 - Progressive disclosure 3단계: Discovery(name+description) → Activation(본문 로드) → Execution - SKILL.md 구조: name, description, when_to_use, argument-hint, allowed-tools, context: fork 등 frontmatter 필드와 1,536자 description 캡 - 위치 4계층: Enterprise / Personal(~/.claude/skills/) / Project(.claude/skills/) / Plugin과 우선순위, --add-dir 자동 로드, 모노레포 nested discovery - 호출 두 경로: 사용자가 /직접 호출, Claude가 description 매칭으로 자동 호출 - 호출 주체 제어: disable-model-invocation(수동만)과 user-invocable(Claude만) - 인수 전달: $ARGUMENTS, $ARGUMENTS[N], $N과 따옴표 묶기 - 도구 사전 승인 allowed-tools와 ! 문법으로 동적 컨텍스트 주입 - context: fork + agent: Explore로 서브에이전트 격리 실행 - 번들 스킬: /simplify, /batch, /debug, /loop, /claude-api, /fewer-permission-prompts - 번들 스킬 vs built-in command, /skills 목록 확인, compaction 동작(스킬당 5,000토큰 / 전체 25,000토큰) - Agent Skills 오픈 표준과 Plugin으로 배포 📌 환경 정보 - Claude Code 최신 버전 (Skills와 SKILL.md 지원) - claude --version으로 버전 확인 - .claude/skills/ 또는 ~/.claude/skills/ 디렉토리 사용 📌 챕터 0:00 Skills를 왜 쓰는가: CLAUDE.md/rules와의 차이 2:07 Progressive disclosure 3단계 3:07 SKILL.md 구조와 frontmatter 필드 4:47 위치 4계층과 우선순위, 모노레포 패턴 6:32 호출 두 경로: 직접 vs Claude 자동 7:17 호출 주체 제어: disable-model-invocation, user-invocable 8:33 인수 전달과 allowed-tools 사전 승인 10:10 ! 문법으로 동적 컨텍스트 주입 11:05 context: fork로 서브에이전트 격리 실행 12:29 번들 스킬과 built-in command 차이 13:31 /skills 목록과 compaction, 정리 📌 참고 링크 - 블로그: https://neosarchizo.github.io/posts/claude-code-24-skills-introduction - Extend Claude with skills: https://code.claude.com/docs/en/skills - Commands reference: https://code.claude.com/docs/en/commands - Subagents: https://code.claude.com/docs/en/sub-agents - Permissions: https://code.claude.com/docs/en/permissions - Plugins: https://code.claude.com/docs/en/plugins - Agent Skills 표준: https://agentskills.io #ClaudeCode #ClaudeSkills #SKILLmd