video-understandinglisted
Install: claude install-skill stevederico/video-understanding
# video-understanding
Full pipeline for turning videos into agent-understandable output: timestamped frames + SRT transcript, followed by agent review that correlates visuals with speech and writes a complete `understanding.md`.
Stage 1 is mechanical extraction. Stage 2 is the agent analysis. Generic for any video content.
**Skill root:** `~/.agents/skills/video-understanding/` (also linked as Claude skills via `~/.agents/skills`).
## Prerequisites (local STT + ffmpeg)
Stage 1 needs **ffmpeg** + **whisper.cpp (`whisper-cli`)** + a ggml model.
Install / repair the local stack with **[local-ai-cli](https://github.com/stevederico/local-ai-cli)** (builds whisper.cpp + models, puts tools on PATH):
```bash
git clone https://github.com/stevederico/local-ai-cli.git && cd local-ai-cli && bash setup.sh
# ensures whisper-cli, ffmpeg (via brew), model under ~/.local/opt/whisper.cpp/
```
Do not freestyle alternate whisper installs unless the user asks — use local-ai-cli as the source of truth.
## Optional: BYOK mode (install-free)
The CLI also supports `VU_PROFILE=byok` (xAI STT + optional Mux frames) when keys are set — see repo README. Stage-1 extraction script still implements this; prefer **local** + local-ai-cli unless the user asks for BYOK.
## Configuration
Use `VU_PROFILE=local` (default, fully local whisper) or `grok`.
Default frame interval: 500ms (use --interval 500ms / 0.5 / 2 etc).
Profiles: `~/.agents/skills/video-understanding/config/profiles/<name>.sh` (or use