to-narration
Use when writing or revising spoken narration from complete, lineage-valid video beats, including scripts that must remain open to later visual direction.
- Installs
- 39
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/sugarforever/boring-video-studio --skill to-narration- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads to-narration automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
- 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:
---
source: BEATS.md
source_digest: sha256:<BEATS artifact_digest>
content_source: content/ARTICLE.md
content_digest: sha256:<ARTICLE approved_digest>
artifact_digest: sha256:<digest>
status: draft
target_duration: ...
---
## B01 — Title
<a id="b01-p01"></a>
Spoken paragraph.
Compute artifact_digest as SHA-256 of the complete narration file after removing only the artifact_digest: line. Downstream stages must recompute it before use.
- Give every paragraph a stable
<beat-id>-pNNanchor. Preserve anchors when rewriting that paragraph; assign a new anchor when inserting one. - Read it aloud or estimate at the user's known speaking rate. Revise until every beat fits its budget and the full draft fits the target.
Every material fact, viewpoint, and conclusion must trace through its beat to the approved article. When speech needs content the article does not establish, immediately return content/ARTICLE.md to status: draft and revise it there; return content/TOPIC.md to draft too when the change affects a locked topic decision. Renew the approvals defined by those upstream files, update BEATS.md to match, and only then use the content in narration. BEATS.md has no separate approval state in this workflow.
Before presenting NARRATION.md or any later revision, follow ../boring-video/references/markdown-review.md. Present the authoritative Markdown for inspection without starting or replacing HyperFrames' later voice-review loop.
The draft is complete when it is ready for visual planning, every material sentence traces to both a beat and the approved article, no later visual has been prematurely prescribed, and the Markdown review completion criterion is satisfied. The shared HyperFrames project owns review timing and the voice-ready narration version once /to-scenes begins.
FAQ
What does the to-narration skill do?
Use when writing or revising spoken narration from complete, lineage-valid video beats, including scripts that must remain open to later visual direction.
How do I install to-narration?
Run npx skills add https://github.com/sugarforever/boring-video-studio --skill to-narration in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/to-narration/ (personal) or .claude/skills/to-narration/ (project).
Which AI agents can use to-narration?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is to-narration safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains to-narration?
It is published by sugarforever in sugarforever/boring-video-studio. It has 39 recorded installs.
More from sugarforever/boring-video-studio
verysmallwoods-video
sugarforever/boring-video-studio
Open the skill to read its SKILL.md instructions.
to-scenes
sugarforever/boring-video-studio
Open the skill to read its SKILL.md instructions.
to-storyboard
sugarforever/boring-video-studio
Open the skill to read its SKILL.md instructions.
boring-video
sugarforever/boring-video-studio
Use when developing a content-driven video from a topic, research bundle, article, or draft, or when routing an existing script or non-argument video into HyperFrames production.
to-spec-beats
sugarforever/boring-video-studio
Open the skill to read its SKILL.md instructions.
to-video
sugarforever/boring-video-studio
Open the skill to read its SKILL.md instructions.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image