Skill Writer

A skill in this repo is a self-contained directory under skills/skills/<name>/ with one entry-point file (SKILL.md) and any number of supporting docs alongside it. The harness loads SKILL.md's frontmatter to decide when to surface the skill; the body is what the agent reads when it triggers.

This skill is for writing those entries well: tight SKILL.md, deep material lifted into siblings.

When to use

• The user asks to author a new skill, or to refactor an existing one.
• A SKILL.md is growing past ~250 lines and needs to be split.
• You're about to add a large reference table, threshold list, full template, or worked example to a SKILL.md.

If the user just wants to use an existing skill (e.g. "review this PR" → pr-description-writer), invoke that skill directly. This skill is for authoring.

File layout