SKILL.md 형식

SKILL.md는 AI에게 스킬의 사용법을 가르치는 지시서입니다. 잘 작성된 SKILL.md = 잘 동작하는 스킬입니다.

권장 구조

# [스킬 이름]

## 목적
[한 문장으로 스킬의 역할 설명]

## 사용 시점
[언제 이 스킬을 사용해야 하는지]

## 사용법
[사용자가 어떻게 트리거하는지]

## 도구 / 명령어
[사용하는 외부 도구나 API]

## 설정
[필요한 설정 정보]

## 규칙
[AI가 따라야 할 규칙]

## 예시
[입출력 예시]

좋은 SKILL.md의 특징

명확한 트리거

어떤 사용자 요청에 반응해야 하는지 명확합니다.

구체적 예시

입력과 예상 출력의 예시가 포함됩니다.

에러 처리

실패 시 어떻게 행동해야 하는지 정의합니다.

간결함

필요한 정보만 담아 토큰을 절약합니다.

안티패턴

피해야 할 SKILL.md 패턴:

❌ 너무 긴 설명 (500줄+) → AI가 핵심을 놓침
❌ 모호한 트리거 → 엉뚱한 상황에서 활성화
❌ 예시 없음 → AI가 출력 형식을 추측
❌ 설정 누락 → 설치 후 동작하지 않음

TOOLS.md와의 관계

SKILL.md	TOOLS.md
스킬의 기능과 사용법	로컬 환경 설정
공유 가능 (범용)	개인 환경 (비공개)
“이 도구는 이렇게 사용해"	"내 API 키는 xxx, 내 카메라 이름은 yyy”

# SKILL.md (공유됨)
## 설정
TOOLS.md에 API 키를 추가하세요.

# TOOLS.md (개인)
### Weather
- API Key: abc123
- Location: Seoul

스킬은 공유, 환경은 개인. 이 분리를 유지하면 스킬을 안전하게 공유할 수 있습니다.

Part 5: 스킬 생태계

Part 6: 자동화

권장 구조

좋은 SKILL.md의 특징

명확한 트리거

구체적 예시

에러 처리

간결함

안티패턴

TOOLS.md와의 관계

​권장 구조

​좋은 SKILL.md의 특징

명확한 트리거

구체적 예시

에러 처리

간결함

​안티패턴

​TOOLS.md와의 관계

권장 구조

좋은 SKILL.md의 특징

안티패턴

TOOLS.md와의 관계