Agent skill

Remotion To Hyperframes

by boraoztunc in boraoztunc/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition.

Apache-2.0Auto-check passedMedia & Creative

Install Remotion To Hyperframes

skills CLI
$ npx skills add boraoztunc/skills --skill remotion-to-hyperframes -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install boraoztunc/skills remotion-to-hyperframes --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/boraoztunc/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/remotion-to-hyperframes .claude/skills/remotion-to-hyperframes && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
remotion-to-hyperframes
GitHub stars
393
Token cost
~2.2k tokens
SKILL.md length
818 words
Files
86 (incl. scripts, references, assets)
Skills in repo
52
Repo updated
First seen
Licence
Apache-2.0

At a glance

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition.

  • Works in 5 steps: Lint the source → Plan the translation → Generate the HF composition → …
  • Explicitly asks to port
  • SKILL.md covers Overview, When to use, Workflow and What this skill explicitly…, plus 1 more section
  • Runs TypeScript and Shell scripts from its folder; calls npx

What it does

Remotion To Hyperframes is an agent skill from boraoztunc/skills. Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my…

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 91 other files, including scripts, reference files and assets (for example `assets/test-corpus/run.sh`, `assets/test-corpus/tier-1-title-card/README.md` and `assets/test-corpus/tier-1-title-card/expected.json`).

It sits in Media & Creative, covering Video production, Motion graphics and Translation. It works with HeyGen, Remotion and React. The repository describes itself as: Claude Code skills for copywriting, SEO, design, and more. The licence is Apache-2.0.

