subsection-briefs

Generate per-subsection writing briefs from outline.yml, mapping.tsv, and paper_notes.jsonl.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the creation of detailed, evidence-driven briefs for each subsection of a document, ensuring that subsequent writing is grounded in research and avoids generic prose or outline leakage.

Core Features & Use Cases

  • Deterministic Brief Generation: Creates structured briefs (axes, clusters, thesis statements, etc.) based on outline, mapping, and paper notes.
  • Evidence-Grounded Planning: Ensures that writing is driven by specific evidence and checkable comparison points, not just placeholders.
  • Use Case: When drafting a literature review, use this Skill to generate a clear brief for each section, outlining the key arguments, supporting evidence, and comparison axes, before any prose is written.

Quick Start

Run the subsection-briefs skill to generate briefs for the current outline and paper notes.

Frequently Asked Questions about subsection-briefs

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

FAQPage Schema
How do I generate structured writing briefs from an outline and research notes?

To generate structured writing briefs, you need to process your outline.yml, mapping.tsv, and paper_notes.jsonl files. This creates per-subsection briefs containing axes, clusters, and thesis statements to drive evidence-based drafting.

What is the best way to prevent outline leakage when drafting a literature review?

Preventing outline leakage requires generating evidence-grounded briefs before writing prose. By mapping paper_notes.jsonl directly to outline sections, you ensure drafting is driven by specific evidence and checkable comparison points rather than placeholders.

How do I plan a document section using axes and clusters from research notes?

Planning a document section with axes and clusters involves creating deterministic subsection briefs. This structures your arguments by mapping specific evidence from paper notes to outline nodes, ensuring downstream compatibility for evidence-based drafting.

Do I need specific input files to generate per-subsection briefs for my document?

Yes, generating per-subsection briefs requires specific input files: outline.yml, mapping.tsv, and paper_notes.jsonl. These files provide the deterministic structure and evidence needed to map research notes to outline sections.

Can I use this brief generation method for non-deterministic research outputs?

No, this brief generation method produces deterministic outputs. It relies on structured input files like outline.yml and mapping.tsv to create fixed axes, clusters, and thesis statements, preventing generic prose during downstream drafting.