roughcut
Skill: Roughcut Build
Turns an approved plan into a working roughcut YAML and exported XML. The sub-agent runs async — it commits to a complete cut and returns with notes you can dialogue about.
1. Locate the Plan
A plan path must be passed in as a skill argument (the format produced by cut-planner step 7: libraries/[library-name]/plans/plan_[short-name]_[timestamp].md). If no plan path is passed in, stop immediately and return a message to the parent saying a plan path is required and cut-planner should be run first. Do not search for plans, do not pick one, do not proceed without one.
2. Resolve the Editor (Parent Only)
The sub-agent receives a final editor value:
- If
library.yamlhaseditorset, use it. - Otherwise fall back to
libraries/settings.yaml'seditorand write the value back tolibrary.yaml. - If neither has one, ask the user (Final Cut Pro X / Adobe Premiere Pro / DaVinci Resolve), then save the choice to both
library.yamlandlibraries/settings.yaml.
3. Launch Build Agent
Agent tool with:
- subagent_type: "general-purpose"
- description: "Build roughcut YAML and XML from approved plan"
More from barefootford/buttercut
analyze-video
Adds visual descriptions to transcripts by extracting and analyzing video frames with ffmpeg. Creates visual transcript with periodic visual descriptions of the video clip. Use when all files have audio transcripts present (transcript) but don't yet have visual transcripts created (visual_transcript).
71transcribe-audio
Transcribes video audio using WhisperX, preserving original timestamps. Creates JSON transcript with word-level timing. Use when you need to generate audio transcripts for videos.
50setup
Sets up a Mac for ButterCut. Installs all required dependencies (Homebrew, Ruby, Python, FFmpeg, WhisperX). Use when user says "install buttercut", "set up my mac", "get started", "first time setup", "install dependencies" or "check my installation".
40update-buttercut
A skill to automatically download and install the latest ButterCut version from GitHub while preserving libraries. Use when user wants to check for updates or update their installation for new features.
38backup-library
Backs up user libraries and all their contents (external video excluded). This skill can also be useful when you need to restore a library.
37release
Creates a new ButterCut release with version bump, changelog, git tag, gem build, and GitHub release. Use when publishing a new version.
35