When your agent uses it

  • Explicitly asks to port
  • Rewrite a Remotion composition as HyperFrames (e.g
  • (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video)
  • (b) Remotion is mentioned in passing

Example prompts

  • “port my Remotion project to HyperFrames”
  • “the same video as my Remotion one”
  • “/remotion-to-hyperframes”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Lint the source
  2. Plan the translation
  3. Generate the HF composition
  4. Validate
  5. Document gaps

What it can do on your machine

Read from SKILL.md and the folder at commit 645553c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (TypeScript and Shell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Remotion To Hyperframes loads about 2.2k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 230 tokens; SKILL.md has 818 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~230
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~17k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from boraoztunc/skills at commit 645553c, republished under its Apache-2.0 licence (© boraoztunc). 818 words, ~2,228 tokens.

Download SKILL.mdSave it as .claude/skills/remotion-to-hyperframes/SKILL.md (or your agent's skills folder). This skill also uses 85 other files; get the full folder from GitHub.
name
remotion-to-hyperframes
description
Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Remotion to HyperFrames

Overview

Translate Remotion (React-based) video compositions into HyperFrames (HTML + GSAP) compositions. Most Remotion idioms have direct HyperFrames equivalents — the translation is mechanical for ~80% of typical compositions. This skill encodes the mapping and guards against the lossy 20% by refusing to translate patterns that don't fit HF's seek-driven model and recommending the runtime interop pattern from PR #214 instead.

The skill ships with a tiered test corpus (T1–T4, 4 fixtures total) that grades translations against measured SSIM thresholds. Don't translate without running the eval — a translation that "looks right" but renders 0.05 SSIM lower than the validated baseline is silently wrong.

When to use

Use this skill ONLY when the user explicitly asks to migrate from Remotion. Example trigger phrases:

  • "port my Remotion project to HyperFrames"
  • "convert this Remotion code to HyperFrames"
  • "migrate from Remotion"
  • "translate this Remotion comp"
  • "rewrite this as HyperFrames HTML"

Do NOT use this skill when:

  • (a) The user is authoring a new HyperFrames composition, even if they have or are A/B-testing a similar Remotion video.
  • (b) The user mentions Remotion in passing without asking for migration.
  • (c) The user shares Remotion code as reference material rather than asking for a translation.
  • (d) The user asks for "the same video as my Remotion one" without explicitly asking to migrate the source — treat that as a fresh HyperFrames build.

When in doubt, default to authoring a native HyperFrames composition with the hyperframes skill instead.

Workflow

Step 1: Lint the source

Run scripts/lint_source.py over the Remotion source directory. The lint detects patterns that can't translate cleanly:

  • Blockers (refuse + recommend interop): useState, useReducer, useEffect/useLayoutEffect with non-empty deps, async calculateMetadata, third-party React UI libraries (MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI).
  • Warnings (translate after dropping the construct): @remotion/lambda config, delayRender, useCallback, useMemo, custom hooks.
  • Info (translate with note): staticFile, interpolateColors.

If any blocker fires, stop. Read references/escape-hatch.md and surface the recommendation message. Warnings don't stop translation — drop the offending construct in step 3 and note the gap in TRANSLATION_NOTES.md. @remotion/lambda config is the canonical warning case: the skill drops the import + renderMediaOnLambda(...) calls but translates the rest of the composition.

Step 2: Plan the translation

Read references/api-map.md — the index of every Remotion API and its HF equivalent or per-topic reference. Identify which topic references you'll need based on what the source uses:

Source containsLoad reference
Composition, defaultProps, schema, calculateMetadataparameters.md
Sequence, Series, Loop, AbsoluteFill, Freezesequencing.md
useCurrentFrame, interpolate, spring, Easing, interpolateColorstiming.md
Audio, Video, Img, IFrame, staticFile, delayRendermedia.md
TransitionSeries, @remotion/transitionstransitions.md
@remotion/lottielottie.md
@remotion/google-fonts/<Family>, Font.loadFont, @font-facefonts.md

Don't load all of them — load only what the specific source needs.

Step 3: Generate the HF composition

Emit index.html with:

  • Root <div id="stage"> carrying the composition's data-composition-id, data-start="0", data-duration (in seconds), data-fps, data-width, data-height, plus one data-* per scalar prop.
  • A flat list of scene divs with data-start / data-duration / data-track-index.
  • Inline <style> for layout; CSS sets the from state of every animated property.
  • A single <script> tag at the bottom containing one paused gsap.timeline({paused: true}). Every Remotion useCurrentFrame() derivation becomes a tween on this timeline at the right offset.
  • window.__timelines["<composition-id>"] = tl; registers the timeline with HF's runtime.

Custom React subcomponents inline as repeated HTML using the prop interface as the template (see parameters.md for the per-instance data-* pattern).

Show full SKILL.md (277 more words)Show less
Step 4: Validate

Run the eval harness — references/eval.md for the full guide. Quick path:

bash
# Render Remotion baseline (after npm install in the fixture)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4

# Render HF translation
cd ../hf-src && npx hyperframes render --output ../hf.mp4

# SSIM diff
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff

Threshold: ~0.02 below p05 of the source's complexity tier (see eval.md's validated thresholds table). If the diff fails, run scripts/frame_strip.sh to see which frames diverged, then re-read the relevant timing/sequencing/media reference.

Critical: both renders must use matching pixel format. Set Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") in the Remotion source's remotion.config.ts — otherwise the diff measures encoder differences (~0.05 SSIM hit), not translation fidelity.

Step 5: Document gaps

Anything that didn't translate cleanly (volume ramps dropped, custom presentations approximated, fonts substituted) gets a TRANSLATION_NOTES.md written next to the HF output. See references/limitations.md for the format.

What this skill explicitly does NOT do

  • Translate React state machines. Compositions that drive animation via useState + useEffect are not deterministic frame-capture targets in HyperFrames' seek-driven model. Recommend the runtime interop pattern.
  • Run Remotion's render pipeline alongside HyperFrames. That's the runtime interop pattern from PR #214 — a separate solution for compositions that fail this skill's lint.

(@remotion/lambda is not a blocker — Lambda config is deployment, not animation. The skill drops it as a warning and translates the rest. See references/escape-hatch.md.)

How to grade your own translation

Run the test corpus orchestrator:

bash
./assets/test-corpus/run.sh

It runs T1, T2, T3 (render + diff) and T4 (lint validation), prints a per-tier pass/fail table, and emits an aggregate JSON report. Use this to verify the skill is working end-to-end on a clean checkout — and as a regression check after editing any reference.

Validated baseline (as of 2026-04-27):

TierComposition shapeMean SSIMThreshold
T1single-element fade-in0.9740.95
T2multi-scene + spring + audio + image0.9850.95
T3data-driven, custom subcomponents, count-up0.9530.90
T4escape-hatch (8 lint cases)8/8 passn/a

© boraoztunc, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 85 other files (scripts, references, assets) in remotion-to-hyperframes of boraoztunc/skills.

  • SKILL.md
  • assets/.gitkeep
  • assets/test-corpus/.gitignore
  • assets/test-corpus/run.sh
  • assets/test-corpus/tier-1-title-card/.gitignore
  • assets/test-corpus/tier-1-title-card/README.md
  • assets/test-corpus/tier-1-title-card/expected.json
  • assets/test-corpus/tier-1-title-card/hf-src/index.html
  • assets/test-corpus/tier-1-title-card/remotion-src/package.json
  • assets/test-corpus/tier-1-title-card/remotion-src/remotion.config.ts
  • assets/test-corpus/tier-1-title-card/remotion-src/src/Root.tsx
  • assets/test-corpus/tier-1-title-card/remotion-src/src/TitleCard.tsx
  • assets/test-corpus/tier-1-title-card/remotion-src/src/index.ts
  • assets/test-corpus/tier-1-title-card/remotion-src/tsconfig.json
  • assets/test-corpus/tier-2-multi-scene
  • … and 71 more

Open the folder on GitHubat commit 645553c

Compare with similar skills

Remotion To Hyperframes next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Remotion To Hyperframes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Remotion To Hyperframes this skillboraoztunc/skills393—~2.2kAutomated safety check: PassApache-2.0
Remotion To Hyperframeschmonitor/chmonitor2981 repos~2.5kAutomated safety check: PassGPL-3.0
Remotion to HyperFrames Porterheygen-com/hyperframes58k3 repos~2.8kAutomated safety check: PassApache-2.0
Remotion To Hyperframeswaker240/FullVideoProductionSkill196—~2.4kAutomated safety check: PassApache-2.0
HyperFrames Video Entry Pointheygen-com/hyperframes58k3 repos~5.2kAutomated safety check: PassApache-2.0
Reference Video Replica QcPluviobyte/video-production-skills664—~1.8kAutomated safety check: PassNone

Similar skills

  • Remotion To Hyperframes

    chmonitor/chmonitor

    Port an existing Remotion (React) composition to HyperFrames HTML.

    298 GitHub starsUsed in 1 repo~2.5k tokens
    Media & CreativeAuto-check passed
  • Remotion to HyperFrames Porter

    heygen-com/hyperframes

    Ports an existing Remotion (React) composition to HyperFrames HTML with GSAP, one way, and grades the result against a tiered set of reference fixtures.

    58k GitHub starsUsed in 3 repos~2.8k tokens
    Media & CreativeAuto-check passed
  • Remotion To Hyperframes

    waker240/FullVideoProductionSkill

    Port an existing Remotion composition to HyperFrames HTML while preserving visible behavior.

    196 GitHub stars~2.4k tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    58k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Reference Video Replica Qc

    Pluviobyte/video-production-skills

    Analyze, recreate, align, and verify reference-video motion.

    664 GitHub stars~1.8k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Anything2explainer

    Vincentwei1021/anything2explainer

    给一个主题,产出一条黑底 MG 风格(幕底可选星点或点阵波)、有配音字幕章节进度条的科普讲解视频(中文或英文;Remotion 代码动画;时长由用户定,常用 3–5 分钟)。内含可编译模板、图元库、配音/分镜/渲染工具、风格与动效规范、多 agent 分工协议与 QC 判据,以及一条完整样片(《RAG 与知识库》)作为质量标尺。Turn any topic into a narrated…

    2.3k GitHub stars~2.7k tokensUpdated 19 days ago
    Media & CreativeAuto-check passed

More from boraoztunc/skills

All 52 skills in this repo
  • Gsap

    boraoztunc/skills

    GSAP animation reference for HyperFrames. An agent skill from boraoztunc/skills.

    393 GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed
  • Hyperframes

    boraoztunc/skills

    Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML.

    393 GitHub starsUsed in 9 repos~7.6k tokens
    Auto-check passed
  • Animejs

    boraoztunc/skills

    Anime.js adapter patterns for HyperFrames. An agent skill from boraoztunc/skills.

    393 GitHub starsUsed in 2 repos~828 tokens
    Auto-check passed
  • Beam Glow States

    boraoztunc/skills

    Create React loading, processing, selected, current, focus, and pressed states with the border-beam package's animated edge glow.

    393 GitHub starsUsed in 2 repos~3.2k tokens
    Auto-check passed
  • Minimal Zine Poster

    boraoztunc/skills

    Compile a theme, sentence, object, mood, article idea, or photo into a quiet Japanese/Korean zine-style editorial poster — tall aged paper, large negative space, one small image anchor, experimental…

    393 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Beautiful Shadows

    boraoztunc/skills

    Apply exact Tailwind arbitrary shadow utilities for polished, layered neutral elevation.

    393 GitHub starsUsed in 2 repos~635 tokens
    Auto-check passed

Questions about Remotion To Hyperframes

What does Remotion To Hyperframes do?

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Remotion To Hyperframes is an agent skill from boraoztunc/skills. Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition.

When should I use Remotion To Hyperframes?

Remotion To Hyperframes fits situations like: explicitly asks to port; rewrite a Remotion composition as HyperFrames (e.g; (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing.

How do I install Remotion To Hyperframes in Claude Code?

Run `npx skills add boraoztunc/skills --skill remotion-to-hyperframes -a claude-code`. Or copy the skill folder (remotion-to-hyperframes in boraoztunc/skills) into .claude/skills/remotion-to-hyperframes in your project. Claude Code loads it when a task matches its description.

How do I install Remotion To Hyperframes in Codex?

Run `npx skills add boraoztunc/skills --skill remotion-to-hyperframes -a codex`. Or copy the skill folder (remotion-to-hyperframes in boraoztunc/skills) into .agents/skills/remotion-to-hyperframes in your project. Codex loads it when a task matches its description.

Can I use Remotion To Hyperframes in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add boraoztunc/skills --skill remotion-to-hyperframes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/remotion-to-hyperframes, .gemini/skills/remotion-to-hyperframes, .github/skills/remotion-to-hyperframes and .opencode/skills/remotion-to-hyperframes in your project.

What does Remotion To Hyperframes need to run?

Going by SKILL.md and its folder, Remotion To Hyperframes needs TypeScript and a shell for the scripts in its folder and the command-line tools its instructions call (npx). Our summary lists: Node.js; A Bash shell.

Does Remotion To Hyperframes access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Remotion To Hyperframes safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Remotion To Hyperframes use?

Remotion To Hyperframes is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Remotion To Hyperframes use?

About 2.2k tokens (SKILL.md is roughly 8.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 15k tokens, read only when the agent opens those files.

What are the alternatives to Remotion To Hyperframes?

Skills that share tags, products or a category with Remotion To Hyperframes: Remotion To Hyperframes (chmonitor/chmonitor, 298 stars), Remotion to HyperFrames Porter (heygen-com/hyperframes, 58k stars), Remotion To Hyperframes (waker240/FullVideoProductionSkill, 196 stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Remotion To Hyperframes?

boraoztunc (a GitHub user) maintains it in boraoztunc/skills, which has 393 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on August 15, 2026.

Source: boraoztunc/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.