Skip to main content

​
Skills

Skills are markdown files that provide domain-specific knowledge to the AI. When a user asks about a topic covered by a skill, the AI reads the skill file to give an informed answer.

​
Defining skills

Add skills to your kazzle.config.ts: 
import { defineConfig } from './kazzle.types';

export default defineConfig({
  skills: [
    { name: 'API guide', path: './skills/api/SKILL.md' },
    { name: 'Data model', path: './skills/data-model/SKILL.md' }
  ]
});

​
Skill file format

Each skill is a markdown file (conventionally named SKILL.md) that contains instructions, examples, and context the AI should know. 
# API guide

This skill teaches the AI how to use the app's API.

## Endpoints

- `GET /items` — list all items
- `POST /items` — create an item

## Authentication

All requests require a Bearer token in the Authorization header.

​
How the AI uses skills

When the AI encounters a question related to an app that has skills, it reads the relevant skill files to ground its response. Skills are loaded on-demand — the AI doesn’t read all skills upfront. Skills are purely informational. They don’t execute code or trigger actions.