Skip to main content
A skill is a directory bundle holding domain knowledge the assistant applies passively: conventions, checklists, best practices. Skills follow the Agent Skills specification. Each skill lives at skills/<name>/SKILL.md and is declared in facet.json under skills. Placement and descriptor rules live at Text assets.

Example

skills/code-review/SKILL.md

Companion files

A skill can ship more than its SKILL.md. Declare companion files in the descriptor’s files array, as paths relative to the skill directory:
facet.json
Companions install and remove atomically with the skill. Files you add to a skill directory yourself are left in place on removal. A companion cannot be SKILL.md. See Supplementary files.

When to use skills

Use a skill for knowledge the assistant should always have: coding standards, review checklists, domain guidelines, framework practices. Use an agent to define a persona. Use a command for something the user invokes.

Further reading