Reader-First Prose
Rewrites expository prose for a reader meeting the subject for the first time, not an insider who
already shares the writer's knowledge. It enforces introduce-before-use, grounds or cuts every
metaphor in the same breath it appears, converts compressed or nominalized logic into a plain
if-then, and removes the two loudest machine tells: the em dash and the terse two-beat antithesis
("X. Not Y."). It carries an honesty pass so the prose never out-claims its evidence. It does not
simplify the argument, and it does not recurse into explanations of explanations; that is
term-interrogation.
When to Use
- A draft assumes knowledge the reader lacks, or name-drops terms before defining them.
- A draft reads as insider or "clever", or leans on unexplained metaphor.
- A draft sounds AI-written: em dashes, clipped "X. Not Y." sentences, rhythm doing the work of
explanation.
- As the standing style lens on any report written for a non-expert, and as an explicit pass
before
term-interrogation.
- The user mentions first-time reader, plain language, define before use, sounds like AI, em
dash, too clever, or jargon.
Related skills in this package: this runs at the sentence layer. Hand the recursive
explaining of terms to term-interrogation, other AI signatures to slop-detector, and scoring
to readability-check. Altitude problems (a passage abstract all the way through), detailed
number handling and evidence audits have dedicated skills elsewhere that are not bundled here;
apply the honesty rules below directly when you meet them.
The stance
One question governs every edit: who does this sentence think it is talking to?
Two stances produce two drafts of the same fact.
- The insider draft is written for a reader who already knows the world. It moves fast,
gestures, names things it never defined, and lets rhythm carry meaning. It reads as clever. It
sounds like it already knows the answer. This is the default a language model reaches for,
because it is trained on finished, insider prose.
- The reader-first draft is written for a sharp person meeting the subject for the first
time. Not a less capable reader; just one who was not already in the room. It introduces before
it leans, grounds before it flies, and states plainly what the insider draft compresses.
This skill converts the first into the second. Plainness here is not simplicity of thought. It is
respect for the reader and for the evidence.
Clarity rules
Run these in order over the draft.
- Introduce before use. Every entity, term, acronym and proper noun is defined or placed on
first mention, before any sentence depends on the reader knowing it. Who a party is before its
role; what a device is before its result; that an acronym expands before it recurs. Test: read
each sentence as if the earlier ones taught you nothing about that noun. If a noun arrives
unexplained, move its introduction earlier.
- Order for a newcomer. Facts arrive in the order a first-time reader needs them, not the
order the source or the writer discovered them. Actor before action, cause before consequence,
definition before use.
- Ground the metaphor or cut it. A figure of speech is allowed only if it is cashed out in
the same breath ("the ruler, the tool used to measure the audience"). An ungrounded metaphor
carrying real weight ("the hands took a cut", "the plates stack up") is decoration the reader
cannot spend. Replace it with the literal thing.
- Plain over clever. Rewrite compressed or nominalized logic into a plain if-then or
cause-and-effect a reader follows in one pass. A clear sentence beats a writerly one. A line
that works only because the reader already agrees is performing, not explaining.
Honesty rules
Clear prose can still quietly over-claim. Guard the edges.
- Fact vs reading. State as fact only what the source supports. When a sentence is your
interpretation, mark it as one ("read this way...", "one reading is...") or move it into an
explicitly flagged aside.
- No unstated mechanism. Do not describe how something works if the source never described
it. If the source does describe it, show it and cite it. To add it, source it first.
- Numbers exact. Every figure matches the source; direction before magnitude.
The two tics to kill
These are the loudest signals that a machine, not a person, arranged the sentence.
- The em dash (—). Remove every one. Use a semicolon for a clause join, a colon or comma for
an aside or a definition, a short en dash (–) only for a true parenthetical range. Often a
period is better than all of them.
- The terse two-beat antithesis. The clipped "X. Not Y." shape ("Same method, different
number." / "The audience did not shrink."). It feels punchy and reads as generated. Say the
thing plainly, in one sentence, with the concrete detail restored.
Procedure: the per-sentence pass
For each sentence, in order:
Worked examples
Each pair is an insider draft rewritten reader-first. The topic is incidental; the moves
generalize to any expository writing.
1. Introduce before use.
- Before: "The price of the middleman's work was a published figure."
- After: "The agencies were the middlemen: they bought the space and made the ads. What they
charged for that work, a 15% commission, was published."
- Fix: the reader met "the middleman" before being told who it was. Name it first.
2. Ground the metaphor.
- Before: "Behind the 15% stood a stack of hands, and most of them were not public."
- After: "Behind the 15% were several other parties, each taking a cut of the same dollar, and
most of those cuts were never public."
- Fix: "hands" was decoration. Replace with the literal parties and cuts.
3. Plain over clever.
- Before: "A market where the seller simply inflates its own count does not predict a seller
adopting a ruler that shrinks its numbers."
- After: "If sellers always just inflated the count, they would not adopt a standard that shrank
their own numbers; yet here they did."
- Fix: an abstract, nominalized claim becomes a plain if-then a reader follows in one pass.
4. Kill the antithesis and the em dash.
- Before: "No viewer got up off the couch. The audience did not shrink. The instrument changed —
and the number dropped."
- After: "Nothing had happened to the audience; the same people sat on the same couches. What
changed was the way they were counted."
- Fix: the clipped two-beat pattern and the em dash both go; the concrete image stays, stated
plainly.
5. Fact vs reading (honesty).
- Before: "The more honest count cut the sellers' own figures, which is why the 'sellers rig
everything' story fails."
- After (in a flagged aside): "One reading: the newer count is the more honest one, and that is
what makes this strange. If sellers always inflated the count, they would not adopt a standard
that shrank their numbers."
- Fix: the interpretive leap is marked as a reading, not stated as established fact.
Guardrails
- Do not flatten voice into blandness. Reader-first is not tone-deaf or listy. Keep the
writer's rhythm and warmth; remove only what a newcomer cannot follow or what over-claims.
- Simplify the demands, not the content. The facts, the argument and the precision stay.
What drops is the assumed prior knowledge and the unearned compression.
- Do not delete a hedge that carries real uncertainty to make a sentence cleaner. "Appears
to" and "on the available evidence" are load-bearing when the evidence is thin.
- Preserve every number and named source. This skill rewrites how a claim reads, never what
it asserts.
- Introduce once. Define a term at first use; do not re-explain it on every mention.
Verification
- Use
search_files on the finished file for the em dash character; the count must be zero.
- Read the first paragraph of each section as a stranger: no noun arrives before it is placed.
- Every interpretive sentence is marked as a reading or sits in a flagged aside.
- Every number matches its source exactly.
- Then hand the document to
term-interrogation, and score it last with readability-check.
1---2name: reader-first-prose-23description: Rewrite prose so a first-time reader can follow every line.4license: MIT5---6# Reader-First Prose78Rewrites expository prose for a reader meeting the subject for the first time, not an insider who9already shares the writer's knowledge. It enforces introduce-before-use, grounds or cuts every10metaphor in the same breath it appears, converts compressed or nominalized logic into a plain11if-then, and removes the two loudest machine tells: the em dash and the terse two-beat antithesis12("X. Not Y."). It carries an honesty pass so the prose never out-claims its evidence. It does not13simplify the argument, and it does not recurse into explanations of explanations; that is14`term-interrogation`.1516## When to Use1718- A draft assumes knowledge the reader lacks, or name-drops terms before defining them.19- A draft reads as insider or "clever", or leans on unexplained metaphor.20- A draft sounds AI-written: em dashes, clipped "X. Not Y." sentences, rhythm doing the work of21 explanation.22- As the standing style lens on any report written for a non-expert, and as an explicit pass23 before `term-interrogation`.24- The user mentions first-time reader, plain language, define before use, sounds like AI, em25 dash, too clever, or jargon.2627**Related skills in this package:** this runs at the sentence layer. Hand the recursive28explaining of terms to `term-interrogation`, other AI signatures to `slop-detector`, and scoring29to `readability-check`. Altitude problems (a passage abstract all the way through), detailed30number handling and evidence audits have dedicated skills elsewhere that are not bundled here;31apply the honesty rules below directly when you meet them.3233## The stance3435One question governs every edit: **who does this sentence think it is talking to?**3637Two stances produce two drafts of the same fact.3839- **The insider draft** is written for a reader who already knows the world. It moves fast,40 gestures, names things it never defined, and lets rhythm carry meaning. It reads as clever. It41 sounds like it already knows the answer. This is the default a language model reaches for,42 because it is trained on finished, insider prose.43- **The reader-first draft** is written for a sharp person meeting the subject for the first44 time. Not a less capable reader; just one who was not already in the room. It introduces before45 it leans, grounds before it flies, and states plainly what the insider draft compresses.4647This skill converts the first into the second. Plainness here is not simplicity of thought. It is48respect for the reader and for the evidence.4950## Clarity rules5152Run these in order over the draft.53541. **Introduce before use.** Every entity, term, acronym and proper noun is defined or placed on55 first mention, before any sentence depends on the reader knowing it. Who a party is before its56 role; what a device is before its result; that an acronym expands before it recurs. Test: read57 each sentence as if the earlier ones taught you nothing about that noun. If a noun arrives58 unexplained, move its introduction earlier.592. **Order for a newcomer.** Facts arrive in the order a first-time reader needs them, not the60 order the source or the writer discovered them. Actor before action, cause before consequence,61 definition before use.623. **Ground the metaphor or cut it.** A figure of speech is allowed only if it is cashed out in63 the same breath ("the ruler, the tool used to measure the audience"). An ungrounded metaphor64 carrying real weight ("the hands took a cut", "the plates stack up") is decoration the reader65 cannot spend. Replace it with the literal thing.664. **Plain over clever.** Rewrite compressed or nominalized logic into a plain if-then or67 cause-and-effect a reader follows in one pass. A clear sentence beats a writerly one. A line68 that works only because the reader already agrees is performing, not explaining.6970## Honesty rules7172Clear prose can still quietly over-claim. Guard the edges.73741. **Fact vs reading.** State as fact only what the source supports. When a sentence is your75 interpretation, mark it as one ("read this way...", "one reading is...") or move it into an76 explicitly flagged aside.772. **No unstated mechanism.** Do not describe how something works if the source never described78 it. If the source does describe it, show it and cite it. To add it, source it first.793. **Numbers exact.** Every figure matches the source; direction before magnitude.8081## The two tics to kill8283These are the loudest signals that a machine, not a person, arranged the sentence.8485- **The em dash (—).** Remove every one. Use a semicolon for a clause join, a colon or comma for86 an aside or a definition, a short en dash (–) only for a true parenthetical range. Often a87 period is better than all of them.88- **The terse two-beat antithesis.** The clipped "X. Not Y." shape ("Same method, different89 number." / "The audience did not shrink."). It feels punchy and reads as generated. Say the90 thing plainly, in one sentence, with the concrete detail restored.9192## Procedure: the per-sentence pass9394For each sentence, in order:9596- [ ] Is every noun known to a first-time reader here? If not, introduce it earlier.97- [ ] Is this a plain statement, or a performance? If rhythm is doing the work, rewrite it98 plainly.99- [ ] Any metaphor I have not paid for in the same breath?100- [ ] Is this a fact the source supports, or my reading of it? Mark the reading.101- [ ] Any em dash, or any "X. Not Y." antithesis? Remove it.102- [ ] Are the numbers exactly as sourced?103104## Worked examples105106Each pair is an insider draft rewritten reader-first. The topic is incidental; the moves107generalize to any expository writing.108109**1. Introduce before use.**110- Before: "The price of the middleman's work was a published figure."111- After: "The agencies were the middlemen: they bought the space and made the ads. What they112 charged for that work, a 15% commission, was published."113- Fix: the reader met "the middleman" before being told who it was. Name it first.114115**2. Ground the metaphor.**116- Before: "Behind the 15% stood a stack of hands, and most of them were not public."117- After: "Behind the 15% were several other parties, each taking a cut of the same dollar, and118 most of those cuts were never public."119- Fix: "hands" was decoration. Replace with the literal parties and cuts.120121**3. Plain over clever.**122- Before: "A market where the seller simply inflates its own count does not predict a seller123 adopting a ruler that shrinks its numbers."124- After: "If sellers always just inflated the count, they would not adopt a standard that shrank125 their own numbers; yet here they did."126- Fix: an abstract, nominalized claim becomes a plain if-then a reader follows in one pass.127128**4. Kill the antithesis and the em dash.**129- Before: "No viewer got up off the couch. The audience did not shrink. The instrument changed —130 and the number dropped."131- After: "Nothing had happened to the audience; the same people sat on the same couches. What132 changed was the way they were counted."133- Fix: the clipped two-beat pattern and the em dash both go; the concrete image stays, stated134 plainly.135136**5. Fact vs reading (honesty).**137- Before: "The more honest count cut the sellers' own figures, which is why the 'sellers rig138 everything' story fails."139- After (in a flagged aside): "One reading: the newer count is the more honest one, and that is140 what makes this strange. If sellers always inflated the count, they would not adopt a standard141 that shrank their numbers."142- Fix: the interpretive leap is marked as a reading, not stated as established fact.143144## Guardrails145146- **Do not flatten voice into blandness.** Reader-first is not tone-deaf or listy. Keep the147 writer's rhythm and warmth; remove only what a newcomer cannot follow or what over-claims.148- **Simplify the demands, not the content.** The facts, the argument and the precision stay.149 What drops is the assumed prior knowledge and the unearned compression.150- **Do not delete a hedge that carries real uncertainty** to make a sentence cleaner. "Appears151 to" and "on the available evidence" are load-bearing when the evidence is thin.152- **Preserve every number and named source.** This skill rewrites how a claim reads, never what153 it asserts.154- **Introduce once.** Define a term at first use; do not re-explain it on every mention.155156## Verification157158- Use `search_files` on the finished file for the em dash character; the count must be zero.159- Read the first paragraph of each section as a stranger: no noun arrives before it is placed.160- Every interpretive sentence is marked as a reading or sits in a flagged aside.161- Every number matches its source exactly.162- Then hand the document to `term-interrogation`, and score it last with `readability-check`.