Gives Claude video understanding by extracting frames and transcript, then feeding both back for analysis. Downloads with yt-dlp, pulls captions when available, falls back to Whisper API when not. Auto-scales frame rate based on duration to stay under 100 frames, hitting about 2 fps for short clips and spacing out for longer ones. Works on YouTube, Vimeo, TikTok, local files, most things yt-dlp handles. Supports time ranges if you want dense coverage of a specific moment instead of a sparse scan of the whole thing. The focused mode is the real win for long videos where the question is about one section. Setup handles ffmpeg and API keys through an idempotent installer.
- install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
- 26
- skills.sh installs
- 18.6K
- GitHub stars
- 20.4K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add bradautomates/claude-video --skill watch --agent claude-codeInstalls into .claude/skills of the current project.
Files
/watch
Run the bundled Python script. With the gemini engine (a GEMINI_API_KEY is configured) Google's video model watches the video and the report carries its timestamped answer for you to relay. With the local engine the script produces timestamped frames and a transcript; view the frames and answer from that evidence. Native captions come first; the chosen local or cloud backend is only a fallback. Transcript-only evidence cannot establish visual facts.
Resolve the skill and interpreter
SKILL_DIR is the absolute directory containing this SKILL.md; scripts/ sits beside it.
Commands below use python3 for macOS/Linux. On Windows, verify a working Python 3.10+ with python --version or py -3 --version and use that interpreter. python3 is not always a Store alias; inspect the actual result. In PowerShell use $SKILL_DIR rather than Bash variable syntax, for example:
python "$SKILL_DIR/scripts/setup.py" --json
Use the host's available shell, image viewer, and question tool. AskUserQuestion and Bash are examples, not requirements for every host.
First run and setup
On the first invocation in a session:
Sponsors
Details
- Repository
- github.com/bradautomates/claude-video
- Categories
- Backend & APIs, Generative Media, Video & Audio Editing
- First seen
- Jun 3, 2026
