Skip to main content

스킬

스킬은 AI가 앱에 대해 알고 할 수 있는 일을 알려주는 폴더입니다. 다음을 포함합니다:
  • SKILL.md — AI가 읽는 지침 (필수).
  • tools.ts — AI가 호출할 수 있는 도구 목록 (선택사항).
SKILL.md는 앱과 그 도구를 설명하고, tools.ts는 도구를 선언하며, 각 도구는 앱의 컴포넌트 중 하나의 HTTP 경로로 구현됩니다.

스킬 정의하기

kazzle.config.ts에서 각 스킬의 SKILL.md를 가리킵니다. Kazzle은 폴더를 사용하므로 옆에 있는 tools.ts가 자동으로 선택됩니다.

SKILL.md

프론트매터가 있는 마크다운, 그 다음 AI가 따라야 할 지침입니다.

tools.ts

SKILL.md 옆의 tools.ts는 그 스킬이 호출할 수 있는 도구를 선언합니다. 전체 도구 계약 — 선언 타입, 핸들러 요청/응답 형태, content vs markdown 결과 채널 — 은 Tools에 있습니다.

AI가 스킬을 사용하는 방식

AI는 답변을 근거 있게 하기 위해 필요에 따라 SKILL.md를 읽고 (모든 스킬을 미리 읽지 않음), tools.ts에 선언된 도구를 호출할 수 있습니다. 일치하는 경로가 없는 도구는 작동하지 않으므로 둘 다 함께 추가하세요. tools.json은 지원되지 않습니다.