Overview
Custom skills are the project's own instruction sets, loaded by agents on demand. Their sources live in skills/custom/<name>/SKILL.md. Each skill is a single file, linked below to its source.
| Skill | Use when |
|---|---|
app-rules |
Use when creating, changing, or reviewing an app in apps/*: layout, allowed dependencies, logic/UI separation, and checks. |
package-rules |
Use when creating, changing, or reviewing a workspace package in packages/*: layout, package.json rules, public API, and changesets. |
product-brief |
Use when writing or updating an app's product brief and backlog in docs/apps. Defines the brief layout and feature IDs. |
spec-format |
Use when writing, updating, or reviewing a spec in docs/specs. Defines the file layout and the requirement ID format. |
testing |
Use when writing, running, or reviewing tests: naming by requirement ID, test kinds per work item type, and what counts as weakening a test. |
work-items |
Use when creating or editing work item files in docs/work and their rows on docs/project/board.md. Defines file layout, header fields, and sections. |
workflow |
Use when running or planning a work item (W-NNN): item types, states, the flow per type, size limits, and invariants. The flow table is binding for the Orchestrator. |
Third-party skills are listed under Vendored skills.
Adding a skill¶
- Create
skills/custom/<name>/SKILL.mdwithnameanddescriptionin its frontmatter. Quote the description, since it usually contains colons. - Reference it from the agents that need it, and add a row to the table above.