shots
Installation
SKILL.md
Shots
Detect hard cuts (shot boundaries) in video and extract a representative still from the middle of each shot.
Shots vs program-master
| Question | Use shots | Use program-master |
|---|---|---|
| What are you finding? | Hard cuts inside content (camera angle changes, edits) | Structural gaps between programs/parts (black + silent breaks) |
| Typical source | Any edited video | TV master with black+silent separators |
| Output unit | Shot list with timecodes | Content segments with labels (episode, commercial, slate text) |
| Detection method | ffmpeg select=gt(scene,N) |
ffmpeg blackdetect + silencedetect overlap |
Use shots when you need every edit point or shot-level stills for vision analysis. Use program-master when the user asks to label segments, find commercial breaks, or name episodes/parts in a broadcast master. Do not use shot detection for TV structure — a single "shot" may span an entire scene, and program breaks are often fades, not hard cuts.