Mechanical, structural-only edits to prose. Voice and register are load-bearing and preserved verbatim.
Allowed transformations
- Restructure section order to respect information dependencies (treat info as a DAG; later sections may depend on earlier, never vice versa).
- Split a paragraph carrying two distinct points into two paragraphs.
- Merge two short paragraphs that carry the same point into one.
- Remove redundant sentences, clauses, or words that repeat what was already stated.
- Consolidate parallel lists or tables into a single canonical form when content overlaps.
- Tighten run-on sentences into shorter, clearer ones — preserving the original meaning and the original word choice where possible.
- Cap paragraphs at ~240 characters where doing so requires no rephrasing.
- Promote inline asides into footnotes or sidebars when they break flow.
- Demote redundant headings; promote orphan paragraphs to their own subsection.
Forbidden transformations (hard fence)
- Do NOT change voice (active/passive, first/second/third person).
- Do NOT change register (formal ↔ casual).
- Do NOT change tone (technical, decision-oriented, imperative).
- Do NOT rewrite ODIN-mandated phrasing — terse imperative, third-person, English-mandate, decision-first prose stays.
- Do NOT introduce new claims, examples, or analogies that were not in the source.
- Do NOT remove technical specificity (file paths, command flags, version numbers, named constants).
- Do NOT rename headers, fields, or list items even if they look redundant — those are structural and load-bearing.
- Do NOT translate non-English-mandate content into a different style "for clarity."
- Do NOT add emojis, gradients of warmth, marketing language, or hedging.
If a transformation seems necessary but lives in the forbidden list, STOP and surface the question to the user.
Protocol
- Dispatch Explore agent (or read directly for ≤50 LOC) to map the document into sections by heading. Build the dependency graph.
- Confirm the section order and graph with the user before any edit.
- For each section, in dependency order:
- Identify candidate transformations from the allowed list.
- Apply only those. Surface any forbidden-list candidates as questions.
- Diff with
difft after the edit; reject the change if voice/register/tone shifted.
- After all sections are processed, re-read the document end-to-end. Confirm flow without re-editing.
- Commit with message:
docs: tighten <document-name> (mechanical edits only).
Use cases (in scope)
- Tightening a verbose
docs/refactor-plans/<n>.md produced by request-refactor-plan.
- Compressing a long-form ADR before merging.
- Removing duplicated sentences across README sections.
- Reordering a tutorial whose steps reference forward concepts.
Use cases (out of scope — use a different skill)
- Rewriting a draft in a different voice — use a manual rewrite, not this skill.
- Translating a non-English document — ODIN's English-mandate governs original drafting.
- Producing a new document from notes — use general implementation planning or
request-refactor-plan.
Parallel examples
Rust crate README: allowed — split a 400-char paragraph mixing "what it is" and "how to install" into two paragraphs; merge two adjacent install paragraphs covering cargo and pre-built binaries. Forbidden — rewriting the imperative install steps as friendly second-person.
Python project ADR: allowed — reorder "Consequences" to follow "Decision" (was reversed); strip a sentence that re-states the title. Forbidden — softening a hard "MUST" into "should".
1---2name: edit-article3description: Mechanically tighten existing prose — restructure sections by dependency order, split or merge paragraphs, remove redundancy. Use to compress verbose plan files, READMEs, ADRs, and design docs. Does NOT change voice, register, tone, or any ODIN-mandated phrasing.4---5
6Mechanical, structural-only edits to prose. Voice and register are load-bearing and preserved verbatim.
7
8## Allowed transformations
9
10- Restructure section order to respect information dependencies (treat info as a DAG; later sections may depend on earlier, never vice versa).
11- Split a paragraph carrying two distinct points into two paragraphs.
12- Merge two short paragraphs that carry the same point into one.
13- Remove redundant sentences, clauses, or words that repeat what was already stated.
14- Consolidate parallel lists or tables into a single canonical form when content overlaps.
15- Tighten run-on sentences into shorter, clearer ones — preserving the original meaning and the original word choice where possible.
16- Cap paragraphs at ~240 characters where doing so requires no rephrasing.
17- Promote inline asides into footnotes or sidebars when they break flow.
18- Demote redundant headings; promote orphan paragraphs to their own subsection.
19
20## Forbidden transformations (hard fence)
21
22- Do NOT change voice (active/passive, first/second/third person).
23- Do NOT change register (formal ↔ casual).
24- Do NOT change tone (technical, decision-oriented, imperative).
25- Do NOT rewrite ODIN-mandated phrasing — terse imperative, third-person, English-mandate, decision-first prose stays.
26- Do NOT introduce new claims, examples, or analogies that were not in the source.
27- Do NOT remove technical specificity (file paths, command flags, version numbers, named constants).
28- Do NOT rename headers, fields, or list items even if they look redundant — those are structural and load-bearing.
29- Do NOT translate non-English-mandate content into a different style "for clarity."
30- Do NOT add emojis, gradients of warmth, marketing language, or hedging.
31
32If a transformation seems necessary but lives in the forbidden list, STOP and surface the question to the user.
33
34## Protocol
35
361. Dispatch Explore agent (or read directly for ≤50 LOC) to map the document into sections by heading. Build the dependency graph.
372. Confirm the section order and graph with the user before any edit.
383. For each section, in dependency order:
39 - Identify candidate transformations from the **allowed** list.
40 - Apply only those. Surface any forbidden-list candidates as questions.
41 - Diff with `difft` after the edit; reject the change if voice/register/tone shifted.
424. After all sections are processed, re-read the document end-to-end. Confirm flow without re-editing.
435. Commit with message: `docs: tighten <document-name> (mechanical edits only)`.
44
45## Use cases (in scope)
46
47- Tightening a verbose `docs/refactor-plans/<n>.md` produced by `request-refactor-plan`.
48- Compressing a long-form ADR before merging.
49- Removing duplicated sentences across README sections.
50- Reordering a tutorial whose steps reference forward concepts.
51
52## Use cases (out of scope — use a different skill)
53
54- Rewriting a draft in a different voice — use a manual rewrite, not this skill.
55- Translating a non-English document — ODIN's English-mandate governs original drafting.
56- Producing a new document from notes — use general implementation planning or `request-refactor-plan`.
57
58## Parallel examples
59
60**Rust crate README:** allowed — split a 400-char paragraph mixing "what it is" and "how to install" into two paragraphs; merge two adjacent install paragraphs covering cargo and pre-built binaries. Forbidden — rewriting the imperative install steps as friendly second-person.
61
62**Python project ADR:** allowed — reorder "Consequences" to follow "Decision" (was reversed); strip a sentence that re-states the title. Forbidden — softening a hard "MUST" into "should".
majiayu000