Video breakdown (local)

The client's brief is usually the reference's voiceover rewritten for our product. So what the plan needs from the reference is its visual pattern on the words: on which words it cuts, what kind of picture comes in (and for how long), how often inserts come, and how this changes from the hook to the CTA. The words we already have.

<skill-dir> is the folder holding this file. breakdown.py needs only ffmpeg, numpy, Pillow (tesseract optional).

1. Analyze (about 7 s for a 1-minute video, ~30 s for 4 minutes)

The reference goes in <project>/reference-video/. If the user dropped it loose in the video folder, plan.py init (video-plan) moves it there; otherwise move it yourself with mv, never a copy. Then:

python3 "<skill-dir>/scripts/breakdown.py" analyze "/abs/path/reference-video/REF.mp4"

It writes REF.breakdown/ next to the video: