chapter-briefs

Solid

Build per-chapter (H2) writing briefs (NO PROSE) so the final survey reads like a paper (chapter leads + cross-H3 coherence) without inflating the ToC. **Trigger**: chapter briefs, H2 briefs, chapter lead plan, section intent, 章节意图, 章节导读, H2 卡片. **Use when**: `outline/outline.yml` + `outline/subsection_briefs.jsonl` exist and you want thicker chapters (fewer headings, more logic).

Data & Documents 498 stars 39 forks Updated today

Install

View on GitHub

Quality Score: 81/100

Stars 20%
90
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
0
Description 5%
100

Skill Content

# Chapter Briefs (H2 writing cards) [NO PROSE] Purpose: turn each **H2 chapter that contains H3 subsections** into a chapter-level writing card so the writer can: - add a chapter lead paragraph block (coherence) - keep a consistent comparison axis across the chapter - avoid “8 small islands” where every H3 restarts from scratch This artifact is **internal intent**, not reader-facing prose. Why this matters for writing quality: - Chapter briefs prevent the "paragraph island" failure mode: without a throughline, each H3 restarts and repeats openers. - Treat `throughline` and `lead_paragraph_plan` as decision constraints, not copyable sentences. ## Inputs - `outline/outline.yml` - `outline/subsection_briefs.jsonl` - Optional: `GOAL.md` ## Outputs - `outline/chapter_briefs.jsonl` ## Output format (`outline/chapter_briefs.jsonl`) JSONL (one object per H2 chapter that has H3 subsections). Required fields: - `section_id`, `section_title` - `subsections` (list of `{sub_id,title}` in outline order) - `synthesis_mode` (one of: `clusters`, `timeline`, `tradeoff_matrix`, `case_study`, `tension_resolution`) - `synthesis_preview` (1–2 bullets; how the chapter will synthesize across H3 without template-y “Taken together…”) - `throughline` (3–6 bullets) - `key_contrasts` (2–6 bullets; pull from each H3 `contrast_hook` when available) - `lead_paragraph_plan` (2–3 bullets; plan only, not prose) - Each bullet should be chapter-specific and mention concrete handles (axes / contrast h...

Details

Author
WILLOSCAR
Repository
WILLOSCAR/research-units-pipeline-skills
Created
7 months ago
Last Updated
today
Language
Python
License
None

Similar Skills

Semantically similar based on skill content — not just same category