[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M737FZYMAB6K38JSXH7GG4DX":3,"skill-same:01M737FZYMAB6K38JSXH7GG4DX":100},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":54,"install":55,"resources":67},"01M737FZYMAB6K38JSXH7GG4DX","hyperframes",null,"Render MP4\u002FWebM videos from HTML compositions.","ashneil12\u002Fvanilla-hermes-agent-canary","ashneil12","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F49880658?v=4","01M7378BQ9W161EPENEWBYAQNN","01M7378BRDJG8SFS93FG4V6BWY",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: hyperframes\ndescription: Render MP4\u002FWebM videos from HTML compositions.\nversion: 1.0.0\nauthor: heygen-com\nlicense: Apache-2.0\nplatforms: [linux, macos, windows]\nprerequisites:\n  commands: [node, ffmpeg, npx]\nmetadata:\n  hermes:\n    tags: [creative, video, animation, html, gsap, motion-graphics]\n    related_skills: [manim-video, meme-generation]\n    category: creative\n    requires_toolsets: [terminal]\n---\n\n# HyperFrames\n\nHTML is the source of truth for video. A composition is an HTML file with `data-*` attributes for timing, a GSAP timeline for animation, and CSS for appearance. The HyperFrames engine captures the page frame-by-frame and encodes to MP4\u002FWebM with FFmpeg.\n\n**Complement to `manim-video`:** Use `manim-video` for mathematical\u002Fgeometric explainers (equations, 3B1B-style). Use `hyperframes` for motion-graphics, talking-head with captions, product tours, social overlays, shader transitions, and anything driven by real video\u002Faudio media.\n\n## When to Use\n\n- User asks for a rendered video from text, a script, or a website\n- Animated title cards, lower thirds, or typographic intros\n- Captioned narration video (TTS + captions synced to waveform)\n- Audio-reactive visuals (beat sync, spectrum bars, pulsing glow)\n- Scene-to-scene transitions (crossfade, wipe, shader warp, flash-through-white)\n- Social overlays (Instagram\u002FTikTok\u002FYouTube style)\n- Website-to-video pipeline (capture a URL, produce a promo)\n- Any HTML\u002FCSS\u002FJS animation that must render deterministically to a video file\n\nDo **not** use this skill for:\n- Pure math\u002Fequation animation (→ `manim-video`)\n- Image generation or memes (→ `meme-generation`, image models)\n- Live video conferencing or streaming\n\n## Quick Reference\n\n```bash\nnpx hyperframes init my-video               # scaffold a project\ncd my-video\nnpx hyperframes lint                        # validate before preview\u002Frender\nnpx hyperframes preview                     # live-reload preview (long-lived server, port 3002)\nnpx hyperframes render --output final.mp4   # render to MP4\nnpx hyperframes doctor                      # diagnose environment issues\n```\n\n`preview` is a **long-lived** Next.js server that holds Chrome render workers open. Always stop it when done (see [Cleanup](#cleanup)) — a forgotten preview keeps idle `chrome-headless-shell` workers alive that, on GPU-less hosts (WSL, containers, CI), spin a CPU core each indefinitely via software WebGL (swiftshader).\n\nRender flags: `--quality draft|standard|high` · `--fps 24|30|60` · `--format mp4|webm` · `--docker` (reproducible) · `--strict`.\n\nFull CLI reference: [references\u002Fcli.md](references\u002Fcli.md).\n\n## Setup (one-time)\n\n```bash\nbash \"$(dirname \"$(find ~\u002F.hermes\u002Fskills -path '*\u002Fhyperframes\u002FSKILL.md' 2>\u002Fdev\u002Fnull | head -1)\")\u002Fscripts\u002Fsetup.sh\"\n```\n\nThe script:\n1. Verifies Node.js >= 22 and FFmpeg are installed (prints fix instructions if not).\n2. Installs the `hyperframes` CLI globally (`npm install -g hyperframes@>=0.4.2`).\n3. Pre-caches `chrome-headless-shell` via Puppeteer — **required** for best-quality rendering via Chrome's `HeadlessExperimental.beginFrame` capture path.\n4. Runs `npx hyperframes doctor` and reports the result.\n\nSee [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md) if setup fails.\n\n## Procedure\n\n### 1. Plan before writing HTML\n\nBefore touching code, articulate at a high level:\n- **What** — narrative arc, key moments, emotional beats\n- **Structure** — compositions, tracks (video\u002Faudio\u002Foverlays), durations\n- **Visual identity** — colors, fonts, motion character (explosive \u002F cinematic \u002F fluid \u002F technical)\n- **Hero frame** — for each scene, the moment when the most elements are simultaneously visible. This is the static layout you'll build first.\n\n**Visual Identity Gate (HARD-GATE).** Before writing ANY composition HTML, a visual identity must be defined. Do NOT write compositions with default or generic colors (`#333`, `#3b82f6`, `Roboto` are tells that this step was skipped). Check in order:\n\n1. **`DESIGN.md` at project root?** → Use its exact colors, fonts, motion rules, and \"What NOT to Do\" constraints.\n2. **User named a style** (e.g. \"Swiss Pulse\", \"dark and techy\", \"luxury brand\")? → Generate a minimal `DESIGN.md` with `## Style Prompt`, `## Colors` (3-5 hex with roles), `## Typography` (1-2 families), `## What NOT to Do` (3-5 anti-patterns).\n3. **None of the above?** → Ask 3 questions before writing any HTML:\n   - Mood? (explosive \u002F cinematic \u002F fluid \u002F technical \u002F chaotic \u002F warm)\n   - Light or dark canvas?\n   - Any brand colors, fonts, or visual references?\n\n   Then generate a `DESIGN.md` from the answers. Every composition must trace its palette and typography back to `DESIGN.md` or explicit user direction.\n\n### 2. Scaffold\n\n```bash\nnpx hyperframes init my-video --non-interactive\n```\n\nTemplates: `blank`, `warm-grain`, `play-mode`, `swiss-grid`, `vignelli`, `decision-tree`, `kinetic-type`, `product-promo`, `nyt-graph`. Pass `--example \u003Cname>` to pick one, `--video clip.mp4` or `--audio track.mp3` to seed with media.\n\n### 3. Layout before animation\n\nWrite the static HTML+CSS for the **hero frame first** — no GSAP yet. The `.scene-content` container must fill the scene (`width:100%; height:100%; padding:Npx`) with `display:flex` + `gap`. Use padding to push content inward — never `position: absolute; top: Npx` on a content container (content overflows when taller than the remaining space).\n\nOnly after the hero frame looks right, add `gsap.from()` entrances (animate **to** the CSS position) and `gsap.to()` exits (animate **from** it).\n\nSee [references\u002Fcomposition.md](references\u002Fcomposition.md) for the full data-attribute schema and composition rules.\n\n### 4. Animate with GSAP\n\nEvery composition must:\n- Register its timeline: `window.__timelines[\"\u003Ccomposition-id>\"] = tl`\n- Start paused: `gsap.timeline({ paused: true })` — the player controls playback\n- Use finite `repeat` values (no `repeat: -1` — breaks the capture engine). Calculate: `repeat: Math.ceil(duration \u002F cycleDuration) - 1`.\n- Be deterministic — no `Math.random()`, `Date.now()`, or wall-clock logic. Use a seeded PRNG if you need pseudo-randomness.\n- Build synchronously — no `async`\u002F`await`, `setTimeout`, or Promises around timeline construction.\n\nSee [references\u002Fgsap.md](references\u002Fgsap.md) for the core GSAP API (tweens, eases, stagger, timelines).\n\n### 5. Transitions between scenes\n\nMulti-scene compositions require transitions. Rules:\n1. **Always use a transition between scenes** — no jump cuts.\n2. **Always use entrance animations** on every scene element (`gsap.from(...)`).\n3. **Never use exit animations** except on the final scene — the transition IS the exit.\n4. The final scene may fade out.\n\nUse `npx hyperframes add \u003Ctransition-name>` to install shader transitions (`flash-through-white`, `liquid-wipe`, etc.). Full list: `npx hyperframes add --list`.\n\n### 6. Audio, captions, TTS, audio-reactive, highlighting\n\n- **Audio:** always a separate `\u003Caudio>` element (video is `muted playsinline`).\n- **TTS:** `npx hyperframes tts \"Script text\" --voice af_nova --output narration.wav`. List voices with `--list`. Voice ID first letter encodes language (`a`\u002F`b`=English, `e`=Spanish, `f`=French, `j`=Japanese, `z`=Mandarin, etc.) — the CLI auto-infers the phonemizer locale; pass `--lang` only to override. Non-English phonemization requires `espeak-ng` installed system-wide.\n- **Captions:** `npx hyperframes transcribe narration.wav` → word-level transcript. Pick style from the transcript tone (hype \u002F corporate \u002F tutorial \u002F storytelling \u002F social — see the table in `references\u002Ffeatures.md`). **Language rule:** never use `.en` whisper models unless the audio is confirmed English — `.en` translates non-English audio instead of transcribing it. Every caption group MUST have a hard `tl.set(el, { opacity: 0, visibility: \"hidden\" }, group.end)` kill after its exit tween — otherwise groups leak visible into later ones.\n- **Audio-reactive visuals:** pre-extract audio bands (bass \u002F mid \u002F treble) and sample per-frame inside the timeline with a `for` loop of `tl.call(draw, [], f \u002F fps)` — a single long tween does NOT react to audio. Map bass → `scale` (pulse), treble → `textShadow`\u002F`boxShadow` (glow), overall amplitude → `opacity`\u002F`y`\u002F`backgroundColor`. Avoid equalizer-bar clichés — let content guide the visual, audio drive its behavior.\n- **Marker-style highlighting:** highlight, circle, burst, scribble, sketchout effects for text emphasis are deterministic CSS+GSAP — see `references\u002Ffeatures.md#marker-highlighting`. Fully seekable, no animated SVG filters.\n- **Scene transitions:** every multi-scene composition MUST use transitions (no jump cuts). Pick from CSS primitives (push slide, blur crossfade, zoom through, staggered blocks) or shader transitions (`flash-through-white`, `liquid-wipe`, `cross-warp-morph`, `chromatic-split`, etc.) via `npx hyperframes add`. Mood and energy tables live in `references\u002Ffeatures.md#transitions`. Do not mix CSS and shader transitions in the same composition.\n\n### 7. Lint, validate, inspect, preview, render\n\n```bash\nnpx hyperframes lint              # catches missing data-composition-id, overlapping tracks, unregistered timelines\nnpx hyperframes validate          # WCAG contrast audit at 5 timestamps\nnpx hyperframes inspect           # visual layout audit — overflow, off-frame elements, occluded text\nnpx hyperframes preview           # live browser preview\nnpx hyperframes render --quality draft --output draft.mp4    # fast iteration\nnpx hyperframes render --quality high --output final.mp4     # final delivery\n```\n\n`hyperframes validate` samples background pixels behind every text element and warns on contrast ratios below 4.5:1 (or 3:1 for large text). `hyperframes inspect` is the layout-side companion — runs the page at multiple timestamps and flags issues that a static lint can't see (a caption that wraps past the safe area only at 4.5s, a card that overflows when its title is the longest variant, an element that ends up behind a transition shader). Run `inspect` especially on compositions with speech bubbles, cards, captions, or tight typography.\n\n### 8. Website-to-video (if the user gives a URL)\n\nUse the 7-step capture-to-video workflow in [references\u002Fwebsite-to-video.md](references\u002Fwebsite-to-video.md): capture → DESIGN.md → SCRIPT.md → storyboard → composition → render → deliver.\n\n## Cleanup\n\n`render` is one-shot (workers exit when it finishes). `preview` is **not** — it runs a background Next.js server that keeps Chrome workers resident until you stop it. Never leave one running: on GPU-less hosts each idle worker's swiftshader process pegs a CPU core, and a preview left open for days stacks up multiple.\n\nStop a preview when the user is done reviewing (or before starting a new one):\n\n```bash\npkill -f \"hyperframes.*preview\"     # the Studio server (frees port 3002)\npkill -f chrome-headless-shell      # its render workers; only safe if nothing else uses them\n```\n\nIf unsure whether other tools use `chrome-headless-shell`, check first: `pgrep -af chrome-headless-shell`. Recover a wedged host (many idle workers spinning CPU) the same way — see [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md#runaway-cpu-from-leftover-preview-workers).\n\n## Pitfalls\n\n- **Leaving `preview` running** — it's a long-lived server holding Chrome workers; on WSL\u002Fcontainers\u002FCI those idle workers spin a CPU core each (software WebGL). Stop it when done — see [Cleanup](#cleanup).\n\n- **`HeadlessExperimental.beginFrame' wasn't found`** — Chromium 147+ removed this protocol. Ensure you're on `hyperframes@>=0.4.2` (auto-detects and falls back to screenshot mode). Escape hatch: `export PRODUCER_FORCE_SCREENSHOT=true`. See [hyperframes#294](https:\u002F\u002Fgithub.com\u002Fheygen-com\u002Fhyperframes\u002Fissues\u002F294) and [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md).\n- **System Chrome (not `chrome-headless-shell`)** — renders hang for 120s then timeout. Run `npx puppeteer browsers install chrome-headless-shell` (setup.sh does this). `hyperframes doctor` reports which binary will be used.\n- **`repeat: -1` anywhere** — breaks the capture engine. Always compute a finite repeat count.\n- **`gsap.set()` on clip elements that enter later** — the element doesn't exist at page load. Use `tl.set(selector, vars, timePosition)` inside the timeline instead, at or after the clip's `data-start`.\n- **`\u003Cbr>` inside content text** — forced breaks don't know the rendered font width, so natural wrap + `\u003Cbr>` double-breaks. Use `max-width` to let text wrap. Exception: short display titles where each word is deliberately on its own line.\n- **Animating `visibility` or `display`** — GSAP can't tween these. Use `autoAlpha` (handles both visibility and opacity).\n- **Calling `video.play()` or `audio.play()`** — the framework owns playback. Never call these yourself.\n- **Building timelines async** — the capture engine reads `window.__timelines` synchronously after page load. Never wrap timeline construction in `async`, `setTimeout`, or a Promise.\n- **Standalone `index.html` wrapped in `\u003Ctemplate>`** — hides all content from the browser. Only **sub-compositions** loaded via `data-composition-src` use `\u003Ctemplate>`.\n- **Using video for audio** — always muted `\u003Cvideo>` + separate `\u003Caudio>`.\n\n## Verification\n\nBefore and after rendering:\n\n1. **Lint + validate + inspect pass:** `npx hyperframes lint --strict && npx hyperframes validate && npx hyperframes inspect` (lint catches structural issues, validate catches contrast, inspect catches visual layout \u002F overflow issues — see troubleshooting.md if warnings appear).\n2. **Animation choreography** — for new compositions or significant animation changes, run the animation map. `npx hyperframes init` copies the skill scripts into the project, so the path is project-local:\n   ```bash\n   node skills\u002Fhyperframes\u002Fscripts\u002Fanimation-map.mjs \u003Ccomposition-dir> \\\n     --out \u003Ccomposition-dir>\u002F.hyperframes\u002Fanim-map\n   ```\n   Outputs a single `animation-map.json` with per-tween summaries, ASCII Gantt timeline, stagger detection, dead zones (>1s with no animation), element lifecycles, and flags (`offscreen`, `collision`, `invisible`, `paced-fast` \u003C0.2s, `paced-slow` >2s). Scan summaries and flags — fix or justify each. Skip on small edits.\n3. **File exists + non-zero:** `ls -lh final.mp4`.\n4. **Duration matches `data-duration`:** `ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 final.mp4`.\n5. **Visual check:** extract a mid-composition frame: `ffmpeg -i final.mp4 -ss 00:00:05 -vframes 1 preview.png`.\n6. **Audio present if expected:** `ffprobe -v error -show_streams -select_streams a -of default=nw=1:nk=1 final.mp4 | head -1`.\n\nIf `hyperframes render` fails, run `npx hyperframes doctor` and attach its output when reporting.\n\n## References\n\n- [composition.md](references\u002Fcomposition.md) — data attributes, timeline contract, non-negotiable rules, typography\u002Fasset rules\n- [cli.md](references\u002Fcli.md) — every CLI command (init, capture, lint, validate, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, benchmark)\n- [gsap.md](references\u002Fgsap.md) — GSAP core API for HyperFrames (tweens, eases, stagger, timelines, matchMedia)\n- [features.md](references\u002Ffeatures.md) — captions, TTS, audio-reactive, marker highlighting, transitions (load on demand)\n- [website-to-video.md](references\u002Fwebsite-to-video.md) — 7-step capture-to-video workflow\n- [troubleshooting.md](references\u002Ftroubleshooting.md) — OpenClaw fix, env vars, common render errors\n","# HyperFrames\n\nHTML is the source of truth for video. A composition is an HTML file with `data-*` attributes for timing, a GSAP timeline for animation, and CSS for appearance. The HyperFrames engine captures the page frame-by-frame and encodes to MP4\u002FWebM with FFmpeg.\n\n**Complement to `manim-video`:** Use `manim-video` for mathematical\u002Fgeometric explainers (equations, 3B1B-style). Use `hyperframes` for motion-graphics, talking-head with captions, product tours, social overlays, shader transitions, and anything driven by real video\u002Faudio media.\n\n## When to Use\n\n- User asks for a rendered video from text, a script, or a website\n- Animated title cards, lower thirds, or typographic intros\n- Captioned narration video (TTS + captions synced to waveform)\n- Audio-reactive visuals (beat sync, spectrum bars, pulsing glow)\n- Scene-to-scene transitions (crossfade, wipe, shader warp, flash-through-white)\n- Social overlays (Instagram\u002FTikTok\u002FYouTube style)\n- Website-to-video pipeline (capture a URL, produce a promo)\n- Any HTML\u002FCSS\u002FJS animation that must render deterministically to a video file\n\nDo **not** use this skill for:\n- Pure math\u002Fequation animation (→ `manim-video`)\n- Image generation or memes (→ `meme-generation`, image models)\n- Live video conferencing or streaming\n\n## Quick Reference\n\n```bash\nnpx hyperframes init my-video               # scaffold a project\ncd my-video\nnpx hyperframes lint                        # validate before preview\u002Frender\nnpx hyperframes preview                     # live-reload preview (long-lived server, port 3002)\nnpx hyperframes render --output final.mp4   # render to MP4\nnpx hyperframes doctor                      # diagnose environment issues\n```\n\n`preview` is a **long-lived** Next.js server that holds Chrome render workers open. Always stop it when done (see [Cleanup](#cleanup)) — a forgotten preview keeps idle `chrome-headless-shell` workers alive that, on GPU-less hosts (WSL, containers, CI), spin a CPU core each indefinitely via software WebGL (swiftshader).\n\nRender flags: `--quality draft|standard|high` · `--fps 24|30|60` · `--format mp4|webm` · `--docker` (reproducible) · `--strict`.\n\nFull CLI reference: [references\u002Fcli.md](references\u002Fcli.md).\n\n## Setup (one-time)\n\n```bash\nbash \"$(dirname \"$(find ~\u002F.hermes\u002Fskills -path '*\u002Fhyperframes\u002FSKILL.md' 2>\u002Fdev\u002Fnull | head -1)\")\u002Fscripts\u002Fsetup.sh\"\n```\n\nThe script:\n1. Verifies Node.js >= 22 and FFmpeg are installed (prints fix instructions if not).\n2. Installs the `hyperframes` CLI globally (`npm install -g hyperframes@>=0.4.2`).\n3. Pre-caches `chrome-headless-shell` via Puppeteer — **required** for best-quality rendering via Chrome's `HeadlessExperimental.beginFrame` capture path.\n4. Runs `npx hyperframes doctor` and reports the result.\n\nSee [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md) if setup fails.\n\n## Procedure\n\n### 1. Plan before writing HTML\n\nBefore touching code, articulate at a high level:\n- **What** — narrative arc, key moments, emotional beats\n- **Structure** — compositions, tracks (video\u002Faudio\u002Foverlays), durations\n- **Visual identity** — colors, fonts, motion character (explosive \u002F cinematic \u002F fluid \u002F technical)\n- **Hero frame** — for each scene, the moment when the most elements are simultaneously visible. This is the static layout you'll build first.\n\n**Visual Identity Gate (HARD-GATE).** Before writing ANY composition HTML, a visual identity must be defined. Do NOT write compositions with default or generic colors (`#333`, `#3b82f6`, `Roboto` are tells that this step was skipped). Check in order:\n\n1. **`DESIGN.md` at project root?** → Use its exact colors, fonts, motion rules, and \"What NOT to Do\" constraints.\n2. **User named a style** (e.g. \"Swiss Pulse\", \"dark and techy\", \"luxury brand\")? → Generate a minimal `DESIGN.md` with `## Style Prompt`, `## Colors` (3-5 hex with roles), `## Typography` (1-2 families), `## What NOT to Do` (3-5 anti-patterns).\n3. **None of the above?** → Ask 3 questions before writing any HTML:\n   - Mood? (explosive \u002F cinematic \u002F fluid \u002F technical \u002F chaotic \u002F warm)\n   - Light or dark canvas?\n   - Any brand colors, fonts, or visual references?\n\n   Then generate a `DESIGN.md` from the answers. Every composition must trace its palette and typography back to `DESIGN.md` or explicit user direction.\n\n### 2. Scaffold\n\n```bash\nnpx hyperframes init my-video --non-interactive\n```\n\nTemplates: `blank`, `warm-grain`, `play-mode`, `swiss-grid`, `vignelli`, `decision-tree`, `kinetic-type`, `product-promo`, `nyt-graph`. Pass `--example \u003Cname>` to pick one, `--video clip.mp4` or `--audio track.mp3` to seed with media.\n\n### 3. Layout before animation\n\nWrite the static HTML+CSS for the **hero frame first** — no GSAP yet. The `.scene-content` container must fill the scene (`width:100%; height:100%; padding:Npx`) with `display:flex` + `gap`. Use padding to push content inward — never `position: absolute; top: Npx` on a content container (content overflows when taller than the remaining space).\n\nOnly after the hero frame looks right, add `gsap.from()` entrances (animate **to** the CSS position) and `gsap.to()` exits (animate **from** it).\n\nSee [references\u002Fcomposition.md](references\u002Fcomposition.md) for the full data-attribute schema and composition rules.\n\n### 4. Animate with GSAP\n\nEvery composition must:\n- Register its timeline: `window.__timelines[\"\u003Ccomposition-id>\"] = tl`\n- Start paused: `gsap.timeline({ paused: true })` — the player controls playback\n- Use finite `repeat` values (no `repeat: -1` — breaks the capture engine). Calculate: `repeat: Math.ceil(duration \u002F cycleDuration) - 1`.\n- Be deterministic — no `Math.random()`, `Date.now()`, or wall-clock logic. Use a seeded PRNG if you need pseudo-randomness.\n- Build synchronously — no `async`\u002F`await`, `setTimeout`, or Promises around timeline construction.\n\nSee [references\u002Fgsap.md](references\u002Fgsap.md) for the core GSAP API (tweens, eases, stagger, timelines).\n\n### 5. Transitions between scenes\n\nMulti-scene compositions require transitions. Rules:\n1. **Always use a transition between scenes** — no jump cuts.\n2. **Always use entrance animations** on every scene element (`gsap.from(...)`).\n3. **Never use exit animations** except on the final scene — the transition IS the exit.\n4. The final scene may fade out.\n\nUse `npx hyperframes add \u003Ctransition-name>` to install shader transitions (`flash-through-white`, `liquid-wipe`, etc.). Full list: `npx hyperframes add --list`.\n\n### 6. Audio, captions, TTS, audio-reactive, highlighting\n\n- **Audio:** always a separate `\u003Caudio>` element (video is `muted playsinline`).\n- **TTS:** `npx hyperframes tts \"Script text\" --voice af_nova --output narration.wav`. List voices with `--list`. Voice ID first letter encodes language (`a`\u002F`b`=English, `e`=Spanish, `f`=French, `j`=Japanese, `z`=Mandarin, etc.) — the CLI auto-infers the phonemizer locale; pass `--lang` only to override. Non-English phonemization requires `espeak-ng` installed system-wide.\n- **Captions:** `npx hyperframes transcribe narration.wav` → word-level transcript. Pick style from the transcript tone (hype \u002F corporate \u002F tutorial \u002F storytelling \u002F social — see the table in `references\u002Ffeatures.md`). **Language rule:** never use `.en` whisper models unless the audio is confirmed English — `.en` translates non-English audio instead of transcribing it. Every caption group MUST have a hard `tl.set(el, { opacity: 0, visibility: \"hidden\" }, group.end)` kill after its exit tween — otherwise groups leak visible into later ones.\n- **Audio-reactive visuals:** pre-extract audio bands (bass \u002F mid \u002F treble) and sample per-frame inside the timeline with a `for` loop of `tl.call(draw, [], f \u002F fps)` — a single long tween does NOT react to audio. Map bass → `scale` (pulse), treble → `textShadow`\u002F`boxShadow` (glow), overall amplitude → `opacity`\u002F`y`\u002F`backgroundColor`. Avoid equalizer-bar clichés — let content guide the visual, audio drive its behavior.\n- **Marker-style highlighting:** highlight, circle, burst, scribble, sketchout effects for text emphasis are deterministic CSS+GSAP — see `references\u002Ffeatures.md#marker-highlighting`. Fully seekable, no animated SVG filters.\n- **Scene transitions:** every multi-scene composition MUST use transitions (no jump cuts). Pick from CSS primitives (push slide, blur crossfade, zoom through, staggered blocks) or shader transitions (`flash-through-white`, `liquid-wipe`, `cross-warp-morph`, `chromatic-split`, etc.) via `npx hyperframes add`. Mood and energy tables live in `references\u002Ffeatures.md#transitions`. Do not mix CSS and shader transitions in the same composition.\n\n### 7. Lint, validate, inspect, preview, render\n\n```bash\nnpx hyperframes lint              # catches missing data-composition-id, overlapping tracks, unregistered timelines\nnpx hyperframes validate          # WCAG contrast audit at 5 timestamps\nnpx hyperframes inspect           # visual layout audit — overflow, off-frame elements, occluded text\nnpx hyperframes preview           # live browser preview\nnpx hyperframes render --quality draft --output draft.mp4    # fast iteration\nnpx hyperframes render --quality high --output final.mp4     # final delivery\n```\n\n`hyperframes validate` samples background pixels behind every text element and warns on contrast ratios below 4.5:1 (or 3:1 for large text). `hyperframes inspect` is the layout-side companion — runs the page at multiple timestamps and flags issues that a static lint can't see (a caption that wraps past the safe area only at 4.5s, a card that overflows when its title is the longest variant, an element that ends up behind a transition shader). Run `inspect` especially on compositions with speech bubbles, cards, captions, or tight typography.\n\n### 8. Website-to-video (if the user gives a URL)\n\nUse the 7-step capture-to-video workflow in [references\u002Fwebsite-to-video.md](references\u002Fwebsite-to-video.md): capture → DESIGN.md → SCRIPT.md → storyboard → composition → render → deliver.\n\n## Cleanup\n\n`render` is one-shot (workers exit when it finishes). `preview` is **not** — it runs a background Next.js server that keeps Chrome workers resident until you stop it. Never leave one running: on GPU-less hosts each idle worker's swiftshader process pegs a CPU core, and a preview left open for days stacks up multiple.\n\nStop a preview when the user is done reviewing (or before starting a new one):\n\n```bash\npkill -f \"hyperframes.*preview\"     # the Studio server (frees port 3002)\npkill -f chrome-headless-shell      # its render workers; only safe if nothing else uses them\n```\n\nIf unsure whether other tools use `chrome-headless-shell`, check first: `pgrep -af chrome-headless-shell`. Recover a wedged host (many idle workers spinning CPU) the same way — see [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md#runaway-cpu-from-leftover-preview-workers).\n\n## Pitfalls\n\n- **Leaving `preview` running** — it's a long-lived server holding Chrome workers; on WSL\u002Fcontainers\u002FCI those idle workers spin a CPU core each (software WebGL). Stop it when done — see [Cleanup](#cleanup).\n\n- **`HeadlessExperimental.beginFrame' wasn't found`** — Chromium 147+ removed this protocol. Ensure you're on `hyperframes@>=0.4.2` (auto-detects and falls back to screenshot mode). Escape hatch: `export PRODUCER_FORCE_SCREENSHOT=true`. See [hyperframes#294](https:\u002F\u002Fgithub.com\u002Fheygen-com\u002Fhyperframes\u002Fissues\u002F294) and [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md).\n- **System Chrome (not `chrome-headless-shell`)** — renders hang for 120s then timeout. Run `npx puppeteer browsers install chrome-headless-shell` (setup.sh does this). `hyperframes doctor` reports which binary will be used.\n- **`repeat: -1` anywhere** — breaks the capture engine. Always compute a finite repeat count.\n- **`gsap.set()` on clip elements that enter later** — the element doesn't exist at page load. Use `tl.set(selector, vars, timePosition)` inside the timeline instead, at or after the clip's `data-start`.\n- **`\u003Cbr>` inside content text** — forced breaks don't know the rendered font width, so natural wrap + `\u003Cbr>` double-breaks. Use `max-width` to let text wrap. Exception: short display titles where each word is deliberately on its own line.\n- **Animating `visibility` or `display`** — GSAP can't tween these. Use `autoAlpha` (handles both visibility and opacity).\n- **Calling `video.play()` or `audio.play()`** — the framework owns playback. Never call these yourself.\n- **Building timelines async** — the capture engine reads `window.__timelines` synchronously after page load. Never wrap timeline construction in `async`, `setTimeout`, or a Promise.\n- **Standalone `index.html` wrapped in `\u003Ctemplate>`** — hides all content from the browser. Only **sub-compositions** loaded via `data-composition-src` use `\u003Ctemplate>`.\n- **Using video for audio** — always muted `\u003Cvideo>` + separate `\u003Caudio>`.\n\n## Verification\n\nBefore and after rendering:\n\n1. **Lint + validate + inspect pass:** `npx hyperframes lint --strict && npx hyperframes validate && npx hyperframes inspect` (lint catches structural issues, validate catches contrast, inspect catches visual layout \u002F overflow issues — see troubleshooting.md if warnings appear).\n2. **Animation choreography** — for new compositions or significant animation changes, run the animation map. `npx hyperframes init` copies the skill scripts into the project, so the path is project-local:\n   ```bash\n   node skills\u002Fhyperframes\u002Fscripts\u002Fanimation-map.mjs \u003Ccomposition-dir> \\\n     --out \u003Ccomposition-dir>\u002F.hyperframes\u002Fanim-map\n   ```\n   Outputs a single `animation-map.json` with per-tween summaries, ASCII Gantt timeline, stagger detection, dead zones (>1s with no animation), element lifecycles, and flags (`offscreen`, `collision`, `invisible`, `paced-fast` \u003C0.2s, `paced-slow` >2s). Scan summaries and flags — fix or justify each. Skip on small edits.\n3. **File exists + non-zero:** `ls -lh final.mp4`.\n4. **Duration matches `data-duration`:** `ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 final.mp4`.\n5. **Visual check:** extract a mid-composition frame: `ffmpeg -i final.mp4 -ss 00:00:05 -vframes 1 preview.png`.\n6. **Audio present if expected:** `ffprobe -v error -show_streams -select_streams a -of default=nw=1:nk=1 final.mp4 | head -1`.\n\nIf `hyperframes render` fails, run `npx hyperframes doctor` and attach its output when reporting.\n\n## References\n\n- [composition.md](references\u002Fcomposition.md) — data attributes, timeline contract, non-negotiable rules, typography\u002Fasset rules\n- [cli.md](references\u002Fcli.md) — every CLI command (init, capture, lint, validate, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, benchmark)\n- [gsap.md](references\u002Fgsap.md) — GSAP core API for HyperFrames (tweens, eases, stagger, timelines, matchMedia)\n- [features.md](references\u002Ffeatures.md) — captions, TTS, audio-reactive, marker highlighting, transitions (load on demand)\n- [website-to-video.md](references\u002Fwebsite-to-video.md) — 7-step capture-to-video workflow\n- [troubleshooting.md](references\u002Ftroubleshooting.md) — OpenClaw fix, env vars, common render errors\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":39,"description":7,"prerequisites":43},"heygen-com","1.0.0",{"hermes":26},{"tags":27,"category":28,"related_skills":34,"requires_toolsets":37},[28,29,30,31,32,33],"creative","video","animation","html","gsap","motion-graphics",[35,36],"manim-video","meme-generation",[38],"terminal",[40,41,42],"linux","macos","windows",{"commands":44},[45,46,47],"node","ffmpeg","npx","main","0905b0264ce5a54908bedc9637e50251543db132","optional-skills\u002Fcreative\u002Fhyperframes",0,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary","https:\u002F\u002Fgithub.com\u002Fashneil12","2026-11-04 08:25:00",{"source":8,"skillName":5,"commands":56,"prompt":65,"zipAvailable":66},[57,59,62],{"tool":47,"command":58},"npx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill hyperframes",{"tool":60,"command":61},"bunx","bunx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill hyperframes",{"tool":63,"command":64},"pnpm","pnpm dlx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill hyperframes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002FSKILL.md",true,[68,74,78,82,86,90,94],{"path":69,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Fcli.md","REFERENCE","参考文档",8788,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002Freferences\u002Fcli.md",{"path":75,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Fcomposition.md",7747,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002Freferences\u002Fcomposition.md",{"path":79,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Ffeatures.md",14280,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002Freferences\u002Ffeatures.md",{"path":83,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Fgsap.md",5705,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002Freferences\u002Fgsap.md",{"path":87,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Ftroubleshooting.md",6709,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002Freferences\u002Ftroubleshooting.md",{"path":91,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Fwebsite-to-video.md",5258,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002Freferences\u002Fwebsite-to-video.md",{"path":95,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":98,"sourceHtmlUrl":99},"scripts\u002Fsetup.sh","SCRIPT","脚本",5174,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fcreative\u002Fhyperframes\u002Fscripts\u002Fsetup.sh",[101,109,116,123,130,137],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":105,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":18},"01M7380YR13A23353XT9NS6EGR","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","MIT","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":105,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":18},"01M7380VZ8P60Q64J3F92D4AMY","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":105,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":18},"01M7380QXN6F90R0MH1M3FHRKX","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":105,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":18},"01M7380N4BZYT2WRRZN1N9DZ65","spike","Throwaway experiments to validate an idea before build.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fspike\u002FSKILL.md",[],[],{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":105,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":18},"01M7380JAEC9ZH5DVPHHK56P97","simplify-code","Parallel 4-agent cleanup of recent code changes.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsimplify-code\u002FSKILL.md",[],[],{"skillNo":138,"name":139,"nameZh":6,"description":140,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":105,"licenseFileUrl":6,"sourceHtmlUrl":141,"categories":142,"keywords":143,"publishedAt":18},"01M7380F5MBB7FKWWV3G3TZ193","requesting-code-review","Pre-commit review: security scan, quality gates, auto-fix.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Frequesting-code-review\u002FSKILL.md",[],[]]