What problem does it solve? Documents and drafts written outside a structured workflow often bury the main point, use vague headings, and pack multiple ideas into long sentences. This Skill applies a shared readability standard to prose you already have without altering any facts, code, diagrams, or citation identifiers. ## Core Features & Use Cases - Fact-preserving rewrite: Dispatches a readability-editor agent that rewrites prose so the main point comes first, headings are descriptive, and sentences stay short and active, while returning a fact-preservation ledger. - Flexible targets: Works on a file on disk (edited in place after confirmation), text pasted into the prompt, or a draft already produced in the conversation. - Reader and shape awareness: Carries a named target reader and any requested shape (length, format, register) into the rewrite, and supports a configurable writing-voice profile from project or personal config. - Use Case: You have a hand-written incident report that rambles. Point the Skill at the file, and it rewrites the prose in place, reporting which regions were left untouched and confirming no fact was lost. ## Quick Start Ask the assistant to edit the file docs/incident-report.md for readability and confirm the in-place rewrite when prompted.
