SkillAgentSearch skills...

rea-video

Reverse-engineer any video, shot by shot: filmed, AI-generated or coded, and how to remake it. Breakdowns in the open VIDEO.md format. 逆向一切视频,逐个镜头看是拍的、AI 生成的还是代码做的,再告诉你怎么复刻;拆解结果按 VIDEO.md 格式输出。

Install / Use

npx skills add JuneYaooo/rea-video

Installs into whichever agent you are using.

About this skill
🤖

CLAUDE.md

Claude Code project instructions

Quality Score

95/100

Supported Platforms

Claude Code
OpenAI Codex

Tags

Our assessment of rea-video

rea-video scores 95/100 on our quality scale, 257th of 4,698 Development & Engineering skills we index (top 6%).

Its CLAUDE.md is 15 KB long, well organised into 11 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

With 9,623 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
18/20
Description
15/15
Adoption
17/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so rea-video is actively maintained.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

rea-video compared with similar skills

All 4 of these similar skills score higher than rea-video; compare them before choosing.

SkillScoreStarsUpdatedFormat
rea-video (this skill)by JuneYaooo959.6ktodayCLAUDE.md
claude-memby thedotmack100117.6ktodayCLAUDE.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
Understand-Anythingby Egonex-AI10092.8k1d agoCLAUDE.md

Frequently asked questions

How do I install rea-video?
Run npx skills add JuneYaooo/rea-video. The install tabs above show the steps for each supported agent.
Which AI agents does rea-video work with?
It is written for Claude Code and OpenAI Codex, as a CLAUDE.md file. Other agents that read the same format can often use it too.
Is rea-video safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is rea-video still maintained?
The repository was last updated today, so rea-video is actively maintained.
<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/brand/logo-light.svg"> <img src="docs/brand/logo-dark.svg" width="400" alt="rea-video"> </picture>

Reverse-engineer any video.

Shot by shot: was it filmed, AI-generated or coded, and how to remake it.

Website | 中文 | English | Русский | 日本語 | 한국어 | Español | Português | Français | Deutsch

Stars Python Agent

<a href="https://trendshift.io/repositories/334878" target="_blank"><img src="https://trendshift.io/api/badge/trendshift/repositories/334878/daily" alt="JuneYaooo/rea-video | Trendshift" width="250" height="55"></a>

Visit our website Join our Discord Follow on X

⭐ Help more people find rea-video. Star this repo!

<img src="docs/cases/demo.gif" width="440" alt="Left: TikTok original shot on a phone; right: someone's AI remake with a different product">

Left: a TikTok ad shot on a phone. Right: an AI remake with another product. rea-video's verdict: the left is all live footage, one set and two camera positions; the right is all AI, 8 shots across 3 generations.

</div>

Quick start

rea-video is built for AI agents. In Claude Code, Codex or any agent that can run commands, say:

Install https://github.com/JuneYaooo/rea-video, then break down this video: /path/to/video.mp4

The agent installs the CLI, learns the workflow and runs the whole thing. You need ffmpeg and Python 3.10+.

<details><summary>Install by hand</summary>
brew install ffmpeg            # or: sudo apt install ffmpeg
git clone https://github.com/JuneYaooo/rea-video && cd rea-video
bash scripts/install_skill.sh  # installs the CLI (pip, or pipx / a local .venv if pip is blocked) and links the skill into ~/.claude, ~/.codex, ~/.agents
rea-video --help
</details>

You get:

  • a one-line summary, e.g. "41% AI video + 59% code UI, 8 s of real screen recording, library music at 122 BPM"
  • a remake plan, split into what to film, what to generate and what to code
  • a full report.html with per-shot frames, evidence, prompts, camera and lighting notes, and the audio breakdown

You can also hook up a video-capable model (Gemini or Doubao both work) by giving the agent its endpoint and key. That makes the live/AI/3D calls more accurate and adds a reverse-engineered prompt for every shot. It works fine without one; if your agent can see images, it checks the uncertain shots itself.

Reports are written in whichever language you ask in (Chinese or English). The example reports below are in English.

What it can break down

