compare-with-reference-video
compare-with-reference-video
Purpose
After a target master video is rendered, the operator's first instinct is "this feels worse than the reference but I can't tell why." This atom answers that question structurally — by extracting matched frames, computing comparable metrics, and forcing a checklist review across 7 dimensions the LLM eyeball would otherwise skip.
The mechanical work (frame extraction, metric computation, grid HTML) is automated. The qualitative analysis is LLM/human driven against an explicit rubric. Output is a prioritized P0/P1/P2 fix list that auto-fix-from-review-notes can consume.
This skill is general-purpose — the dimensions and rubric work for ANY video format (music-video ad, narrated comic-strip, UGC, talking-head). The reference video acts as the "north star" for whatever format the operator is shipping.
When to use
- At State 8 of
video-orchestrator/orchestratorwhen a reference video for the target format exists (most common: when a molecule documents areference runand you have a master to compare against it). - After a re-roll pass to verify the fixes closed the gap.
- Standalone, any time the operator says "this feels off vs [reference]".