to-spec-beats
Installation
SKILL.md
To spec beats
Turn an approved content/ARTICLE.md into BEATS.md: the video's factual and narrative spine. The article owns what the work says; this pass decides what the viewer learns when. Later passes decide spoken wording and visuals.
Process
- Read
content/ARTICLE.md,content/TOPIC.mdwhen it exists, and the evidence needed to preserve their boundaries. Recompute each approved file's SHA-256 after removing only itsapproved_digest:line; continue only when the stored digest matches the current file and the article hasstatus: approved. When a user brings a complete article from outside this workflow, first place or adapt it ascontent/ARTICLE.mdusing the external-source contract from/boring-video; a separate topic contract is not required retroactively. - Inherit the audience, thesis, and scope from the approved article and topic contract when present. Define only the audience's prior knowledge, desired change in understanding, target duration, and the video's selection from the approved scope.
- Build the reverse-iceberg arc: hook in viewer language, value or answer by beat two, then evidence, mechanism, implications, and close. Reorder, compress, or omit article material for the medium while preserving meaning and boundaries.
- Give every beat one cognitive job. Split beats that require two independent realizations; remove beats whose job does not trace to the approved thesis.
- Write
BEATS.mdbesidecontent/using this shape: