About this skill
HTML-to-Video Motion Graphics
Your coding agent can already write HTML, CSS and GSAP. This skill turns that into video: launch films, feature explainers, changelog clips, stat reels, title cards, captions and vertical social ads, rendered to MP4 frame by frame so every render comes out identical. The agent works in files you can read and edit: one root composition, one HTML file per scene, copy and brand colours as variables.
How it works. Ask for a video the way you would brief a motion designer. For anything over about 15 seconds that tells a story, the agent first reads the playbook for that kind of video (launch, explainer, data, vertical, music, 3D, character), proposes three storylines in words, and writes a SPEC.md where every adjective becomes a number. Then it builds the scenes, runs npx hyperframes check against a 12-rule render contract (no Date.now(), no unseeded randomness, no tweening display, safe areas, asset paths), takes snapshots, reviews them, and stops at a preview for your approval before the final render.
What you get. The main skill (render contract, work loop, what each video type needs), 16 reference files plus 7 video-type playbooks on story, storyboards, motion, captions, overlays, sound, format and review, 13 frame presets with caption skins and showcase pages, and a companion CLI skill that maps every command to the job it does: scaffold, check, snapshot, edit the timeline, preview, render locally or in the cloud.
Runtime. The skills drive the open-source HyperFrames CLI (Apache-2.0, by HeyGen) through npx hyperframes; it is not bundled here. You need Node.js 22+ and FFmpeg. Local rendering is free; cloud rendering and the optional desktop app are the runtime publisher's services and are offered, never required.
Based on the hyperframes and hyperframes-cli skills by HeyGen, Inc. (Apache-2.0): https://github.com/heygen-com/hyperframes
What we changed
- Renamed the skills to
html-to-video-motion-graphicsandhtml-to-video-motion-graphics-cli, added a note that maps upstream's/hyperframesnames to them, and fixed the links between the two skills (each changed file is marked). - Removed the "usage beacon" step, which had the agent send a telemetry event every time the skill started. The CLI's own telemetry and its opt-out are unchanged.
- Left out the six binary font files of one preset (
code-editorial; free on Google Fonts), upstream tests, and the other upstream skills (registry, media, slideshow and others).NOTICE.mdlists the upstream commit and every change.
Checked against
Claude Code 2.1.317 (desktop app, Claude Opus 5.5), 2026-11-07. Installed under .claude/skills/html-to-video-motion-graphics/, loaded from SKILL.md and run end to end on a 20-second launch video brief: SKILL.md routed to the launch playbook, proposed three storylines and wrote SPEC.md. Not run: npx hyperframes itself (no network install in that environment), so no scaffold, check, preview or render; the package name, CLI name and Node 22+ requirement were verified against the npm registry (hyperframes 0.9.20). One broken link, automatic feedback reports and a telemetry flag were fixed (NOTICE.md). The example output on this page is from that run, shortened. Not yet checked: automatic triggering from the skill description in a fresh session (the run started from an explicit request), and Codex, Cursor, GitHub Copilot and Gemini CLI, which read the same SKILL.md format but have not been run.
How to install
The package holds two skills. Copy the contents of files/ (without the html-to-video-motion-graphics-cli/ folder) to .agents/skills/html-to-video-motion-graphics/ and copy files/html-to-video-motion-graphics-cli/ to .agents/skills/html-to-video-motion-graphics-cli/, so the two sit side by side. Do the same under .claude/skills/ for Claude Code, or download the zip and unpack it there. If your agent uses its own folder (.cursor/skills/, .github/skills/, .gemini/skills/), copy both there too. Check node --version (22+) and ffmpeg -version, then ask: "use html-to-video-motion-graphics to make a 20-second launch video for …".
The CLI may report that upstream's own skills are missing or out of date; that refers to the upstream copies, not this package. Running npx hyperframes skills update installs upstream's versions next to these; keep one set to avoid duplicate triggers.
Not affiliated with HeyGen, Inc.
