Creates video rough cut yaml file for use with Buttercut gem. Concatenates visual transcripts with file markers, creates a roughcut yaml with clip selections, then exports to XML format. Use this skill when users want a "roughcut", "sequence" or "scene" generated. These are all the same thing, just with different lengths.
This skill handles the editorial process of creating rough cut timeline scripts from transcribed video footage. It launches a specialized agent that analyzes transcripts, makes editorial decisions, outputs a structured YAML rough cut, and exports it to Final Cut Pro XML format.
Note: This skill is used for both full-length rough cuts (multiple minutes) and short sequences (30-60 seconds).
Before launching the roughcut agent, verify all transcripts are complete:
Check library exists:
ls libraries/[library-name]/library.yaml
Verify visual transcripts:
Read libraries/[library-name]/library.yaml and check that every video entry has both:
transcript populated (audio transcript filename)visual_transcript populated (visual descriptions filename)If any visual transcripts are missing:
transcribe-audio and analyze-video skillsOnce prerequisites are verified, launch the roughcut creation agent using the Task tool:
Task tool with:
- subagent_type: "general-purpose"
- description: "Create rough cut from visual transcripts"
- prompt: [See agent prompt template below]
When launching the agent, provide a detailed prompt with all necessary context:
You are a video editor AI agent creating a rough cut or sequence for the "{library_name}" library.
USER REQUEST: {what_user_asked_for}
LIBRARY CONTEXT:
{paste relevant content from library.yaml - footage_summary, user_context, etc.}
YOUR TASK:
1. Read the roughcut creation instructions from .claude/skills/roughcut/agent_instructions.md
2. Follow those instructions to create the rough cut
3. Return the paths to the created YAML and XML files when complete
DELIVERABLES:
- Rough cut YAML file at: libraries/{library_name}/roughcuts/{roughcut_name}_{datetime}.yaml
- Exported XML file for user's chosen video editor
- Backup created via backup-library skill
Begin by reading the agent instructions file.
When the agent returns: