Files
hyperframes/skills/hyperframes-core/references/script-format.md
T
heygengenesis[bot]andmiguel.sierra 4aa6e17b76 docs: fix skill documentation cross-references (#3920)
Co-authored-by: miguel.sierra <229591595+miguel-heygen@users.noreply.github.com>

Co-authored-by: heygengenesis[bot] <262951085+heygengenesis[bot]@users.noreply.github.com>
2026-09-13 03:19:21 +00:00

2.8 KiB
Raw Blame History

SCRIPT.md — locked narration (optional)

The locked narration for a project: the final spoken lines + voice + delivery. It is an optional plan-layer file — a video with no narration (bgm-only, silent overlay) has none. The storyboard's per-frame voiceover is the lighter, editable guide; SCRIPT.md is the commit. (Storyboard format → references/storyboard-format.md.)

This file defines the SCRIPT.md shape only. Synthesizing the spoken lines into audio is a capability owned by media-use → ../../media-use/audio/references/tts.md.

Free-form markdown — there is no strict parser; the Studio renders it read-only beside the Storyboard board, and the TTS step extracts the indented spoken lines.

Shape

A header block, then one section per spoken line.

Part Holds
Header **Voice:** (provider + voice), **Voice settings:** (e.g. stability / similarity / style), **Voice direction:** (overall delivery)
## Line N — <label> (Frame N) one spoken line, tied to its storyboard frame
**Time:** the board's rough window — a guide, not authoritative (real timing comes from TTS word timestamps)
**Delivery:** per-line delivery note
indented block the spoken text — the only part fed to TTS

Example

# SCRIPT — acme-launch

**Voice:** Rachel (ElevenLabs)
**Voice settings:** stability 0.35 · similarity 0.75 · style 0.20
**Voice direction:** Confident, warm, a little playful.

---

## Line 1 — Hook (Frame 1)

**Time:** 0.0 – 3.0s
**Delivery:** Land the promise on the beat.

    Ship a launch video in an afternoon.

## Line 2 — The problem (Frame 2)

**Time:** 3.0 – 7.0s
**Delivery:** Wry, a touch tired.

    The old way? Prompt, wait twenty minutes, get something that misses.

To TTS

Feed each line's spoken text to the provider documented in media-use/audio/references/tts.md. The hyperframes tts command is Kokoro-only; use its --voice flag, or use the bundled HeyGen helper when word timestamps are required. Real per-word timing replaces the **Time:** guides.