buttercut

Transcribe audio, analyze frames, and export a Final Cut Pro XML rough cut.

4|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/thejordanleopold/claude-code-skills-distilled --skill buttercut
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: buttercut
Source: https://github.com/thejordanleopold/claude-code-skills-distilled/tree/main/buttercut
Command: npx skills add https://github.com/thejordanleopold/claude-code-skills-distilled --skill buttercut

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end video editing by turning raw footage into editable rough cuts through transcription, frame analysis, and YAML-based cut assembly.

Core Features & Use Cases

  • Phase 1 Transcribe Audio: uses WhisperX to generate transcripts while preserving timing for accurate alignment.
  • Phase 2 Analyze Frames: uses FFmpeg to extract representative frames and produce visual_transcript.json with descriptive metadata.
  • Phase 3 Rough Cut: aggregates transcripts, selects takes, and exports roughcut.yaml plus Final Cut Pro XML for direct editing.
  • Use Case: Create a cohesive rough cut from a multi-shot video library for a quick editorial pass.

Quick Start

Run the buttercut workflow on your project folder to transcribe audio, analyze frames, and export a Final Cut Pro XML rough cut.

Frequently Asked Questions about buttercut

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate video editing to create a rough cut from raw footage?

Automating video editing to create a rough cut involves transcribing audio with WhisperX, analyzing frames with FFmpeg, and exporting a Final Cut Pro XML file for direct editing.

What is the best way to generate a Final Cut Pro XML rough cut automatically?

Generating a Final Cut Pro XML rough cut automatically requires a workflow that aggregates audio transcripts and extracts representative frames. It then selects takes and exports both a roughcut.yaml and an FCPXML file for direct timeline editing.

Do I need WhisperX and FFmpeg to automate transcription and frame analysis for video editing?

Yes, you need WhisperX and FFmpeg to automate transcription and frame analysis for video editing. WhisperX generates timing-accurate transcripts, while FFmpeg extracts representative frames to produce descriptive visual metadata for the cut.

How does visual frame analysis work when preparing a video rough cut?

Visual frame analysis for a rough cut works by using FFmpeg to extract representative frames from the raw footage. These frames are processed to produce a visual_transcript.json file containing descriptive metadata for editorial decisions.

Can I use YAML to assemble and coordinate my video editing rough cut workflow?

Yes, you can use YAML to assemble a video editing rough cut workflow. The process exports a roughcut.yaml file that aggregates transcripts and take selections, coordinating the assembly before generating the final Final Cut Pro XML.