video-reader

name	video-reader
description	Analyze a video file (mov, mp4, webm, etc.) or a YouTube video by extracting still frames with ffmpeg and reading them chronologically with vision — Claude cannot ingest video files directly. Use whenever the user provides a video file path or YouTube URL and wants to know what happens in it: "read this video", "watch this video", "check this recording", "what happens in this .mov/.mp4", analyzing a screen recording of a UI bug, or verifying UI behavior captured in a video, even if they don't name this skill.
argument-hint	<video-path-or-youtube-url> [-seq N] [question]

Video Reader

Extract still frames from a video at a fixed interval, read them in order with vision, and report what happens — with timestamps. Primary use case: debugging UI screen recordings (drag-and-drop glitches, animation problems, layout jumps).

Step 1: Parse arguments

From the invocation arguments, extract:

• Video reference (positional): an absolute path to a local video file, or a

  YouTube URL / 11-char video ID.

• -seq / --sequence N: capture one frame every N seconds. Default: 2.

  Must be an integer >= 1. Maps to the script's --interval=N.

• Remaining free text: the user's analysis question (e.g. "when drag ends,

  the item looks like it snaps back to its origin — expected: it moves from the ghost position to the destination"). Answer it in Step 3.

Step 2: Extract frames

bash $HOME/.claude/skills/video-reader/scripts/capture-frames.sh <video-ref> --interval=<N>