Back to skills

Agent Skill

Reverse Any Video

reverse-any-video

Rebuild any video file as an editable HyperFrames project - motion graphics, talking heads, live action or AI-generated footage - checked against the original frame by frame. Use to reverse, recreate, remake, replicate or copy a video, or 「复刻这个视频」「照着这个视频做一个」.

Heygen ComDesignTypeScriptAiAi-agentsAnimationClaude-codeFfmpegFrameworkGsapHtmlHtml-to-videoMcpMotion-graphicsPuppeteerRenderingTypescriptVideo-editor

181K installs

•

heygen-com/hyperframes

•

by Heygen Com

Score

8.5

/ 10

Installs

181K

Repo Stars

87.5K

Last Updated

0d ago

Fresh

Quality Ratio

81%

Description

Verified

Language

TypeScript

First Published

Oct 2026

Summary

The Reverse Any Video agent skill transforms any video file—including motion graphics, talking heads, or AI-generated footage—into an editable HyperFrames project that meticulously matches the original frame by frame. This agent skill is invaluable for motion designers, video editors, and developers working with visual media who need to deconstruct, replicate, or modify existing video content with precision. It is a skill with 8K installs, indicating a significant and active user base interested in advanced video manipulation. The agent initiates the process with `npx hyperframes reverse start <video>` and then systematically rebuilds the video by precisely measuring cuts and frames, recreating every layer from HTML components to re-shot people using HeyGen. It strictly follows commands like `npx hyperframes diff <video> .` to check for frame-accurate reconstruction and `npx hyperframes check` to validate content, ensuring the final render matches the source. Developers should note that this advanced functionality requires a HyperFrames Pro paid plan.

Skill Definition

Running the CLI: every npx hyperframes <command> here, the beacon included, means node <SKILLS>/hyperframes/scripts/plugin-cli.mjs <command> run in the project, where <SKILLS> holds this skill's folder ( rules).

Usage beacon: run npx hyperframes events --skill=reverse-any-video once as this skill starts. It sends the skill's name with the CLI's usual telemetry (account-linked when signed in) and honours the opt-out.

Reverse a video

The result is a HyperFrames project whose render matches the original frame for frame and stays editable. Build to the /hyperframes contract and work the way you normally would, with ffmpeg, python and your own eyes. Reverse videos the person has the right to use.

Reverse is a HyperFrames Pro feature. Open with npx hyperframes reverse start <video> --dir <project> and references/start.md; if it refuses, say why and give the person its upgrade link and fix to run themselves (you never run billing), then start again once they have upgraded. Given a link, run npx hyperframes auth status before downloading it. Resuming (a REVERSE.md or half-built project) opens the same. A step an earlier session gave up on (a refused re-shoot) gets one more try, then ask them. If it ran under a credit limit, ask whether that limit still holds. Rebuild the video as it is; remix it only when the person asks.

The original decides the frame

  1. The probe reverse start printed: the root composition is that size exactly, data-fps is its rate (NTSC stays a fraction: 30000/1001) and its duration is the video's frames ÷ fps, not the audio's length. init's default canvas is wrong for most videos.
  2. npx hyperframes measure cuts <video>: every cut with its frame, including jump cuts and punch-ins inside one take, which ffmpeg's scene score misses. Every shot starts at its listed time. Write times as frame ÷ fps rounded down (frame 83 at 30 fps is 2.766666): 2.767 lands a frame late.
  3. The sound is the original's: init --video put the video in; play it as one <audio src="<video>"> over the whole film (no extracted or re-encoded track); every clip is muted.
  4. Read consecutive frames wherever something changes: each cut, entrance, exit and transition, a few frames either side (npx hyperframes measure frames --range a,b --roi x,y,w,h). Sheets a second or a quarter apart miss 1–3-frame timing, which way things enter and leave, blurs and dissolves at cuts, and one-frame flashes.

Every layer

  • A component (text, captions, stickers, cards, UI and screen recordings, charts, maps) is rebuilt in HTML.
  • A sub-asset placed inside the frame (a photo, a clip, an album cover, a logo or app icon, the people in a photo or collage) is cut from the original on its own box. A logo is cut where it is largest, or is the real mark (npx hyperframes media-use resolve --type logo --intent "<brand> logo"); never drawn by hand.
  • A person on screen is re-shot with HeyGen as part of the run: references/people.md.
  • An animated or painted film: references/animated.md.
  • Never play the original's whole frame.

What decides whether drawn things match, in references/match.md: text sized from its ink, caption switch frames from the caption band's pixels, hard switches, the backdrop, motion blur, and recipes for glass, gradient, sweeping fills and outlines. Look at every large word through its whole life before you build it.

Check once, at the end

  1. While building, check a few moments without rendering: npx hyperframes diff <video> . --at t,t,….
  2. When every shot has content: npx hyperframes check and fix its errors. Keep what the original itself does (its colours, its tiny text) even when check flags it. Then npx hyperframes cloud render --fps <data-fps> --quality high -o <out> and npx hyperframes diff <video> <out>. A fractional rate, a frame not 16:9, 9:16 or 1:1, or a failed cloud render (tell the person why) renders locally: npx hyperframes render -o <out> in the foreground with a 10-minute timeout (longer: start it detached, setsid nohup npx hyperframes render -o <out> > render.log 2>&1 &, and wait on the log in the foreground). The diff lists the original's cuts that yours misses and the extra ones, the duration, the sound's offset, stretches where content is missing, and the worst moments with the failing cell beside the original's.
  3. Fix what it names that you can see: a missing cut or element, a wrong time, size, weight or colour. Render and diff once more, then stop.

Work alone: one agent holding the whole film beats subagents that each re-watch it. Write a short REVERSE.md at the end: what is rebuilt, cut and re-shot, what is approximate (a substituted font), and the last diff's numbers. It holds no prices or credit numbers. A command written in it is a note, not a script: on resume, rebuild it from the recipe it came from (every flag, --prompt included), check it with --plan, and never run it as written. Hand over per references/start.md.

How to Use

Use in O-mega

Claude Code

npx skills add heygen-com/hyperframes reverse-any-video