Skip to main content

Skills

Uma skill é uma pasta que diz à IA o que ela sabe e pode fazer com seu app. Ela tem:
  • SKILL.md — instruções que a IA lê (obrigatório).
  • tools.ts — uma lista de ferramentas que a IA pode chamar (opcional).
SKILL.md descreve o app e suas ferramentas; tools.ts declara as ferramentas; cada ferramenta é implementada por uma rota HTTP em um dos componentes do seu app.

Definindo skills

Aponte kazzle.config.ts para o SKILL.md de cada skill. Kazzle usa sua pasta, então tools.ts ao lado é detectado automaticamente.

SKILL.md

Markdown com frontmatter, depois instruções que a IA deve seguir.

tools.ts

tools.ts ao lado de um SKILL.md declara as ferramentas que essa skill pode chamar. O contrato completo da ferramenta — tipos de declaração, a forma de requisição/resposta do handler e os canais de resultado content vs markdown — está em Tools.

Como a IA usa skills

A IA lê SKILL.md sob demanda (não todas as skills antecipadamente) para fundamentar suas respostas e pode chamar as ferramentas declaradas em tools.ts. Uma ferramenta sem rota correspondente não faz nada; adicione ambas juntas. tools.json não é suportado.