video-analyser
Installation
SKILL.md
Video Analyser Skill
Analyse a video file to extract bugs, errors, UI state, and reproduction steps.
The pipeline uses ffmpeg for frame extraction, optional tesseract OCR for text, and optional whisper for audio narration.
The default path (8 keyframes at 768 px) is the Pareto-optimal setting for screen recordings: best quality-per-token on the legibility curve.
By default the selected frames are packed into a single tiled contact sheet and sent to the analysis prompt as one image. This is cheaper on vision tokens and gives a temporal overview at a glance. An opt-in split mode keeps the legacy behaviour of one full-resolution image block per frame — use it when small UI text must be read (see Frame Delivery Mode).
Prerequisites
Required tools
| Tool | Check | If missing |
|---|---|---|
ffmpeg |
which ffmpeg |
Print: ffmpeg is required. Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux). Then exit. |
ffprobe |
which ffprobe |
Print: ffprobe is required. It ships with ffmpeg — reinstall ffmpeg. Then exit. |