motionproof
/motionproof
Compare an animation copy against its original from two recordings (mp4, mov, webm, gif or PNG frames). Use when rebuilding or cloning an animation, checking whether motion matches a reference, or naming the easing and timing of a clip.
- Author
- Dodai0419 ↗
- Repository
- motionproof ↗
- Licence
- MIT
- Last repository change
- 04.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 04.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Compare an animation copy against its original from two recordings (mp4, mov, webm, gif or PNG frames). Use when rebuilding or cloning an animation, checking whether motion matches a reference, or naming the easing and timing of a clip.
Original author description
Compare an animation copy against its original from two recordings (mp4, mov, webm, gif or PNG frames). Use when rebuilding or cloning an animation, checking whether motion matches a reference, or naming the easing and timing of a clip.
How it works
- Commands
- The loop
- Reading the numbers
SKILL.md preview
--- name: motionproof description: "Compare an animation copy against its original from two recordings (mp4, mov, webm, gif or PNG frames). Use when rebuilding or cloning an animation, checking whether motion matches a reference, or naming the easing and timing of a clip." --- # motionproof Grade an animation copy against its original with numbers, then fix the biggest difference and grade it again. Requires Python 3.9+ and ffmpeg on PATH. It does not film anything: get both recordings first, at the same size and frame rate. ## Commands Run from the repo root: ```bash python motionproof.py compare reference.mp4 copy.mp4 --out proof --width 480 python motionproof.py ease --video reference.mp4 python motionproof.py ease --series "[[0,0],[100,30],[200,60],[300,80]]" python motionproof.py --demo ``` Options for `compare`: `--fps`, `--region x,y,w,h`, `--width`, `--start`, `--end`, `--threshold` (default 0.05, use 0.02 for a pixel-exact copy), `--motion-threshold` (default 0.08 s), `--pixel-threshold`, `--blur N` for particles and grain, `--offset K`. ## The loop 1. Run `ease --video` on the reference and use the verdict and fitted `durationMs` in the first build. 2. Film the copy the same way as the reference. 3. Run `compare`, and read `proof/report.md` and `pass` in `proof/report.json`. 4. Fix one cause, then run it again. Keep each round's folder. 5. Stop when `pass.motion` holds in `proof/report.json`: start delay, aligned timing and easing family all match. For a pixel-exact copy, `pass.pixels` must hold too. After 5 rounds with no progress, report the last numbers and the reason. Never loosen a threshold silently. ## Reading the numbers - `pass.motion` is the verdict for motion: `pass.start`, `pass.timing` and `pass.easing` together. - `pass.start` compares the raw start of motion before alignment. A copy that starts late fails it. - `pass.timing` is measured after alignment, so on its own it does not catch a late start. - `pass.easing` compares best-fit families: out, in, in-out, linear, spring. - A copy with its own colours fails `pass.pixels` and can still pass `pass.motion`. That is correct. - Easing from video assumes one main moving subject. Use `--region` when several things move. - Pure Python: pass `--width 480` for large clips.
Versions
The database has no other skills named motionproof.
Database snapshot: 13.11.2026 · package version a238fb5a8dd3 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100analyze
Analyze a screen recording of an animation to characterize its motion — timing, easing, transforms, and sequencing — so it can be recreated as web code. Use when the user drops or points at a video of an animation (.mp4/.mov/.webm/.mkv/.m4v/.avi/.gif) and says things like "I… - 95refilm
Rebuild an animation from a reference (a live website, a screen recording, an mp4/mov/webm, a gif, a Lottie file) in the user's own codebase, then film the copy the same way and compare the two frame by frame until timing, easing, sequence and layout match. Use whenever the user… - 100motiscope-analyze
Analyze a screen recording of an animation to characterize its motion — timing, easing, transforms, and sequencing — so it can be recreated as web code. Use when the user drops or points at a video of an animation (.mp4/.mov/.webm/.mkv/.m4v/.avi/.gif) and says things like "I… - 90move-system
Design a motion system for a product — duration tokens, easing curves, and animation principles. Use when asked to "design a motion system", "define duration and easing tokens", or "document animation principles". - 100motion-design
Recommends easing functions and durations, generates CSS and Framer Motion animation code, and audits motion for performance and prefers-reduced-motion compliance. Use when adding or fixing UI animation, choosing duration/easing for a transition, debugging janky motion,… - 85reanimate
Clone a section, widget, page or animation from any reference (a live website URL, a screen recording, an mp4/mov/webm, a gif, a Lottie file, a prototype export) frame by frame into the user's own codebase, then record the clone and verify it against the reference frame by…