Write in the house voice

AGENTS.md holds the rules a linter can check: no contractions, no first person, no future tense, sentence-case headings, Oxford commas, spacing around dashes. Vale enforces most of them and make lint_prose is the gate, though Vale does not scan inside JSX components such as <Note> and <Tip>, so a clean run there proves nothing. This skill covers what a linter cannot check: rhythm, density, and the shape of a sentence that carries information.

The targets below are measured from this repository's own pages, not invented.

Keep sentences short

Median sentence length on this site is 13 to 15 words. Roughly one sentence in twelve runs past 25 words, one in forty past 30. Treat 25 as the point where you look for a split and 35 as a defect.

One idea per sentence. When a sentence carries two, split it and let the second stand alone.