writing

---

name: writing description: Use for improving and reviewing prose — cover letters, essays, reports, grant applications, speeches, emails, or any writing. Two modes — (1) iterate: refine a draft through parallel dual-reviewer passes until it stabilizes ("improve this", "make this better", "polish this writing", "keep refining until it's ready"); (2) diff-review: compare two versions and generate an interactive HTML diff with editorial commentary ("show me what changed", "create a diff", "compare versions"). NOT for code review (use git diff / code-review) or prompt/agent-instruction tuning (use prompt-engineering).

Writing

Two modes for working on prose documents. Pick based on what the user needs:

Mode	Use when	Reference
Iterate	Refining a draft toward "good" — systematic tightening via parallel reviewers until convergence	references/iteration-loop.md
Diff-review	Showing what changed between two versions — an interactive HTML diff with per-change rationale	references/diff-review.md

They chain naturally: iterate a draft to a final version, then diff-review v1→final to show the user (and explain) every change.

Quick orientation

• Iterate runs two independent reviewer subagents per pass — a Strunk-style copy editor and a domain quality evaluator — applying changes until both say READY (or ~8 passes, whichever comes first). The highest-leverage input is source documents (job descriptions, RFPs, brochures) that define what "good" means for this context. The reference has the subagent dispatch pattern and per-domain quality checklists (cover letters, essays, grants).
• Diff-review produces a sentence-level diff, then adapts the bundled HTML template (references/diff-review-template.html) into an annotated, exportable review page (inline + side-by-side views, sidebar commentary, localStorage annotations). The reference has the markup patterns and the optional change-report format.