to-narration
Installation
SKILL.md
To narration
Turn BEATS.md into NARRATION.md: the spoken version of the approved article and video structure. This pass changes language for the ear; it does not establish the author's argument for the first time.
Process
- Read
BEATS.md, its approvedcontent/ARTICLE.mdsource, the cited evidence needed for accuracy, and the resolved voice sources recorded by the article. Recompute the article approval digest and beats artifact digest; require them to match the stored articleapproved_digest, beatssource_digest, and beatsartifact_digest. Load every applicable writing-style skill or document that is available. Preserve each beat's job, claim, and handoff. - Write narration in natural, easy-to-say language. Use concrete subjects, actions, and changes to make events clear, so listeners can follow and understand the account as it unfolds. Preserve the author's voice while adapting reading prose into speech. When describing setup, configuration, or a later restart, distinguish the normal user path from project-specific restrictions and identify the actual change from earlier steps. Verify command aliases or script expansion before naming a different mechanism; carry exact commands and UI paths into scene planning rather than packing them into speech.
- Let visuals carry visible structure, comparison, and transformation. The narration supplies meaning the image cannot communicate alone.
- Mark paragraph-to-beat boundaries without adding visual instructions. Put unresolved pronunciation or factual questions in an
Open checkssection. - Write
NARRATION.md: