skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
whitetowerai/cut-as-code98 installs

video-edit-compare

Use when a completed cut-as-code delivery needs a strict side-by-side review against its original source, including cuts, varispeed, color grade, and graphics.

How do I install this agent skill?

npx skills add https://github.com/whitetowerai/cut-as-code --skill video-edit-compare
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is safe. It implements a video comparison tool using ffmpeg and Pillow. It safely handles user-provided file paths by using list-based subprocess arguments, which prevents command injection, and it relies on local vendor-provided dependencies.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Video Edit Compare

Render the single V1 comparison mode: original-vs-final-source-time.

The left panel plays the original continuously. The right panel projects actual final-delivery pixels back onto the original source clock. Dropped ranges are black, kept final ranges are stretched to their source duration, and audio is copied from the original.

Dependencies

Require ffmpeg/ffprobe on PATH and Python with Pillow. Check them before processing media.

Inputs

  • work/timeline.json: canonical chronological source-to-program mapping
  • input/original-video.mp4: original source
  • final/final-video.mp4: actual delivery after all selected edits

Do not compare against a cut plan or an intermediate render. The final pixels are required so the review includes grade and cards.

Render

python scripts/make_compare.py TIMELINE.json SOURCE.mp4 FINAL.mp4 OUT.mp4 [--filter-only]

Project example:

python skills/video-edit-compare/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

The script always writes the durable work/edit-compare/compare-plan.json. It writes PIL label images and the generated filtergraph under disposable work/cache/. --filter-only creates the plan and inspectable cache files without rendering the video.

Mapping Rules

  • Keep source clips chronological, non-overlapping, and single-source.
  • Trim each clip's program_range from the final video.
  • Stretch it by the clip speed to recover its source_range duration.
  • Insert black for every source-time gap.
  • Map the original audio without retiming it.
  • Derive every part's start and end frame from its absolute source-time boundaries, then trim to that frame count and rebuild PTS at the timeline's rational FPS. Never round each part duration independently; cumulative concat rounding causes source-time drift.

Reordered, duplicated, overlapping, nonlinear-speed, or multi-source timelines are unsupported in V1 and must fail validation.

Verify

After rendering, the script automatically checks the complete output:

  • duration equals source_duration_s within one frame;
  • output width is twice the source width;
  • every dropped-range sample is black on the right;
  • kept-range samples match the corresponding final program frames;
  • original audio remains continuous and on the source clock.

On success it writes review/04-edit-compare/comparison-summary.md with a passing verification result. When work/project.json exists, it also adds or refreshes the original-vs-final-source-time review node, records exact active operation revisions in based_on, and refreshes START-HERE.md. Do not create a separate checks manifest.

This comparison is a review deliverable, not a default preview. Generate it after the final render exists.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/whitetowerai/cut-as-code/video-edit-compare">View video-edit-compare on skillZs</a>