| Video type | Examples | What you get | |---|---|---| | Live footage | Talking-head, tabletop, handheld product demo, vlog, store visit | Setups and camera positions, framing, camera moves, lighting (12 setups with gear lists), color grade | | AI video | Text/image-to-video, AI short drama, AI music video | Evidence, a reverse-engineered prompt per shot, how to batch into generations and which model to use | | Avatar | A portrait driven by audio, lip-sync | Which shots are avatar shots, what portrait and audio you need | | 3D / animation | Blender / C4D explainers, product animation, 2D animation, stop-motion | Whether to generate with a video model or render from 3D code | | Code / template | Kinetic type, UI demos, charts, slide-style cards | Text, layout and motion timing, ready to rebuild as a Remotion project | | Screen recording | Software tutorials, web demos | Which parts are real material you'll need to record yourself | | Mixed / edits | AI characters + code UI + real screen capture; live footage with AI edits | Each shot judged separately, then reassembled on the original timeline |

Besides how the visuals were made, every breakdown also covers:

  • Captions and styled text: start and end of each line (exports to SRT / ASS), plus color, outline and how the text comes in
  • Stickers, emoji, picture-in-picture: where they sit and how long they stay
  • Editing: where the cuts are, how fast, whether they hit the beat
  • Audio: human or AI voice, AI or library music and its BPM, where each sound effect lands
  • Material you'll need to supply yourself: screen recordings, screenshots, product photos

Examples

The sample videos in docs/cases/videos/ are re-compressed to keep the repo small, which strips the TikTok / Douyin platform tags. So if you run them yourself, you'll get different results from the reports below, especially without a vision model. To reproduce them, use the original downloads from the platform.

<table> <tr> <td width="50%" valign="top"> <a href="docs/cases.md#2-混合片ai-人物对话--代码界面--真实录屏"><img src="docs/cases/dual_role/thumb.jpg"></a><br> <b>Mixed-media clip</b> · 19 s · 10 shots<br> AI characters talking + code-built UI + 8 s of real screen recording. The 5 dialogue shots are broken up by UI segments but share one set, so a single generation covers all of them.<br> <a href="docs/cases/videos/dual_role.mp4">Video</a> · <a href="docs/cases/dual_role/report_en.md">Report</a> </td> <td width="50%" valign="top"> <a href="docs/cases.md#3-3d-科普片咸鸭蛋为什么会流油"><img src="docs/cases/salted_egg/thumb.jpg"></a><br> <b>3D explainer</b> · 67 s · 21 shots<br> All 3D, AI narration. You can do it in 10 video generations, or have an LLM write Blender / Three.js code.<br> <a href="docs/cases/videos/salted_egg.mp4">Video</a> · <a href="docs/cases/salted_egg/report_en.md">Report</a> </td> </tr> <tr> <td width="50%" valign="top"> <a href="docs/cases.md#4-代码-ui-动效产品宣传片"><img src="docs/cases/v10/thumb.jpg"></a><br> <b>Product promo</b> · 70 s · 12 shots<br> 83% code-driven motion graphics, 12% screen recording. No video model needed; one Remotion project does it.<br> <a href="docs/cases/videos/v10_oiioii_gen_coding_first.mp4">Video</a> · <a href="docs/cases/v10/report_en.md">Report</a> </td> <td width="50%" valign="top"> <a href="docs/cases.md#5-ai-音乐-mv歌是-ai-写的还是曲库的"><img src="docs/cases/qing_mv/thumb.jpg"></a><br> <b>AI music video</b> · 165 s · 86 shots<br> Correctly flags the song as AI-generated (it was made with Suno). The vision model called some shots "live-action drama"; the agent spotted fake Chinese characters on a scroll and ruled them AI.<br> <a href="docs/cases/videos/qing_mv.mp4">Video</a> · <a href="docs/cases/qing_mv/report_en.md">Report</a> </td> </tr> <tr> <td width="50%" valign="top"> <a href="docs/cases.md#6-实拍带货沉浸式开箱"><img src="docs/cases/unboxing/thumb.jpg"></a><br> <b>Live-action unboxing</b> · 72 s · 29 shots<br> All real footage: an overhead phone rig, one rug, one camera position, no voice-over, room sound plus library BGM. After platform transcoding, the offline tools called 35% of it AI; after agent review it came out 97% live-action.<br> <a href="docs/cases/videos/unboxing.mp4">Video</a> · <a href="docs/cases/unboxing/report_en.md">Report</a> </td> <td width="50%" valign="top"> <a href="docs/cases.md#7-ai-与真人混合用自己的出镜视频生成带货片"><img src="docs/cases/ai_daihuo/thumb.jpg"></a><br> <b>AI + real person hybrid</b> · 58 s · 21 shots<br> 75% real (talking head + filming a phone screen) and 25% AI: the creator fed her own on-camera clip and two product photos to Jimeng to generate a "real-person" product segment. The AI part gave itself away with the Jimeng watermark and garbled text on the gift box.<br> <a href="docs/cases/videos/ai_daihuo.mp4">Video</a> · <a href="docs/cases/ai_daihuo/report_en.md">Report</a> </td> </tr> </table>

