remotion-to-hyperframes

An agent skill by heygen-com, from heygen-com/hyperframes. Tags: api, automation, debugging, developer-tools, video.

What it does

Port an existing Remotion (React) composition's source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add heygen-com/hyperframes --skill remotion-to-hyperframes

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/heygen-com/hyperframes
cp -r hyperframes/skills/remotion-to-hyperframes ~/.claude/skills/remotion-to-hyperframes

Safety box score

Grade C, moderate risk: 25 of 100 risk points, rated 2026-10-16. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.

This skill translates Remotion compositions to HyperFrames and validates them by running lint, render, and SSIM diff pipelines. Main risks are that it executes registry-resolved tooling (`npx`/`npm`/`ffmpeg`), fetches external assets/code from npm/CDN/live catalog services, and writes/deletes generated artifacts in the local workspace.

Category levels, from 0 (none) to 3 (high)
Category	Level	Why
Code & shell execution	3 (high)	It explicitly runs external commands such as `npx hyperframes skills update remotion-to-hyperframes`, `npx hyperframes render`, `npm install`, `npx --no-install remotion render`, and helper scripts that invoke `ffmpeg`/`ffprobe`, so using it means executing downloaded tooling.
Network access	2 (moderate)	The workflow contacts remote services to fetch packages and assets, including `npx hyperframes catalog --query ...`, `npx hyperframes skills update ...`, and the generated HTML's CDN load of `https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js`.
Filesystem reach	1 (low)	It only writes and deletes within the working tree and temp dirs, e.g. `hf-src/assets`, `diff/`, `strip/`, `TRANSLATION_NOTES.md`, and `trap 'rm -rf "$RESULTS_DIR"' EXIT`.
Secrets & credentials	0 (none)	No file or command in the shipped skill reads tokens, keychains, browser sessions, or `.env` secrets; the corpus and scripts operate on public fixtures only.
Privilege & persistence	0 (none)	There is no sudo, service registration, shell startup editing, or global system change; the commands stay in user-space tooling.
Instruction hijack surface	0 (none)	The text is route-selection and workflow guidance, not prompt-injection; it does not tell the agent to ignore higher-priority instructions or hide anything.
Irreversible actions	0 (none)	It does not publish, post, pay, deploy, or otherwise act on external accounts; the actions are local translation and validation steps.
Transparency	1 (low)	Part of the executed behavior is outside the repository, including `npx`-resolved packages and the minified CDN GSAP bundle, so a reviewer cannot inspect that code from the skill files alone.

Before installing

Read `SKILL.md` and `assets/test-corpus/run.sh` first; be comfortable with `npx`, `npm install`, and the ffmpeg-based test harness before letting an agent run it.
Check whether you accept external downloads from npm and `cdnjs.cloudflare.com` during translation/rendering.
Try it in a throwaway checkout first, because the corpus scripts write `hf-src/`, `diff/`, `strip/`, and temp files inside the workspace.

Rated 2026-10-16 by an automated review of 71 files from the skill's repository.

Source

Repository: heygen-com/hyperframes (all skills from this repository)
Path: skills/remotion-to-hyperframes/SKILL.md
Branch: main
Updated: 2026-09-19

hyperframes-audio — Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking.
pr-to-video — Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix.
seam-craft — Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master.
mcp-developer — Use when building, debugging, or extending MCP servers or clients that connect AI systems with external tools and data sources.
tool-design — This skill should be used for the tool-interface layer of an agent system specifically: writing tool descriptions agents can route on.
code-improver — Runs an autonomous review-and-fix improvement loop over any code target — a skill, plugin, module, or directory — using a reviewer the user names.