outline-budgeter

Merge fragmented H3 subsections in outline.yml into 6-8 H2 sections.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common issue of overly fragmented outlines with too many small subsections, ensuring a more cohesive and paper-like structure.

Core Features & Use Cases

  • Outline Consolidation: Merges fragmented subsections (H3s) into thicker, more substantial ones.
  • Structure Optimization: Aims for a target of 6-8 main sections (H2s) for a clear, hierarchical document.
  • Use Case: When your research outline has dozens of tiny H3s, use this skill to consolidate them into a manageable number of robust sections before writing prose.

Quick Start

Use the outline-budgeter skill to merge sections in outline/outline.yml to meet a target of 6-8 H2 sections.

Frequently Asked Questions about outline-budgeter

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

FAQPage Schema
How do I consolidate a fragmented research outline with too many subsections?

You can consolidate a fragmented research outline by merging adjacent subsections with similar keywords or weak mapping coverage into fewer, thicker sections. This targets approximately 6-8 H2 sections to prevent H3 explosion and create a cohesive structure.

What causes an H3 explosion in document structure and how do I fix it?

An H3 explosion in document structure happens when an outline becomes over-fragmented into dozens of tiny subsections. You fix it by merging adjacent H3s with similar keywords or weak mapping coverage to achieve 6-8 thicker, paper-like H2 sections.

How do I merge subsections in an outline.yml file before writing prose?

Merging subsections in an outline.yml file involves analyzing adjacent H3s with similar keywords and weak mapping coverage. By querying mapping.tsv data, you can consolidate fragmented subsections into a manageable budget of 6-8 main H2 sections.

When do I need outline consolidation for my research paper?

You need outline consolidation for your research paper when your outline has dozens of tiny H3s, creating an over-fragmented structure. Consolidating these into 6-8 main H2 sections ensures a cohesive, paper-like hierarchy before you start writing prose.

Can I use queries.md and mapping.tsv to inform outline merge decisions?

Yes, you can use queries.md and outline/mapping.tsv to inform outline merge decisions. The consolidation process prioritizes merging adjacent H3s that exhibit similar keywords or weak mapping coverage based on the data in these input files.

What is the target structure for an optimized research outline?

The target structure for an optimized research outline is approximately 6-8 main H2 sections containing fewer, thicker H3 subsections. This structure prevents over-fragmentation and ensures a clear, hierarchical document suitable for writing prose.