By name: "{name}" # 소문자·숫자·하이픈, 64자 이내. gerund form 권장 (예: creating-skills) description: "{3인칭·what+when·트리거 키워드 풍부히 — undertrigger 경향이 있으므로 약간 강하게 작성한다. 최대 1024자.}" argument-hint: "/{name} [인자]"
필요 시 추가:
when_to_use: 추가 트리거 구문 (description이 길어질 때 분리)
allowed-tools: 사전 승인 도구 목록 (공백 구분 또는 YAML 리스트)
model: 모델 오버라이드
effort: low | medium | high | xhigh | max
context: fork # 격리된 서브에이전트 컨텍스트
agent: Explore | Plan | general-purpose |
paths: src//*.ts, tests//* # 특정 파일 작업 시에만 자동 활성화
{Skill name}
언제 쓰나
{호출되어야 하는 시점·상황을 1~3 문장. description과 본문이 일관되어야 하고, 사용자나 라우터가 보고 즉시 분기 판단할 수 있어야 한다.}
절차
작업을 Step으로 나눈다. 한 Step은 한 결정 또는 한 실행 단위. 횡단 작업(탐색 · 위임 · 작성)은 explore · delegate · write 전용 스킬에 호출 위임한다 — 단일 소스 유지.
Step 1: 컨텍스트 수집
큰 컨텍스트(다중 파일 탐색 · 패턴 추적 · 외부 문서 조사)가 필요하면 explore 스킬을 호출한다. 단순 Read 한두 번이면 직접 수행한다.
Step 2: 핵심 실행
세 가지 패턴 중 하나로 진행한다.
- 직접 수행 — 도구를 직접 호출
- 위임 — 최상위 폴리시에 따라 위임이 더 적합한 태스크는 delegate 스킬을 사용해 위임한다
- 라우팅 — 사용자 입력 또는 조건에 따라 sub-skill을 호출한다 (라우터 스킬 패턴)
Step 3: 결과 작성·보고
이 스킬이 만든 결과의 종류를 한 줄로 명시한 뒤, 형식·저장·사용자 보고는 write 스킬을 호출한다. audience 분리(사람용 / 에이전트용)는 write 스킬이 강제한다.
제약·실패 모드 (필요할 때만)
이 스킬의 절대 규칙·결정 규칙·실패 모드를 인라인으로 둔다. 절차만으로 충분한 스킬은 이 섹션을 만들지 않는다. 전역 폴리시(AGENTS.md)와 중복되는 내용은 다시 적지 않는다 — 본문이 못 담는 합리화 패턴과 그 반박에 집중한다.
절대 규칙
- {규칙 1} — 왜: {이유}
- {규칙 2} — 왜: {이유}
결정 규칙 (조건부)
| 조건 | 행동 | 왜 |
|---|---|---|
| {조건} | {행동} | {이유} |
실패 모드
| 합리화 신호 | 현실 |
|---|---|
| "{흔한 변명}" | {실제로는 어떤지} |
보조 파일 (선택)
SKILL.md 외 자료를 둘 경우:
scripts/— 결정론적·반복 코드 (컨텍스트 미적재, 실행만)references/— 필요 시 로드되는 긴 컨텍스트 (각 파일 100줄 초과 시 목차 포함)assets/— 출력에 쓰이는 템플릿·아이콘 등