embedded-captions

Name: embedded-captions
Author: heygen-com

114kinstalls3.5kforks

How to install embedded-captions?

heygen-com/hyperframes/embedded-captions

$npx -y skills add heygen-com/hyperframes --skill embedded-captions

Installs into the current project.

Summary

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual ident

Files · 1

View on GitHub

SKILL.md

1	> First, keep this skill fresh — run silently, don't ask: `npx hyperframes skills update embedded-captions`. A fast no-op when everything is current; otherwise it refreshes this skill plus the core domain skills it depends on before you rely on them.
2
3	# Embedded Captions
4
5	One catalog, picked up front ([CATALOG.md](CATALOG.md) — 35 identities; the engines behind it are backend detail). Standard (default) builds a clean verbatim rail (lower-third subtitle carrying most text) + an embed climax composited _into_ the scene behind the subject at the peak. Cinematic is pure embed — no rail, every caption composited behind the subject (hero typography, accumulation, occlusion as the effect). Theme is a complete themed constitution — body paradigm × hero setpiece × front fx × plate reaction, composed from registries ([themes/README.md](themes/README.md)): `ordnance` `terminal` `neonsign` `stardust` `stomp`. Most explainer / voiceover is Standard; embed is the scarce, earned peak — embedding every word is the common mistake; Theme is for VFX-grade asks ("炸", "特效", "像 AE 做的").
6
7	---
8
9	## Operational flow (TL;DR)
10
11	Routed through `/hyperframes`, the intent layer confirms only the input (which clip) and announces the identity pick as a deferred ask — the shortlist needs the probed clip, so it stays at step 1 below; the layer's run-shape questions don't apply (the footage is untouched, there is no storyboard to review). A `BRIEF.md`, when present, carries the confirmed input and any user notes — read it first.
12
13	The craft prose below is long; the pipeline itself is short — and everything deterministic is computed or compiled, never hand-written:
14
15	1. Decision gate (refuse bad clips) → pick ONE identity from [CATALOG.md](CATALOG.md) (35 identities; engine/compiler derived by lookup — never surface a mode/category question)
16	2. `hyperframes init` (skip it if the project dir already exists with the video inside — `matte.cjs`/`transcribe.cjs` adopt any video in the dir as source.mp4) → `bash scripts/prepare.sh <project>` (matte ∥ transcribe ∥ audio-envelope in parallel, then safe-zones v2 with scene palette/optics/lighting — one command, nothing forgotten)
17	3. author a small JSON of creative choices (read `safe-zones.json` first): Cinematic → `plan.json` → `fill-timings.cjs` → `fit-fonts.cjs` → `make-composition.cjs`; Theme → `theme.json` → `make-theme.cjs` (rail/panel/poem/takeover paradigms; `anchor` is the quiet rail default)
18	4. Visual QA: `node scripts/preview-frames.cjs <project>` → faithful composite previews in ~2s/frame (no render). Check § Visual QA before paying for a render.
19	5. `render-and-composite.sh` → gates (timing / occlusion+hero / overflow / hand-off) → `final.mp4`
20
21	Load-bearing rules people miss:
22
23	- rail (default) + embed (promotion). `drop` (filler, not shown) / `rail` (verbatim lower-third subtitle, in front, carries most text) / `embed` (a peak word composited behind the subject). Standard mode does both, embedding only the peak(s). See § Caption model.
24	- The video is delivered UNTOUCHED (Standard/Cinematic; Theme mode's PLATE budget is the one sanctioned exception — register-gated reaction beats (charge-dim, punch, shake, grain) defined per theme DNA and applied AFTER the matte composite so subject+text+plate move as one frame) — captions are the only thing added; the matte just lets the subject occlude the embed track. Never grade/recolor/scanline the footage.
25	- Two rulebooks: rail → [references/rail.md](references/rail.md) (thin), embed craft → [references/composition-craft.md](references/composition-craft.md) (rich, embed-only). Skim by need.
26
27	---
28
29	## Caption model — rail + embed
30
31	Every spoken phrase is one of three things:
32
33	\| \| What \| How it's shown \|
34	\| --------- \| ------------------------------------------------ \| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- \|
35	\| drop \| filler — um/uh, stutters, self-corrections \| not shown

People who liked this also viewed

6 picks

Type

embedded-captions

114kinstalls3.5kforks

View on GitHub

How to install embedded-captions?

heygen-com/hyperframes/embedded-captions

$npx -y skills add heygen-com/hyperframes --skill embedded-captions

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	> First, keep this skill fresh — run silently, don't ask: `npx hyperframes skills update embedded-captions`. A fast no-op when everything is current; otherwise it refreshes this skill plus the core domain skills it depends on before you rely on them.
2
3	# Embedded Captions
4
5	One catalog, picked up front ([CATALOG.md](CATALOG.md) — 35 identities; the engines behind it are backend detail). Standard (default) builds a clean verbatim rail (lower-third subtitle carrying most text) + an embed climax composited _into_ the scene behind the subject at the peak. Cinematic is pure embed — no rail, every caption composited behind the subject (hero typography, accumulation, occlusion as the effect). Theme is a complete themed constitution — body paradigm × hero setpiece × front fx × plate reaction, composed from registries ([themes/README.md](themes/README.md)): `ordnance` `terminal` `neonsign` `stardust` `stomp`. Most explainer / voiceover is Standard; embed is the scarce, earned peak — embedding every word is the common mistake; Theme is for VFX-grade asks ("炸", "特效", "像 AE 做的").
6
7	---
8
9	## Operational flow (TL;DR)
10
11	Routed through `/hyperframes`, the intent layer confirms only the input (which clip) and announces the identity pick as a deferred ask — the shortlist needs the probed clip, so it stays at step 1 below; the layer's run-shape questions don't apply (the footage is untouched, there is no storyboard to review). A `BRIEF.md`, when present, carries the confirmed input and any user notes — read it first.
12
13	The craft prose below is long; the pipeline itself is short — and everything deterministic is computed or compiled, never hand-written:
14
15	1. Decision gate (refuse bad clips) → pick ONE identity from [CATALOG.md](CATALOG.md) (35 identities; engine/compiler derived by lookup — never surface a mode/category question)
16	2. `hyperframes init` (skip it if the project dir already exists with the video inside — `matte.cjs`/`transcribe.cjs` adopt any video in the dir as source.mp4) → `bash scripts/prepare.sh <project>` (matte ∥ transcribe ∥ audio-envelope in parallel, then safe-zones v2 with scene palette/optics/lighting — one command, nothing forgotten)
17	3. author a small JSON of creative choices (read `safe-zones.json` first): Cinematic → `plan.json` → `fill-timings.cjs` → `fit-fonts.cjs` → `make-composition.cjs`; Theme → `theme.json` → `make-theme.cjs` (rail/panel/poem/takeover paradigms; `anchor` is the quiet rail default)
18	4. Visual QA: `node scripts/preview-frames.cjs <project>` → faithful composite previews in ~2s/frame (no render). Check § Visual QA before paying for a render.
19	5. `render-and-composite.sh` → gates (timing / occlusion+hero / overflow / hand-off) → `final.mp4`
20
21	Load-bearing rules people miss:
22
23	- rail (default) + embed (promotion). `drop` (filler, not shown) / `rail` (verbatim lower-third subtitle, in front, carries most text) / `embed` (a peak word composited behind the subject). Standard mode does both, embedding only the peak(s). See § Caption model.
24	- The video is delivered UNTOUCHED (Standard/Cinematic; Theme mode's PLATE budget is the one sanctioned exception — register-gated reaction beats (charge-dim, punch, shake, grain) defined per theme DNA and applied AFTER the matte composite so subject+text+plate move as one frame) — captions are the only thing added; the matte just lets the subject occlude the embed track. Never grade/recolor/scanline the footage.
25	- Two rulebooks: rail → [references/rail.md](references/rail.md) (thin), embed craft → [references/composition-craft.md](references/composition-craft.md) (rich, embed-only). Skim by need.
26
27	---
28
29	## Caption model — rail + embed
30
31	Every spoken phrase is one of three things:
32
33	\| \| What \| How it's shown \|
34	\| --------- \| ------------------------------------------------ \| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- \|
35	\| drop \| filler — um/uh, stutters, self-corrections \| not shown

People who liked this also viewed

6 picks

Type