Run the editor agent to polish your manuscript at the line level.
What This Does
- Processes chapters looking for mechanical issues
- Flags spelling, grammar, awkward phrasing, word echoes
- Identifies manuscript-wide patterns (overused words, crutch phrases)
- Offers to apply mechanical fixes automatically
- Updates
progress.md with findings
Usage
/fiction:edit # Edit most recent chapter
/fiction:edit 5 # Edit chapter 5
/fiction:edit all # Edit all drafted chapters
/fiction:edit 3-7 # Edit chapters 3 through 7
If arguments provided: $ARGUMENTS
Parallel Processing (Important for Large Manuscripts)
When editing multiple chapters ("all" or a range), spawn editor agents in parallel for efficiency:
- Identify all chapters to process
- Launch one editor agent per chapter simultaneously using the Task tool
- Each agent processes its chapter independently
- After all complete, aggregate manuscript-wide patterns from all reports
- Update
progress.md with combined findings
Example parallel approach for /fiction:edit all with 20 chapters:
- Spawn 20 editor agents in a single message (one Task call per chapter)
- Agents run concurrently, each producing its own report
- Main conversation aggregates: common crutch words, repeated issues across chapters
- Total time ~ time for 1 chapter instead of 20x
What It Catches
- Style guide compliance — Enforces the project's declared style guide (Chicago Manual of Style for American, New Oxford Style Manual for British). Checks spelling conventions, punctuation rules, dash style, quotation marks, number rendering, capitalisation, and date formats. The editor reads
craft/tone.md for the project's declared guide, or detects it from context.
- Spelling & typos — Including wrong-word errors (their/there) and variant-specific spelling (colour/color, travelled/traveled)
- Grammar & punctuation — Agreement, comma splices, dialogue punctuation per the active guide, serial comma usage, logical vs American quote placement
- Awkward phrasing — Confusing syntax, unclear references
- Word echoes — Repetition in close proximity
- Overused words — Filter words, weak verbs, crutch words
- Formatting — Dash style, ellipsis style, quote marks, scene breaks — all checked against the active style guide
- Audiobook readiness — Unattributed dialogue, ambiguous pronouns, similar-sounding names
Output
A report per chapter with:
- Issues by category with line numbers
- Suggested fixes
- Manuscript-wide patterns (when editing multiple chapters)
When to Use
- After completing a chapter draft
- Before sending to beta readers
- During revision passes
- After
/fiction:review addresses story issues
Workflow
Recommended order for polishing:
/fiction:review — Fix story/craft issues first
/fiction:edit — Then line-level polish
continuity agent — Check cross-chapter consistency
/fiction:critique — Final literary assessment (if complete)
Related Commands
/fiction:review — Story and craft feedback (run first)
/fiction:critique — Full manuscript literary review
/fiction:reconcile — Project structure audit
1---2name: edit3description: Run line-level editing across chapters. Catches spelling, grammar, awkward phrasing, and word echoes.4---56Run the editor agent to polish your manuscript at the line level.78## What This Does9101. Processes chapters looking for mechanical issues112. Flags spelling, grammar, awkward phrasing, word echoes123. Identifies manuscript-wide patterns (overused words, crutch phrases)134. Offers to apply mechanical fixes automatically145. Updates `progress.md` with findings1516## Usage1718```19/fiction:edit # Edit most recent chapter20/fiction:edit 5 # Edit chapter 521/fiction:edit all # Edit all drafted chapters22/fiction:edit 3-7 # Edit chapters 3 through 723```2425If arguments provided: $ARGUMENTS2627## Parallel Processing (Important for Large Manuscripts)2829When editing multiple chapters ("all" or a range), **spawn editor agents in parallel** for efficiency:30311. Identify all chapters to process322. Launch one editor agent per chapter simultaneously using the Task tool333. Each agent processes its chapter independently344. After all complete, aggregate manuscript-wide patterns from all reports355. Update `progress.md` with combined findings3637**Example parallel approach for `/fiction:edit all` with 20 chapters:**38- Spawn 20 editor agents in a single message (one Task call per chapter)39- Agents run concurrently, each producing its own report40- Main conversation aggregates: common crutch words, repeated issues across chapters41- Total time ~ time for 1 chapter instead of 20x4243## What It Catches4445- **Style guide compliance** — Enforces the project's declared style guide (Chicago Manual of Style for American, New Oxford Style Manual for British). Checks spelling conventions, punctuation rules, dash style, quotation marks, number rendering, capitalisation, and date formats. The editor reads `craft/tone.md` for the project's declared guide, or detects it from context.46- **Spelling & typos** — Including wrong-word errors (their/there) and variant-specific spelling (colour/color, travelled/traveled)47- **Grammar & punctuation** — Agreement, comma splices, dialogue punctuation per the active guide, serial comma usage, logical vs American quote placement48- **Awkward phrasing** — Confusing syntax, unclear references49- **Word echoes** — Repetition in close proximity50- **Overused words** — Filter words, weak verbs, crutch words51- **Formatting** — Dash style, ellipsis style, quote marks, scene breaks — all checked against the active style guide52- **Audiobook readiness** — Unattributed dialogue, ambiguous pronouns, similar-sounding names5354## Output5556A report per chapter with:57- Issues by category with line numbers58- Suggested fixes59- Manuscript-wide patterns (when editing multiple chapters)6061## When to Use6263- After completing a chapter draft64- Before sending to beta readers65- During revision passes66- After `/fiction:review` addresses story issues6768## Workflow6970Recommended order for polishing:71721. `/fiction:review` — Fix story/craft issues first732. `/fiction:edit` — Then line-level polish743. `continuity` agent — Check cross-chapter consistency754. `/fiction:critique` — Final literary assessment (if complete)7677## Related Commands7879- `/fiction:review` — Story and craft feedback (run first)80- `/fiction:critique` — Full manuscript literary review81- `/fiction:reconcile` — Project structure audit