SKILL.md 구조 이해하기
스킬 폴더 구성, SKILL.md 맨 위의 name·description, 본문 작성 요령, scripts·assets 같은 보조 파일을 정리했습니다.
업데이트
폴더 구성
스킬 하나는 폴더 하나입니다. 폴더 안에 SKILL.md가 반드시 있어야 합니다.
<slug>/
├── SKILL.md (필수) 이름·설명·지침
├── scripts/ (선택) 스킬이 사용할 스크립트
└── assets/ (선택) 템플릿, 예시 파일 등
SKILL.md 맨 위: name, description
---
name: price-compare
description: 상품 페이지 여러 곳의 가격·배송비를 확인해 표로 정리한다. 사용자가 "가격 비교해줘"라고 요청할 때 사용한다.
---
- name — 스킬 이름. 폴더 이름과 같게, 소문자·숫자·하이픈(-)으로 쓰는 것을 권장합니다.
- description — Aside가 "언제 이 스킬을 쓸지" 판단하는 근거입니다. 무엇을 하는지 + 언제 쓰는지를 함께 적으세요.
| 아쉬운 예 | 좋은 예 |
|---|---|
| 가격 비교 도우미 | 상품 페이지 여러 곳의 가격·배송비를 확인해 표로 정리한다. 사용자가 "가격 비교해줘"라고 요청할 때 사용한다. |
본문 작성 요령
--- 아래 본문에는 Aside가 따를 지침을 적습니다.
- 진행 순서를 번호로 적습니다.
- 하지 않을 것을 분명히 적습니다. 예: "로그인이나 결제는 하지 않는다."
- 정보가 부족하면 추측하지 말고 물어보라고 적습니다.
- 결과물 형식(표, 목록 등)을 예시로 보여 줍니다.
scripts, assets 같은 보조 파일
- 반복해서 쓰는 템플릿이나 예시는
assets/에, 스크립트는scripts/에 둘 수 있습니다. - 보조 파일은
SKILL.md본문에서 언제·어떻게 쓰는지 상대 경로로 언급해야 의미가 있습니다. 예: "결과는assets/report-template.md형식을 따른다." - 보조 파일이 실제로 어떻게 쓰이는지는 Aside에 설치해 직접 확인한 뒤 설명에 적어 주세요.
- 이 사이트의 설치 안내는 현재
SKILL.md단일 파일 스킬을 기준으로 합니다. 보조 파일이 있는 스킬은 상세 페이지에 별도 안내를 적습니다.