rewrite

name	rewrite
description	Rewrite content in plain language while preserving meaning. Chains: readable-content, link-text-design. Use when given content that is too complex, jargon-heavy, or inaccessible for the target audience.

Rewrite for Accessibility

Take existing content and rewrite it to be accessible to people with diverse cognitive abilities and literacy levels — without losing accuracy or meaning.

Process

Step 1: Assess Current Readability

Using readable-content, evaluate:

• Current reading level
• Sentence and paragraph length
• Jargon and specialist terms
• Content structure and scannability

Step 2: Identify the Core Message

For each section, answer: what is the one thing the reader must understand? Write that down in one plain sentence. This becomes the opening line of the rewritten section.

Step 3: Rewrite

• Replace jargon with plain alternatives
• Shorten sentences to 15–20 words
• One idea per sentence, one topic per paragraph
• Front-load each paragraph with the key point
• Use active voice throughout
• Address the reader as "you"
• Add examples to clarify abstract concepts

Step 4: Fix Links

Using link-text-design, rewrite any link text that doesn't make sense on its own. Replace "click here" and "read more" with descriptive link text.

Step 5: Present Before and After

Show the original alongside the rewrite with annotations explaining each change. Include the reading level of both versions.

Rules

• Never sacrifice accuracy for simplicity — if a term is essential, keep it and define it
• Don't condescend — plain language is clear language, not childish language
• Preserve the author's intent and tone where possible
• Flag any content where simplification might change the legal or technical meaning — let the team decide those tradeoffs

Output

Deliver the rewritten content with:

• Reading level of original vs. rewrite
• Change log of significant edits with rationale
• Flagged passages where meaning may have shifted