A Python utility to render and verify chronological side-by-side comparisons of edited video files against their raw sources.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install video-edit-compare
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install video-edit-compare using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Video Edit Compare?
The Video Edit Compare skill acts as a verification helper for creators, editors, and automation pipelines. Built to integrate with Openclaw Skills, this system establishes a reliable methodology to evaluate a final video render against its original source asset. The comparison places the continuous raw source in the left panel and maps the edited, speed-adjusted final pixels onto the original timeline on the right. Gaps are automatically replaced with black frames, while original audio is maintained continuously to establish a clear temporal baseline.
This approach eliminates manual timeline mapping checks and helps verify that edits, speed adjustments, color grades, and graphics titles align with the target source timeline before final review delivery.
Video Edit Compare Use Cases
- Reviewing completed cut-as-code deliveries to verify temporal alignment, speed shifts, and color grading alterations.
- Automatically checking final video tracks for frame alignment and drift in programmatic editing workflows.
- Documenting proof of edits and layout revisions via self-checking verification files.
How Video Edit Compare Works
- The tool validates dependencies (FFmpeg, FFprobe, and Pillow) on the current path.
- The script processes the mapping configuration provided in the timeline JSON.
- The pipeline verifies and parses inputs, ensuring chronological, non-overlapping, and single-source timeline constraints are satisfied.
- Clips are processed by trimming final footage, stretching speed-modified ranges to align with their source timeline, and generating black frames for gaps.
- Cache outputs (including generated filtergraphs and image labels) are compiled to execute the visual merge.
- The script processes the visual render and performs downstream checks to verify timeline length, output geometry, and continuous audio mapping.
Video Edit Compare Setup
Ensure python, ffmpeg, and ffprobe are configured in your system environment. Install Pillow for image labeling support.
pip install Pillow
Run the Python utility to render the video comparison:
python scripts/make_compare.py work/timeline.json input/original-video.mp4 final/final-video.mp4 review/04-edit-compare/original-vs-final-source-time.mp4
To construct review configurations, label assets, and filter plans without writing the video comparison file, execute:
python scripts/make_compare.py work/timeline.json input/original-video.mp4 final/final-video.mp4 review/04-edit-compare/original-vs-final-source-time.mp4 --filter-only
Video Edit Compare Data Schema & Taxonomy
| Asset/File Path | Type | Description |
|---|---|---|
work/timeline.json |
Input (JSON) | Standard chronological mapping details from source to program timeline. |
input/original-video.mp4 |
Input (Video) | Raw source media file used as the reference baseline. |
final/final-video.mp4 |
Input (Video) | Final export file featuring applied cuts, adjustments, and overlays. |
work/edit-compare/compare-plan.json |
Output (JSON) | Persistent planning asset detailing comparison steps. |
work/cache/ |
Cache Directory | Location for temporary label structures, generated visual graphics, and filter paths. |
review/04-edit-compare/original-vs-final-source-time.mp4 |
Output (Video) | Side-by-side composite video. |
review/04-edit-compare/comparison-summary.md |
Verification Output | Evaluation summary documenting the success of execution parameters. |
Video Edit Compare Advanced Features
- Frame-accurate speed correction using dynamic PTS rebuilding to match the timeline rational FPS and reduce cumulative drift.
- Integrated project updating that automatically updates
work/project.jsonand refreshesSTART-HERE.mddetails. - Automated validation loops checking output file size, video scale, black frame mappings, and original audio continuity.
SKILL.md
Loading
Related Openclaw Skills
video-color-grade
A code-driven color grading tool that assesses footage, generates custom named looks, protects skin tones, and bakes portable 3D LUTs.
Science Research Writing
An AI agent skill designed to guide academic researchers through planning, drafting, revising, and auditing empirical research papers while preserving empirical evidence.
Voice Builder
A structured system to analyze authentic writing samples and generate a highly reproducible brand voice guide for automated workflows.
Brand Profile Skill
A foundational AI skill that builds a durable, reusable brand profile to ensure all downstream content generation matches a company's unique voice, audience, and guardrails.
javascript-toolkit-free
A practical JavaScript guide and toolkit designed to identify, prevent, and fix common language pitfalls like type coercion, this binding, and async errors.
Golang Toolkit Free
A technical reference and diagnostic skill designed to help AI coding agents identify and prevent concurrent leaks, channel deadlocks, and memory issues in Go applications.
Featured*
