AugmentClaude
Video

Video Cut

By worldwonderer· worldwonderer/video-recap-skills· 0

Assemble video clips from a plan into a single edited video file.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.
    Install
    Sign up to copy
    Sign up free to reveal

    This copies the whole skill folder into ~/.claude/skills/video-cut-worldwonderer/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
    Sign up free to reveal
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Cut a long video down to selected source ranges (montage / clip assembly). Part of the video-recap bundle: in the orchestrated (two-pass) flow, consumes clip_plan.json + the source video, produces edited_source.mp4; the agent then writes narration.json against the output timeline. When invoked standalone WITHOUT --no-narration-map, also remaps an existing narration.json → narration_mapped.json (legacy single-pass path). 触发词: 视频剪辑, 剪辑式解说, video cut, clip plan, 拼剪.

What this skill does

What this does

Takes an agent-authored clip plan (which source ranges to keep, in order) and:

  1. Validates + enriches it into clip_plan_validated.json (clip ids, source/output times, total duration, overlap checks).
  2. Concatenates those source ranges into a single edited_source.mp4.
  3. (Orchestrated path — default) Stops here; the agent writes narration.json against the output timeline (0 .. total seconds). Invoked by recap.py with --no-narration-map.
  4. (Legacy single-pass path) When invoked directly without --no-narration-map: maps narration written in original-video time onto the cut output timeline → narration_mapped.json.

It is stateless: given the same inputs it reproduces the same outputs. Caching is just "reuse edited_source.mp4 if it is newer than clip_plan.json".

Input contract

work_dir/clip_plan.json — a JSON array, or {"clips": [...]}. Each clip:

{"start": 12.0, "end": 28.5, "reason": "inciting incident"}

start/end are original-video seconds (aliases source_start/source_end or in/out accepted). Optionally target_duration at the object top level (e.g. "10m").

work_dir/narration.json (optional, legacy single-pass path only) — segments with original-video start/end + narration text, consumed only when --no-narration-map is NOT passed. Each segment may carry source_clip_id to disambiguate when overlapping clips are allowed.

Run

python3 scripts/cut.py <video> --work-dir <work_dir> \
  [--target-duration 10m] [--clip-padding 0] [--allow-overlap]

Output contract

  • clip_plan_validated.json — normalized clips with clip_id, source_start/end, output_start/end, duration.
  • edited_source.mp4 — the concatenated source video (the new shortened timeline).
  • narration_mapped.json — (legacy single-pass path only) narration with start/end rewritten to output time and source_clip_id set. NOT produced in the orchestrated flow (recap.py --no-narration-map).

In the orchestrated flow, downstream (voiceover + assemble) treat edited_source.mp4 as the video and narration.json (written by the agent against the output timeline) as the narration.

Notes

  • In the legacy single-pass path, timestamps in clip_plan.json and narration.json are original-video time; this tool does the source→output remap. In the orchestrated path, narration.json is written by the agent directly in output-timeline time — no remap is performed.
  • Overlapping/duplicate source ranges raise an error unless --allow-overlap is set; with overlap, narration should set source_clip_id.
  • Segments that fall outside every kept clip are dropped (logged).

What this skill does NOT do

  • Does NOT re-transcribe or re-analyze the video.
  • Does NOT write narration, and does NOT pick clips for you — it consumes an agent-authored clip_plan.json.
  • Does NOT re-encode beyond the concatenation/remap needed to build the cut source.

Related skills

S

Skill Builder & Optimizer

anthropics

Create, edit, and optimize Claude skills with performance testing and benchmarking.

Official
O

Org Change Management

alirezarezvani

Guide teams through organizational changes using the ADKAR model and communication strategies.

MIT
A

Audio/Video Transcription

daymade

Transcribe audio and video files to text with fast local or remote processing.

C

Claude Export Conversation Fixer

daymade

Repair broken line wrapping in Claude Code exported conversation files.