section-merger

Merge per-section prose, transitions, and tables into a draft document.

497|38|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill section-merger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: section-merger
Source: https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/section-merger
Command: npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill section-merger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of combining individual section files into a cohesive draft document, ensuring a logical flow and preserving the intended order.

Core Features & Use Cases

  • Deterministic Merging: Combines prose files from sections/ into a single output/DRAFT.md.
  • Outline-Driven Order: Merging order is strictly controlled by outline/outline.yml.
  • Transition Injection: Weaves in transitions from outline/transitions.md for smoother flow between sections.
  • Appendix Table Inclusion: Appends tables from outline/tables_appendix.md to a dedicated Appendix section.
  • Use when: You have completed individual section drafts and need to assemble them into a complete paper draft for review or further processing.

Quick Start

Use the section merger skill to combine all section files into the main draft document.

Frequently Asked Questions about section-merger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I merge multiple markdown section drafts into a single document?

To merge markdown section drafts into a single document, this Skill deterministically combines files from a sections directory into one output file, strictly following the order defined in an outline configuration.

How do I maintain a logical flow when assembling a draft from separate sections?

Maintaining logical flow when assembling a draft is handled by injecting transition text from a dedicated transitions file between merged sections, ensuring smooth narrative continuity throughout the final document.

Can I append tables to an appendix when combining section files?

Yes, you can append tables to an appendix when combining section files. The merge process extracts tables from a specified appendix file and places them in a dedicated section at the end of the draft.

How do I control the order of sections when combining draft files?

You control the order of sections when combining draft files by specifying the desired sequence in an outline configuration file, which drives the deterministic assembly of the final merged document.

Do I need an outline file to assemble a draft from sections?

Yes, an outline file is required to assemble a draft from sections. The merging process relies entirely on this configuration to determine the correct sequential order of the combined prose files.