amw-hyperframes-bridge

Renders HTML compositions to MP4 video via the external Hyperframes CLI.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/Emasoft/ai-maestro-webdesign --skill amw-hyperframes-bridge-emasoft
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: amw-hyperframes-bridge
Source: https://github.com/Emasoft/ai-maestro-webdesign/tree/main/skills/amw-hyperframes-bridge
Command: npx skills add https://github.com/Emasoft/ai-maestro-webdesign --skill amw-hyperframes-bridge-emasoft

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes references (resource) components.

What problem does it solve? Turning a finished HTML composition into a distributable MP4 video normally requires manual browser recording or custom rendering pipelines. This Skill bridges to the external Hyperframes monorepo and runs a gated lint-validate-inspect-render sequence so HTML scenes become verified MP4 files without re-implementing the render engine. ## Core Features & Use Cases - Shell-out rendering: Accepts either a single HTML scene file (auto-scaffolded into a temp project) or a full Hyperframes project directory, then runs npx hyperframes render --output <mp4>. - Mandatory pre-render gate: Executes lint β†’ validate β†’ inspect β†’ render in order, aborting on any failure so broken compositions never reach the render stage. - Website-to-video pipeline: A 7-step capture workflow (capture, DESIGN.md, SCRIPT.md, STORYBOARD.md, VO generation, composition build, validation) turns a live URL into a branded video. - Use Case: A user finishes an HTML product-launch composition and asks to render it as a 25-second Instagram Stories video; the Skill verifies the environment, runs the gate sequence, and returns the MP4 path plus a job-completion report. ## Quick Start Render my approved HTML composition at ./design/launch/index.html to an MP4 video using the Hyperframes bridge.

Frequently Asked Questions about amw-hyperframes-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render an HTML composition to MP4 video?β–Ό

Provide either an html_scene_path to a single HTML file or a project_dir containing a Hyperframes project. The bridge scaffolds a temp project if needed, runs lint, validate, and inspect gates, then executes npx hyperframes render --output to produce the MP4.

What is Hyperframes and how does HTML to video rendering work?β–Ό

Hyperframes is an external monorepo (github.com/heygen-com/hyperframes) that renders HTML compositions with data-* timeline attributes into MP4 using Puppeteer-managed Chrome and FFmpeg. This Skill shells out to its CLI rather than re-implementing the pipeline.

Does Hyperframes use Playwright or Puppeteer for Chrome?β–Ό

Hyperframes uses Puppeteer with @puppeteer/browsers, not Playwright. Provision Chrome by running npx hyperframes browser ensure inside the external/hyperframes directory; npx playwright install chromium will not fix browser-missing errors.

Why does hyperframes render fail with CLI not found?β–Ό

The @hyperframes/cli package is not published to npm, so it must run from inside the cloned monorepo. If external/hyperframes exists but the CLI fails, run bun install inside that directory; if the folder is missing, clone the repo at tag v0.4.30 first.

When should I not use the HTML to MP4 bridge?β–Ό

Do not use it for generic animation or in-browser motion, which belongs to the Stage + Sprite animations component or the pretext typographic-motion skill. It is also not a substitute for single-frame PNG/PDF export or browser automation tools.

What checks run before the video render starts?β–Ό

The bridge enforces a gate sequence of hyperframes lint (structural schema checks), validate (WCAG contrast audit), and inspect (visual layout overflow audit) before render. Any non-zero exit aborts the pipeline before the potentially multi-minute render begins.