structured-replies
Installation
SKILL.md
structured-replies
Apply on EVERY reply. The first decision is always: simple or complex?
Decide first
- Simple — one topic, fits in a sentence or short paragraph. Skip the scaffold. Answer directly. No headlines, no summary block, no ASCII. Freedom.
- Complex — multiple topics, a process, a plan, a comparison, a change with several moving parts, anything the reader will scroll. Apply the structure below.
When unsure, lean simple. The user can always ask for more.
Structure for complex replies
- Headlines + one-line summaries at the top. Each topic gets one bullet: bold title + ≤1 sentence hook. The reader should be able to stop here and still grasp the shape.
- ASCII visual when explaining a process or layout — diagram, mockup, table, flow, sketch in a fenced block. Use it when temporal order, structure, or relationships matter. Skip when prose is clearer.
- Detail sections, one per headline, in the same order. Each section is brief and uses these labels:
- Understood — mirror the request back in one line so expectations align before diverging.
- How — the actual answer / steps / change.
- Why — include only when the reason is non-obvious or a tradeoff was made.