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

  1. Read content/ARTICLE.md, content/TOPIC.md when it exists, and the evidence needed to preserve their boundaries. Recompute each approved file's SHA-256 after removing only its approved_digest: line; continue only when the stored digest matches the current file and the article has status: approved. When a user brings a complete article from outside this workflow, first place or adapt it as content/ARTICLE.md using the external-source contract from /boring-video; a separate topic contract is not required retroactively.
  2. 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.
  3. 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.
  4. Give every beat one cognitive job. Split beats that require two independent realizations; remove beats whose job does not trace to the approved thesis.
  5. Write BEATS.md beside content/ using this shape:
Installs
28
GitHub Stars
164
First Seen
Aug 14, 2026
to-spec-beats — sugarforever/boring-video-studio