Skip to main content

Writing skills

Skill Structure

A skill is a directory with a SKILL.md file. Everything else is freeform.

SKILL.md Format

Use relative file paths from the skill directory (these are bundled skill files, not docs routes):
Keep authored instructions outcome-first and concise. State observable completion and stop conditions, give a short reason for material constraints, and use decision rules for judgment calls instead of ALWAYS/NEVER language. Put detailed or model-specific material in references/ so it loads only when needed. Do not ask models to reproduce private reasoning or repeatedly verify their own work; require evidence or validation results where correctness matters.

Example

SKILL.md:

Next steps

Check the skill reference for frontmatter fields and validation rules before sharing your skill.