mcpbeat

Section Briefs

willoscar/section-briefs

| Build chapter-level briefs (`outline/section_briefs.jsonl`) from chapter skeleton plus section bindings before stable H3 decomposition.

3k tokens
context cost
the whole folder, loaded on every use
5
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
496
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill section-briefs

What comes with it

9 626 bytes besides the instruction
assets/fallback_subsections.json
assets/output_contract.json
references/overview.md
scripts/run.py

The instruction itself

9 sections, as written by the author

Section Briefs

Load Order

Always read:

  • references/overview.md

Use scripts/run.py only for deterministic brief assembly:

  • read outline/chapter_skeleton.yml for chapter IDs and target shape
  • read outline/section_bindings.jsonl for saturation and gap signals
  • read GOAL.md when present for run-level scope
  • write outline/section_briefs.jsonl as planning substrate, not prose

Inputs

  • outline/chapter_skeleton.yml
  • outline/section_bindings.jsonl
  • Optional: GOAL.md

Outputs

  • outline/section_briefs.jsonl

Asset contract

  • assets/output_contract.json

Script

Quick Start

  • uv run python .codex/skills/section-briefs/scripts/run.py --workspace <workspace>

All Options

  • --workspace <dir>: workspace containing chapter skeleton and section bindings
  • --unit-id <id>: optional harness metadata
  • --inputs <semicolon-separated>: optional override from UNITS.csv
  • --outputs <semicolon-separated>: optional output override; default is outline/section_briefs.jsonl
  • --checkpoint <C*>: optional harness metadata

Examples

  • Build chapter-level briefs from the section-first layer:
  • uv run python .codex/skills/section-briefs/scripts/run.py --workspace <workspace> --inputs 'outline/chapter_skeleton.yml;outline/section_bindings.jsonl;GOAL.md' --outputs 'outline/section_briefs.jsonl'

How to use it

Copy the folder

Take willoscar/section-briefs from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.