Skip to content

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

  1. Create skills/custom/<name>/SKILL.md with name and description in its frontmatter. Quote the description, since it usually contains colons.
  2. Reference it from the agents that need it, and add a row to the table above.