video-lens

Download YouTube videos, extract frames, and caption them with a vision model.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ahostbr/dotcodex --skill video-lens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: video-lens
Source: https://github.com/ahostbr/dotcodex/tree/main/skills/video-lens
Command: npx skills add https://github.com/ahostbr/dotcodex --skill video-lens

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extracting insights from long-form YouTube videos is tedious; video-lens automates downloading, frame-by-frame extraction, and captioning/indexing to create searchable video metadata and visual summaries.

Core Features & Use Cases

  • Download a YouTube video, extract frames at configurable intervals, and caption/index every frame using a VLM (LM Studio or Claude API).
  • Generate a structured JSON index and a readable Markdown summary for easy review and downstream processing.
  • Use cases include frame-by-frame analysis, scene summarization, accessibility captioning, and searchable video archives.

Quick Start

Run video-lens with a YouTube URL to download the video, extract frames at a chosen interval, and generate a JSON index plus a readable Markdown summary.

Frequently Asked Questions about video-lens

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

FAQPage Schema
How do I automatically extract and caption frames from a YouTube video?

To automatically extract and caption YouTube frames, you need yt-dlp and ffmpeg installed. The process downloads the video, extracts frames at configurable intervals, and uses a vision language model to generate a searchable JSON index and Markdown summary of the video content.

What is the best way to generate searchable metadata for long-form YouTube videos?

Generating searchable metadata for long-form YouTube videos involves indexing each extracted frame with a vision model. This creates a structured JSON index and a readable Markdown summary, enabling frame-by-frame narration and scene understanding for extensive video archives.

Do I need to install ffmpeg and yt-dlp to use a YouTube video frame extractor?

Yes, you need to install ffmpeg and yt-dlp to download YouTube videos and extract frames. These dependencies are required to process the video file locally before applying a vision model for captioning and indexing the extracted frames.

Can I use LM Studio for vision model captioning of video frames?

Yes, you can use LM Studio for vision model captioning of video frames. The system supports LM Studio or Claude API backends to analyze extracted frames and generate descriptive metadata for scene understanding and frame-by-frame narration.

How does frame extraction interval affect video indexing and scene summarization?

The frame extraction interval determines the frequency of captured frames, directly impacting the granularity of video indexing and scene summarization. A shorter interval captures more frames for detailed analysis, while a longer interval reduces processing time for long-form videos.