SKILL.md Frontmatter 14 필드 (description · disable-model-invocation · context: fork 등)
Term (용어)aidraftTue May 12

SKILL.md Frontmatter 14 필드 (description · disable-model-invocation · context: fork 등)

별칭: SKILL.md frontmatter · skill 메타데이터 · skill yaml

#skills#frontmatter#yaml#claude-code#lazy-load

정의

Skills (.claude/skills/<name>/SKILL.md) 의 YAML frontmatter 에 들어가는 14 개 선택 필드. name + description 만 권장 (실제 필수는 아님, 디렉토리 이름이 기본).

핵심 필드 표

필드역할
name표시 이름 (생략 시 디렉토리 이름). 소문자·숫자·하이픈, 최대 64 자
description★ Claude 가 언제 자동 호출 할지 결정. 주요 사용 사례를 앞에. 1536 자 잘림
when_to_use추가 트리거 컨텍스트
disable-model-invocationtrue → Claude 자동 호출 ❌, 사용자 수동 (/name) 만. 부작용 워크플로우 (/commit·/deploy) 권장
user-invocablefalse → / 메뉴에서 숨김. Claude 만 호출 (배경 지식용)
allowed-tools사전 승인 도구
modelsonnet / opus / haiku / 전체 ID / inherit
effortlow / medium / high / xhigh / max
contextfork 설정 시 subagent 격리 실행
agentcontext: fork 시 subagent 유형 (Explore / Plan / general / 사용자 정의)
hooksskill 라이프사이클 hooks (PreToolUse 등)
pathsGlob 패턴 — 일치 파일 작업 시만 활성
shellbash (기본) / powershell
arguments명명 위치 인수 ($name 치환)
argument-hint자동 완성 힌트

★ 호출 제어 매트릭스

Frontmatter사용자Claude컨텍스트
(기본)✅✅description 항상 + 호출 시 전체
disable-model-invocation: true✅❌description 없음 + 사용자 호출 시 전체
user-invocable: false❌✅description 항상 + 호출 시 전체

★ 문자열 치환

  • $ARGUMENTS — 모든 인수
  • $ARGUMENTS[N] / $N — 0 기반 인덱스 인수
  • $name — 명명 인수
  • ${CLAUDE_SESSION_ID} / ${CLAUDE_EFFORT} / ${CLAUDE_SKILL_DIR}

강의 활용

  • Ch6 §6.4 — 4 층 인프라의 Skills 절. 필요 시 로드 = CLAUDE.md 항상 로드 와 대비.
  • Ch7 — Karpathy 의 65 줄 CLAUDE.md 를 Skill 로 변환 가능성 트레이드오프 토론.