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

  1. 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.
  2. 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.
  3. 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.
Installs
9
Repository
otrebu/skills
First Seen
May 29, 2026
structured-replies — otrebu/skills