Project skill available across all modes in this repo ./.roo/skills/<skill-name>/SKILL.md Project skill available only in a specific mode ./.roo/skills-<mode>/<skill-name>/SKILL.md Global skill available across all workspaces <home>/.roo/skills/<skill-name>/SKILL.md Global skill available only in a specific mode <home>/.roo/skills-<mode>/<skill-name>/SKILL.md Default to keeping essential workflow instructions in SKILL.md. Add additional files only when they materially improve navigation, reuse, or verification. Optional deep dives (APIs, schemas, checklists, edge cases) Link directly from SKILL.md; avoid multi-hop references. Deterministic validation or automation (prefer execute-first workflows) SKILL.md must state whether to execute the script or read it as reference. Reusable templates and example artifacts Do not assume linked file contents unless they have been explicitly read. Prefer reading the minimum necessary linked file(s) for the current task. Use forward slashes in paths (e.g., references/guide.md) for cross-platform compatibility. When the same skill name exists in multiple locations, prefer the highest-precedence one. Project mode-specific: ./.roo/skills-<mode>/<skill-name>/ Project generic: ./.roo/skills/<skill-name>/ Global mode-specific: <home>/.roo/skills-<mode>/<skill-name>/ Global generic: <home>/.roo/skills/<skill-name>/ SKILL.md must start with YAML frontmatter including name and description.

Title (matches intent; human-readable)

When to use this skill

When NOT to use this skill

Inputs required from the user

Workflow (numbered)

Examples (minimal, realistic)

Troubleshooting / edge cases

1–64 characters Lowercase letters, numbers, and hyphens only No leading or trailing hyphen No consecutive hyphens Must match the directory name exactly Non-empty after trimming Max 1024 characters