section-merger

Installation
SKILL.md

Section Merger

Goal: assemble a paper-like output/DRAFT.md from:

  • sections/ (per-section/per-subsection prose)
  • outline/transitions.md (short hand-offs; generated by transition-weaver)
  • outline/tables_appendix.md (reader-facing Appendix tables; generated by appendix-table-writer)

Merge order is driven by outline/outline.yml. The draft title is taken from GOAL.md when present. sections/sections_manifest.jsonl is an optional diagnostics input.

This skill is deterministic: it does not rewrite content or invent prose; it only merges already-generated artifacts.

Transitions (injected text)

  • By default, section-merger inserts only within-chapter H3->H3 transitions.
  • Optional: if you want between-H2 transitions inserted too, create outline/transitions.insert_h2.ok in the workspace.
  • Format contract: only lines matching - 3.1 -> 3.2: <text> are injected by default.
  • Compatibility: is accepted, but -> is the preferred contract (avoids control-character encoding issues).
  • Treat transitions as injected draft text: run post-merge-voice-gate after merging, and route fixes back to outline/transitions.md (do not patch the merged draft).
Related skills
Installs
32
GitHub Stars
431
First Seen
Jan 23, 2026