analyze-video
Skill: Analyze Video (parent brief)
Adds visual descriptions to a video's audio transcript by extracting JPG frames with ffmpeg and analyzing them.
SKILL.md is the parent's dispatch brief. The sub-agent's working prompt lives in agent_prompt.md — inline its contents when launching the Task agent. Don't pass SKILL.md.
Prerequisites
Each video must already have an audio transcript. Run transcribe-audio first if any are missing.
Parallelism
Launch at most 8 in parallel. ffmpeg frame extraction is a brief CPU burst at the start; the rest of the runtime is LLM API calls. 8 is a comfortable middle ground that won't saturate older machines.
Inputs to gather and pass inline
video_path— absolute path to the video fileaudio_transcript_path— absolute path to the prepared audio transcript JSONvisual_transcript_path— absolute path to write the visual transcript JSON
After the agent returns, update library.yaml with visual_transcript: <filename>.json.
Next step
Once all videos have visual transcripts, dispatch summarize-video (Haiku model) to produce summaries.
More from barefootford/buttercut
transcribe-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.
46setup
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".
37update-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.
35backup-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.
34release
Creates a new ButterCut release with version bump, changelog, git tag, gem build, and GitHub release. Use when publishing a new version.
32roughcut
Builds a roughcut YAML and exported XML (Final Cut, Premiere, or Resolve) from an approved plan markdown file produced by `cut-planner`. Spins up a sub-agent that reads the library directly, builds the cut iteratively, reviews against format conventions, then returns paths plus conversational editorial notes. If the user asks for a "roughcut", "sequence", or "scene" and no plan exists yet, run `cut-planner` first.
28