reverse-engineer-video — Claude Code skill for video analysis
The reverse-engineer-video Claude Code skill breaks down a reference clip into shots, camera moves and editing beats. Invoke it to inspect a cut, plan a remake or compare one with the original.
MIT ★ 541 updated 2026-11-09
npx skills add dotslashsimran/simcraft --skill reverse-engineer-video -a claude-codeWhat reverse-engineer-video does
The skill marks cuts and dissolves, measures shot lengths and pacing, identifies camera movement, and checks whether edits align with beats or loudness changes. It creates a contact sheet, a timeline strip, breakdown.md with a beat map and remake plan, and breakdown.json. On-screen text and speech are read when the relevant tools are installed.
The scripts run with python3 and require numpy. Running sh setup.sh adds OpenCV for tracking fast movement; sh setup.sh --whisper adds speech recognition, while text reading needs tesseract on PATH. Comparison scripts can produce stills or videos with the clips side by side, stacked, or blended. Analysis and comparison scripts are in scripts/; save analysis output outside the reference clip’s folder.
What it helps with
- mark cuts and measure shot lengths
- identify camera moves and musical accents
- draft a remake plan from a reference clip
- compare a remake with the original at matching timestamps
Example prompts for the agent
- Break down this clip and draft a remake plan.
- Identify the camera moves and check whether the cuts land on musical beats.
- Compare my remake with the original and show the differences.
How to install reverse-engineer-video
1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill reverse-engineer-video -a claude-code2Manually: put the files in place
~/.claude/skills/reverse-engineer-video/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/reverse-engineer-video/
1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill reverse-engineer-video -a codex2Manually: put the files in place
.agents/skills/reverse-engineer-video/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill reverse-engineer-video -a cursor2Manually: put the files in place
.cursor/skills/reverse-engineer-video/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dotslashsimran/simcraft skills/video/reverse-engineer-video2Manually: put the files in place
.github/skills/reverse-engineer-video/SKILL.md1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill reverse-engineer-video -a gemini-cli2Platform CLI
gemini skills install https://github.com/dotslashsimran/simcraft --path skills/video/reverse-engineer-videoManually: put the files in place
.devin/skills/reverse-engineer-video/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about reverse-engineer-video
How do I install reverse-engineer-video in Claude Code?
Run npx skills add dotslashsimran/simcraft --skill reverse-engineer-video -a claude-code. The skill file is installed at ~/.claude/skills/reverse-engineer-video/SKILL.md.
What does reverse-engineer-video do?
It maps shots, pacing and camera movement, then prepares a beat map and remake plan. It can also compare a remake with its reference as stills or video.
What does reverse-engineer-video need to run?
It requires python3 and numpy. OpenCV supports tracking fast moves; speech recognition is added with sh setup.sh --whisper, and reading on-screen text requires tesseract on PATH.
Source text
SKILL.md · MIT
--- name: reverse-engineer-video description: Break down a reference or viral video clip so it can be remade. Finds every cut and dissolve, times each shot, measures pacing, works out the camera move in each shot (static, pan, tilt, zoom or push in, roll, handheld shake, with speed), finds beats and loudness jumps and checks whether the cuts land on them, and reads on-screen text and speech when the tools are installed. Makes a contact sheet, a timeline strip, breakdown.md with a beat map and a remake plan, and breakdown.json. Also makes side-by-side or stacked comparison videos of a remake against the reference. Use when the user says "break down this video", "reverse engineer this clip", "how was this edited", "shot list from this video", "why does this go viral", "recreate/remake this video", "what camera moves are in this", "do the cuts hit the beat", or "compare my remake with the original". --- # Reverse engineer a video Scripts live in `scripts/`. They run on `python3` with numpy. For better tracking of very fast moves, run `sh setup.sh` once and use `.venv/bin/python` instead (it adds OpenCV; `sh setup.sh --whisper` also adds speech-to-text). On-screen text needs `tesseract` on the PATH. Every optional part is skipped cleanly when its tool is missing, and the report says so. ## Steps 1. **Analyse.** Write the output somewhere other than the video's own folder: ``` python3 scripts/analyze.py <clip> -o <out_dir> ``` It writes `breakdown.md`, `breakdown.json`, `contact_sheet.jpg`, `shots_detail.jpg` and `timeline.png`. 2. **Check the cuts before trusting anything else.** Open `timeline.png` and `contact_sheet.jpg`. If two shots in the sheet look like the same shot, a cut was false: run again with `--sensitivity 0.7`. If a sheet frame shows two shots blended or a shot changes inside one tile, a cut was missed: use `--sensitivity 1.4`. Fast flashes shorter than `--min-shot` (0.1 s) are listed as flash frames, not shots. 3. **Look, then fill in the gaps.** Read `shots_detail.jpg` (start, middle and end frame of each shot, with the measured numbers). Then edit `breakdown.md`: - fill the "what happens" column of the beat map, one short line per shot, - write the hook read (see below), - write the remake plan. Use the measured times and camera numbers; do not round them into guesses. 4. **Remake, then compare at the same timestamps.** You cannot watch video, so compare stills first: ``` python3 scripts/compare.py <ref> <remake> --stills compare.jpg --breakdown <out_dir>/breakdown.json ``` Fix the biggest difference, repeat. When it is close, make a video for the user: ``` python3 scripts/compare.py <ref> <remake> -o compare.mp4 --mode side # or stack for vertical posts python3 scripts/compare.py <ref> <remake> -o overlay.mp4 --mode blend # lines up horizons and edges ``` Use `--ref-start` / `--remake-start` if one clip has a lead-in. A shorter remake holds its last frame, or repeats with `--loop-remake`. Output is always re-encoded. ## Reading the hook (first 2 seconds) The "Hook" section lists measured facts: when the first cut comes, how many cuts fall in the first 2 s, whether sound starts at frame one, the first words and text, and how busy the opening is compared to the rest (`motion first 2s vs rest`, above 1 means busier). Use them to answer three questions in plain words: - **What is the promise in frame one?** A strong first frame shows the payoff or a clear question (a finished result, something odd, a face mid-sentence). An establishing wide shot or a logo is a weak start. - **What changes before 0.5 s?** A cut, a move starting, a sound hit or text appearing. If nothing changes, say so: viewers decide in this window. - **Why stay to 2 s?** Usually an open loop: text or speech that asks a question, or a move that has not finished. ## Camera numbers, and rebuilding a shot in 3D Each shot gets a label (static, pan, truck/arc, tilt, zoom in/out, push in/pull out, roll, handheld). Long shots with several moves are split into phases, such as `push in > tilt up`. Each label comes with numbers: pan speed in % of frame width per second, tilt in % of frame height per second, total zoom factor, shake in % of frame width, and parallax. Directions describe the camera, not the picture. "Zoom" means the picture scaled with no parallax (a lens zoom, a digital scale, or a very far scene). "Push in" means there was parallax, so the camera really moved. `breakdown.json` has a camera path per shot (pan, tilt and zoom over time) to use as keyframes. To rebuild a scene in three.js or a 3D tool, measure the geometry on a sharp frame from `shots_detail.jpg`: - **Horizon height** (where the vanishing points sit) tells you camera pitch: a horizon on the frame's centre line means a level camera; above centre means it tilts down. - **Lens**: take two vanishing points of lines that are at right angles in the real world. The focal length in pixels is `sqrt(-(v1 - c)·(v2 - c))`, where c is the frame centre. Vertical field of view is `2·atan(H / 2f)`. - **Camera height**: if the horizon crosses a person standing on the same floor at their eye line, the camera is at eye height (about 1.6 m). Where it crosses them gives the ratio. The full method, with worked numbers, is in [reference.md](reference.md). ## Rules - Never write into the reference video's folder, and never change the reference file. - Trust measured times over what you think you see. Quote cut times from `breakdown.json`. - Say clearly which parts were skipped (no transcript, no text reading) instead of guessing them. - In the beat map, "on beat" means within the tolerance shown (default 1.5 frames, at least 50 ms). Always quote the chance rate next to the hit rate: 60% of cuts on onsets means little if random cuts would score 50%. How each measurement works, the limits, the test results and all options: [reference.md](reference.md).
© dotslashsimran · MIT · dotslashsimran/simcraft