Skip to content
Skills Library
Design & UX · Analysis

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.

Repository
motionproof ↗
Licence
MIT
Last repository change
04.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 04.11.2026, without references to retired models or APIs.

Licence

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

  1. Commands
  2. The loop
  3. Reading the numbers
Original SKILL.md headings · 36 lines, 301 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.