video-cut (Clip-plan video cutter)

Cuts a long video into a short edit using the Agent-chosen source ranges and renders a constant-frame-rate edited_source.mp4.

Image & VideoAdvanced★ 555⑂ 105AI score 9/10Last updated: Oct 4, 2026

What it does

Validates and normalizes clip_plan.json (source-time ranges) into clip_plan_validated.json with clip_id, source/output times, durations and frame counts.
Snaps every boundary to the source frame grid and to reliable sentence ends / natural pauses, so dialogue is never clipped mid-word; if a boundary still lands inside speech it blocks with unsafe_clip_sentence_boundary and reports the nearest safe points.
Avoids one-frame flashes near original hard cuts, then concatenates the selected ranges into a constant-frame-rate edited_source.mp4.
Supports multi-source projects via --sources-manifest with per-source anchors.
required_evidence lets you declare must-keep moments (question/answer, reaction, payoff) plus ordering constraints; missing, reordered or audio-less evidence blocks the render.
Deterministic output with a sidecar meta file used for safe cache reuse.

Who it's for

Creators building recap/commentary videos through an agent-driven two-stage pipeline.
Developers assembling automated ffmpeg editing workflows.
Editors tired of cut-off dialogue and variable-frame-rate concat artifacts.

Examples

Build a 10-minute recap from a 60-minute episode: python3 scripts/cut.py episode.mp4 --work-dir work --target-duration 10m
Dry-run the plan only: add --normalize-only to get clip_plan_validated.json with boundary and duration warnings before rendering.
Audit micro-shots in the finished edit: --review-shots --shot-scene-threshold 0.35 writes candidates to shot_review.json without changing the plan.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/zenstory-ai/video-recap-skills/HEAD/skills/video-cut/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/video-cut folder from the GitHub repo zenstory-ai/video-recap-skills into my ~/.claude/skills/zenstory-ai-video-cut/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/zenstory-ai/video-recap-skills.git && mkdir -p ~/.claude/skills && cp -r video-recap-skills/skills/video-cut ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Open a terminal in your working directory.
Clone the repository: git clone https://github.com/zenstory-ai/video-recap-skills.git
Copy the skill into Claude Code's skill folder: mkdir -p ~/.claude/skills && cp -r video-recap-skills/skills/video-cut ~/.claude/skills/
Check prerequisites: ffmpeg -version, ffprobe -version and python3 --version must all work. Install with brew install ffmpeg (macOS) or sudo apt install ffmpeg (Ubuntu) if missing.
Restart Claude Code and mention keywords like "video cut" or "clip plan" to load the skill.
Place clip_plan.json in your work_dir; for multi-video edits also prepare a sources.json manifest.
Run once with --normalize-only to verify the plan, then rerun without it to render edited_source.mp4.

View source on GitHub ↗License: MIT