What problem does it solve? Enforcing a consistent writing style across an entire repository's prose is tedious and error-prone when done by hand. This Skill automates the sweep: it detects rule violations in prose files, dispatches subagents to repair them in batches, and records what has been swept so future runs only cover new or changed rules. ## Core Features & Use Cases - Rule-driven prose sweep: Reads rule units and versions declared by markers in the document, then runs a bundled helper to detect candidates, batch files, and report skipped files by reason. - Batched subagent repair with safety gates: Dispatches up to four prose-reviser subagents per wave, verifies diffs against batch file lists, commits per batch, and pilots the first batch for user approval. - Persistent sweep record: Writes accepted and rejected decisions to .agents/revise-prose.yaml so recorded rejections are re-suppressed and already-swept batches are skipped on later runs. - Use Case: Run a whole-repository sweep to enforce plain-speech and writing-preference rules across all Markdown docs, review questionable repairs in a grouped table, and commit each batch separately. ## Quick Start Ask the agent to revise the prose in this repository against the writing rules, optionally narrowing the sweep to specific paths or using --dry-run for a report only.
