Skills

A skill provides reference documentation for a specific tool or service. Skills are used by tasks to accomplish their goals. Each skill lives in its own directory under skills/ and is defined by a SKILL.md file.

File Structure

skills/
  <skill-name>/
    SKILL.md

SKILL.md Format

A skill file has two parts: frontmatter (YAML metadata) and body (Markdown documentation).

Frontmatter

---
name: skill-name
description: What this skill does and when to use it.
---

Fields

Field	Type	Required	Description
`name`	string	yes	Identifier for the skill.
`description`	string	yes	What the skill does and when to use it. Should include trigger phrases (e.g., "Use when the user wants to...").

Body

The body contains reference documentation for the tool or service. The structure varies depending on the type of skill, but typically includes:

Title — # Skill Name
Overview — What the tool is and how it works.
Usage — How to invoke the tool (endpoints, CLI synopsis, etc.).
Parameters/Options — Detailed reference tables.
Examples — Common usage patterns and recipes.
Source — Links to official documentation and repositories.

Existing Skills

Skill	Type	Description
`whisper.cpp`	HTTP API	Speech-to-text transcription via a local whisper.cpp server.
`ffmpeg`	CLI	Audio/video processing, conversion, and analysis.

1.5 KiB Raw Blame History