도메인 지식과 컨텍스트

Skill을 잘 만들려면 무엇을 어떤 형태로 담을지 판단해야 합니다.

세 가지 담는 형태

판단이 필요하면 문서로, 기계적이면 스크립트로. 이 기준 하나면 대부분 정리됩니다.

문서로 담을 때 — 절차로 쓰기

설명문이 아니라 따라 할 수 있는 순서로 쓰세요.

나쁨

이 리포트는 매출 데이터를 기반으로 작성되며 
지역별 분석이 중요합니다.

좋음

1. data/sales/YYYY-MM.csv 를 읽는다
2. region 컬럼으로 그룹핑해 합계를 낸다
3. 전월 파일과 비교해 증감률을 계산한다
4. 증감률 절댓값이 20%를 넘으면 별도 코멘트를 단다

예외 처리를 명시하기

실무에서 결과가 어긋나는 대부분의 이유는 예외 상황을 안 적어서입니다.

## 예외 상황

- 해당 월 데이터가 없으면: 사용자에게 알리고 중단한다. 추정하지 않는다.
- 전월 데이터가 없으면: 증감률 칸을 "-"로 표기한다.
- 매출이 0인 지역: 행을 제외하지 말고 0으로 표기한다.

하지 말 것을 적기

지시보다 금지가 결과를 더 크게 바꾸는 경우가 많습니다.

## 금지 사항

- 원본 CSV를 수정하지 마라
- 데이터가 부족해도 추정치로 채우지 마라
- 요약을 5줄 이상 쓰지 마라

description이 전부다

본문이 아무리 좋아도 발동하지 않으면 없는 것과 같습니다. description에는 사용자가 실제로 쓸 표현을 넣으세요.

# 부족함
description: 리포트를 생성한다

# 충분함
description: 월간 매출 데이터를 사내 표준 PDF 리포트로 변환한다.
  "월간 리포트", "매출 정리해줘", "월말 보고서", "이번 달 실적"
  같은 요청에서 사용한다.

크기 관리

SKILL.md 본문이 길어지면 참조 파일로 나누세요.

SKILL.md              ← 절차 개요 (짧게)
references/rules.md   ← 상세 규칙 (필요할 때만 읽음)
references/glossary.md

본문에서는 "상세 규칙은 references/rules.md를 읽어라"라고 안내하면 됩니다.

검증하기

만든 Skill이 실제로 동작하는지 확인하는 방법:

1. 발동 테스트 — 자연스러운 표현으로 요청했을 때 불리는가
2. 결과 테스트 — 여러 번 실행했을 때 형식이 일관되는가
3. 예외 테스트 — 데이터가 없을 때 지시대로 멈추는가

다음 레슨

셋업과 기본 조작