Remakes

After rea-video breaks a video down, the remake recipe in capsule-cinema generates a new version that keeps the original's camera, motion, pacing and transitions and swaps only the elements you pick. These were made with a self-hosted MiniMax H3, using the original shot as the motion reference and keyframes with the swapped elements (gpt-image-2) for the look. Below are three remakes OiiOii showed in its WeChat articles. We made two versions of each: one with the same swap as OiiOii, and one that also swaps the subject, setting and props. Each GIF plays four versions in sync: the original, OiiOii's remake, our remake and the element-swap version.

<table> <tr><td> <b>Overhead outfit change</b> · 12 s<br> Same swap: woman → man, three outfits → matching menswear. Element swap: a girl in three historical Hanfu outfits in a Chinese study; the remote becomes a round fan.<br> <img src="docs/cases/remake/outfit.gif"><br> <a href="docs/cases/remake/outfit_compare.mp4">HD comparison video (with audio)</a> · <a href="docs/cases/remake/outfit_sheet.jpg">same-moment stills</a> </td></tr> <tr><td> <b>Paper-craft / watercolor animation</b> · 30 s<br> Same swap: new clay girl as the lead. Element swap: a fox; forest → coral reef, clouds → starry sky, sunset → aurora.<br> <img src="docs/cases/remake/paper.gif"><br> <a href="docs/cases/remake/paper_compare.mp4">HD comparison video (with audio)</a> · <a href="docs/cases/remake/paper_sheet.jpg">same-moment stills</a> </td></tr> <tr><td> <b>Handheld product video</b> · 21 s · 11 shots<br> Same swap: an original new product, English sticker → Chinese caption. Element swap: pink product, kitchen → camping table, new ingredients.<br> <img src="docs/cases/remake/juicer.gif"><br> <a href="docs/cases/remake/juicer_compare.mp4">HD comparison video (with audio)</a> · <a href="docs/cases/remake/juicer_sheet.jpg">same-moment stills</a> </td></tr> </table>

The HD comparison videos use the original audio. The originals and OiiOii versions come from the articles and are shown for comparison only.

Accuracy

Accuracy of the how-it-was-made call, weighted by shot duration:

| | Tuning set (15) | Holdout (16) | Re-encoded WeChat videos (10) | |---|---|---|---| | Tools only (offline, free) | 98.3% | 99.6% / 98.9% | 88.6% | | + vision model (Gemini) | — | 99.6% / 99.8% | 99.6% | | + agent visual review | — | 99.6% / 99.8% | 100% |

The Holdout column shows two numbers: holdout (9 videos) and holdout2 (7 videos).

On original files, the tools alone are usually enough. Videos downloaded from platforms have been recompressed, which wipes out the noise evidence, so you need a visual check to get back above 99%.

Real-asset detection is 97–99%, and shot boundaries are all correct. Numbers and how to reproduce them: eval/RESULTS.md.

How it works

rea-video pipeline

  1. Split: cut the video into shots and split the audio into voice, music and effects.
  2. Gather evidence: measure (frame cadence, sensor noise, whether the whole image moves as one flat plane, AIGC tags in the metadata), look (hands, text, physics) and listen (BPM, key, singing vs speech).
  3. Decide: hard evidence like AIGC tags and frame cadence beats "looks like". Conflicts get flagged for the agent to check visually.
  4. Plan the remake: batch shots according to what the target video model can actually do, such as max clip length, multi-shot support and how many reference images it takes.

Star History

Star History Chart

FAQ

<details> <summary>How is this different from

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars9.6k
CategoryDevelopment
Updated9h ago
Forks1.4k

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions