watch-video

Installation
SKILL.md

watch-video — let Claude actually watch a video

Most tools only read a transcript and miss everything visual. This skill gives Claude the frames + the words, aligned on one timeline, so it can reason about cuts, on-screen text, demos, and pacing — not just the audio.

How to use it

When the user gives a video URL:

  1. Run the helper (it downloads, samples frames, and transcribes):

    python scripts/watch.py "<VIDEO_URL>" --out watch_out
    

    Useful flags: --max-frames 60 (cap frames), --no-whisper (captions only, fully free/offline), --every 0 (auto-pace by duration).

  2. It writes:

    • watch_out/frames/f000.jpg … — sampled frames (named by index)
    • watch_out/transcript.txt — the spoken words
    • watch_out/index.json — [{frame, t, file}] so each frame maps to its timestamp
Installs
2
GitHub Stars
7
First Seen
Oct 9, 2026