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가 따를 지침을 적습니다.

  1. 진행 순서를 번호로 적습니다.
  2. 하지 않을 것을 분명히 적습니다. 예: "로그인이나 결제는 하지 않는다."
  3. 정보가 부족하면 추측하지 말고 물어보라고 적습니다.
  4. 결과물 형식(표, 목록 등)을 예시로 보여 줍니다.

scripts, assets 같은 보조 파일

  • 반복해서 쓰는 템플릿이나 예시는 assets/에, 스크립트는 scripts/에 둘 수 있습니다.
  • 보조 파일은 SKILL.md 본문에서 언제·어떻게 쓰는지 상대 경로로 언급해야 의미가 있습니다. 예: "결과는 assets/report-template.md 형식을 따른다."
  • 보조 파일이 실제로 어떻게 쓰이는지는 Aside에 설치해 직접 확인한 뒤 설명에 적어 주세요.
  • 이 사이트의 설치 안내는 현재 SKILL.md 단일 파일 스킬을 기준으로 합니다. 보조 파일이 있는 스킬은 상세 페이지에 별도 안내를 적습니다.

다음 가이드: 나만의 스킬 만들기 →