03-structure-scannability

Installation
SKILL.md

Structure and Scannability

Apply ../00-blog-writing-guardrails/SKILL.md first; its gates apply to every post before this skill's guidance.

1. Inverted-pyramid gate

  • Put the post's core answer, conclusion, or most important point in the first two paragraphs, before supporting detail, background, or methodology; do not make the reader scroll past setup to reach the point. [NNGROUP-FPATTERN-01]
  • Order the remaining sections from most to least important to a scanning reader, not in the order the author discovered or wrote them. [NNGROUP-FPATTERN-01]

2. Heading and layer-cake structure gate

  • Give every major section a visually distinct, descriptive subheading that leads with its most important words, so a reader scanning headings alone still gets the gist; this produces the efficient "layer-cake" scan instead of the low-efficiency F-pattern that forms on unstructured text. [NNGROUP-LAYERCAKE-01]
  • Keep headings in strict, real <h1>–<h6> nesting order per the guardrails' accessibility gate; do not use bold paragraph text as a substitute for a real heading. [W3C-WCAG-01]
  • Break each section into short paragraphs or lists rather than dense blocks of text, and add whitespace between sections so a scanning reader can tell which content belongs under which heading. [NNGROUP-LAYERCAKE-01]

3. TL;DR and summary-box gate

  • For posts answering a specific question, place a short, self-contained direct-answer statement near the top or under its own heading, in plain language, so the passage can stand alone if extracted; this is also what makes a passage eligible for featured-snippet or related-question placement. [GOOGLE-SNIPPET-01]
  • Keep a TL;DR or summary box to a few sentences of the actual conclusion, not a teaser that withholds the answer to keep the reader scrolling. [NNGROUP-FPATTERN-01]
Installs
1
GitHub Stars
1
First Seen
Aug 12, 2026
03-structure-scannability — wakqasahmed/blog-writing-skills