to-spec-beats
Installation
SKILL.md
To spec beats
Turn source material into BEATS.md: the video's factual and narrative spine. This pass decides what the viewer learns and in what order; later passes decide wording and visuals.
Process
- Read every supplied source and existing fact-check. Resolve material factual uncertainty before treating a claim as a beat.
- Define the audience, prior knowledge, one-sentence thesis, desired change in understanding, target duration, and scope boundary.
- Build the reverse-iceberg arc: hook in viewer language, value or answer by beat two, then evidence, mechanism, implications, and close.
- Give every beat one cognitive job. Split beats that require two independent realizations; remove beats whose job does not trace to the thesis.
- Write
BEATS.mdbeside the source material using this shape:
---
audience: ...
thesis: ...
viewer_shift: ... → ...
target_duration: ...
---