reader-first-prose

Rewrites expository prose so first-time readers can follow every sentence.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/lyndonkl/hermesworld --skill reader-first-prose-lyndonkl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reader-first-prose
Source: https://github.com/lyndonkl/hermesworld/tree/main/packages/product-strategist/skills/writing/reader-first-prose
Command: npx skills add https://github.com/lyndonkl/hermesworld --skill reader-first-prose-lyndonkl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Drafts often assume insider knowledge, lean on unexplained metaphors, and carry machine-writing tells like em dashes and clipped antithesis, leaving first-time readers lost. This Skill rewrites such prose so a newcomer can follow every line without flattening the argument. ## Core Features & Use Cases - Introduce-Before-Use Enforcement: Ensures every term, acronym, and proper noun is defined or placed before any sentence depends on it. - Clarity and Honesty Rules: Grounds or cuts metaphors, converts compressed logic into plain if-then statements, and marks interpretation as reading rather than fact. - Machine-Tell Removal: Eliminates em dashes and terse "X. Not Y." antithesis patterns that signal AI-generated text. - Use Case: A strategy report written for executives needs to reach a general audience; run this pass to define terms on first mention, ground metaphors, and verify every number matches its source. ## Quick Start Rewrite this draft so a first-time reader can follow every sentence, defining terms before use and removing em dashes.

Frequently Asked Questions about reader-first-prose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make my writing clear for non-expert readers?

Apply a reader-first pass: define every term and acronym at first mention, order facts so causes precede consequences, and ground each metaphor in the same sentence it appears. Rewrite compressed logic into plain if-then statements a newcomer follows in one pass.

How to remove AI writing patterns from a draft?

Delete every em dash, replacing it with a semicolon, colon, comma, or period. Rewrite clipped "X. Not Y." antithesis sentences into plain single statements with the concrete detail restored, since these two patterns are the loudest machine-writing signals.

Does simplifying prose mean dumbing down the content?

No. Reader-first editing keeps the facts, argument, and precision intact while removing assumed prior knowledge and unearned compression. It simplifies the demands on the reader, not the content itself, and preserves hedges that carry real uncertainty.

When should I not use reader-first rewriting?

Avoid it when the audience is expert insiders who share the vocabulary, or when the task is recursive explanation of terms, which belongs to a dedicated term-interrogation pass. It also does not replace evidence audits or readability scoring.

How do I keep interpretations separate from facts in writing?

State as fact only what the source supports, and mark interpretation explicitly with phrases like "one reading is" or move it into a flagged aside. Never describe a mechanism the source did not describe, and keep every number exactly as sourced.