watch-video

Extract frames, contact sheets, and transcripts from video files or URLs for visual analysis.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/timikalo7/Execute --skill watch-video-timikalo7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: watch-video
Source: https://github.com/timikalo7/Execute/tree/main/.claude/skills/watch-video
Command: npx skills add https://github.com/timikalo7/Execute --skill watch-video-timikalo7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imageio-ffmpeg, yt-dlp, Pillow, openai-whisper.

What problem does it solve? AI agents cannot read video files directly, so reviewing a TikTok, Instagram reel, YouTube clip, or screen recording normally requires manual watching. This Skill converts any video into evenly-spaced frames and a labelled contact sheet that the agent can read as images, plus an optional audio transcript. ## Core Features & Use Cases - Frame extraction and contact sheets: Samples N evenly-spaced frames from any local video or URL and tiles them into a single timestamped contact sheet for at-a-glance review. - Platform link support: Downloads TikTok, Instagram reels, YouTube, and direct mp4 URLs via yt-dlp with a curl fallback, including documented workarounds for platform-specific failures. - Optional transcription: Extracts audio and transcribes it with openai-whisper when narration carries the content. - Use Case: A user pastes an Instagram reel link and asks the agent to analyze it; the Skill downloads the clip, produces a contact sheet and frames, and the agent reads them to summarize and act on the content. ## Quick Start Run the watch.py script on a video file path or pasted video URL with a chosen frame count, then read the printed contact sheet and frame images to analyze the clip.

Frequently Asked Questions about watch-video

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a video with an AI agent?

Run the watch.py script with the video path or URL and a frame count. It extracts evenly-spaced frames and a labelled contact sheet as images, which the agent reads directly, plus an optional transcript with the --transcribe flag.

How to extract frames from a video using ffmpeg in Python?

The script locates ffmpeg via imageio-ffmpeg, computes the video duration, then runs ffmpeg with -ss at evenly-spaced timestamps to save scaled JPEG frames. No system ffmpeg installation or root access is required.

Can yt-dlp download TikTok and Instagram reels?

Yes, TikTok and Instagram reels download end-to-end through yt-dlp in this pipeline, and Instagram failures are often transient so retrying once is recommended. YouTube metadata works but media downloads may return 403 from datacenter IPs.

Does video transcription require a whisper installation?

Transcription requires the openai-whisper package installed via pip. Without it, the script still extracts the audio to a WAV file and reports that no whisper backend is available.

Why does yt-dlp fail with a Python traceback instead of a download error?

A traceback such as a pyo3_runtime PanicException from secretstorage indicates an environment bug, typically an incompatible system cryptography package. Upgrading cryptography with pip install --user --upgrade cryptography resolves it; retrying the URL will not.