movie-digestlisted
Install: claude install-skill ShreddyKrueger75/movie-digest
# movie-digest
Claude can't decode video or hear audio. This skill splits the job: a script
does the mechanical part — transcribes the spoken audio with timestamps and
exports one keyframe per scene — and then **Claude reads the transcript and
views the frames** to write the digest.
**The audio is the point.** A narrated screen recording (someone talking through
a bug) is nearly useless as frames alone — the actual report is in the voice.
Transcribe first, read `transcript.md`, *then* look at the frames. Skipping the
transcript and pulling frames with raw `ffmpeg` is the #1 way to miss the whole
message.
## Prerequisites
```bash
brew install ffmpeg
pip install faster-whisper scenedetect
```
`ffmpeg`/`ffprobe` are required. `faster-whisper` and `scenedetect` are
optional and auto-detected — without the first it skips the transcript; without
the second it samples frames at even time intervals (fine for screen
recordings).
## Setup (first run)
On first run in an interactive terminal, the script prompts for three defaults:
```
(1) Diff-threshold mode — how aggressive frame selection is
(2) Generate HTML report by default?
(3) Output directory
```
Your choices save to `~/.movie-digest.json` — reconfigure anytime by deleting that file.
Non-interactive runs (e.g., Claude running the script) auto-write defaults (mode `standard`, HTML report on) without prompting.
## Run (the one path)
```bash
python3 scripts/digest_movie.py "/path/to/CLIP.mov" \
--out "/path/to/CLIP.dig