claude-video — What is it?

The bradautomates/claude-video project enables video analysis and interaction through Claude, an AI agent, providing capabilities for content analysis, bug diagnosis, and video summarization.

⭐ 7,672 Stars 🍴 861 Forks Python MIT Author: bradautomates
Source: Official README and linked documentation View on GitHub →

Why it matters

This project is being discussed because its innovative approach to video analysis using AI, addressing the need for efficient video content processing and understanding. Its unique technical choices, such as scene-aware frame extraction and integration with Claude, set it apart in the market.

Source: Official README and linked documentation

Core Features

Video Analysis

The project allows for the analysis of videos by extracting frames, transcribing audio, and providing a timestamped transcript, enabling detailed examination of video content.

Source: Official README and linked documentation
Scene-aware Frame Extraction

It extracts frames based on scene changes, which can be adjusted for efficiency or fidelity, providing a balance between speed and detail.

Source: Official README and linked documentation
Integration with Claude

The project integrates with Claude, an AI agent, to provide detailed analysis and answers based on the video content, enhancing the user experience.

Source: Official README and linked documentation

Architecture

The architecture is modular, with separate components for video downloading, frame extraction, transcription, and interaction with Claude. It uses `yt-dlp` for video downloading, `ffmpeg` for frame extraction, and Whisper API for transcription. The project is structured into various directories for different components, such as `.agents`, `.skills`, and `hooks`.

Source: Official repository tree and dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) yt-dlp ffmpeg Whisper API Video Analysis Scene-aware Frame ExtractionScene-aware Frame E… Integration with ClaudeIntegration with Cl… claude-video Project Core feature Key dependency

Tech Stack

LanguagePythonFrameworkyt-dlp, ffmpeg, Whisper API
yt-dlpffmpegWhisper API
Not specified, but likely to be a local or cloud-based Python environment
Source: Official repository tree and dependency files

Quick Start

To install, use Claude Code with `/plugin marketplace add bradautomates/claude-video` followed by `/plugin install watch@claude-video`. Alternatively, use `npx skills add bradautomates/claude-video -g` for global installation. Manual installation involves cloning the repository and symlinking the `skills/watch` directory into the host's skills directory.
Source: Official README and linked documentation

Use Cases

The project is suitable for developers, content analysts, and anyone needing to analyze video content efficiently. It is useful for diagnosing bugs from video recordings, summarizing long videos, analyzing competitors' content, and extracting insights from video data.

Source: Official README and linked documentation

Strengths & Limitations

Strengths

  • Efficient video analysis with AI integration
  • configurable frame extraction options
  • User-friendly installation and usage

Limitations

  • May require significant computational resources for high-resolution video processing
  • Limited documentation on specific use cases and configurations
Source: Official README and linked documentation

Latest Release

The latest official version is v0.2.0, changelog date is 2026-06-29, and GitHub Release was released on 2026-07-01. Mainly added four levels of detail, default frame deduplication, automatic blocking when Whisper exceeds 25 MB, fixed-point timestamps, no-whisper, and reorganized into self-contained skills to support more Agent Skills hosts.

Source: github.com/bradautomates/claude-video/releases/tag/v0.2.0;https://git…

Verification and evidence

status: docs-only  |  checked_at: 2026-09-23  |  environment: Check the official README, skills/watch/SKILL.md, CHANGELOG and v0.2.0 Release  |  limitations: skill, ffmpeg or yt-dlp not installed; video not downloaded, framing, calling Groq/OpenAI Whisper, reading image or reviewing token/time cost  |  observed_output: Skill frontmatter annotation 0.2.0; README lists ffmpeg, yt-dlp, fourth gear detail and first installation process; changelog date is 2026-06-29, GitHub Release released on 2026-07-01

Source: github.com/bradautomates/claude-video/blob/main/skills/watch/SKILL.md…

Comparison

The Google Gemini API officially supports direct video submission, static mode pressing 1 FPS and audio processing, and also provides agentic mode for long videos; uploading, parsing, and pushing hosted APIs are completed. Claude Video preprocesses locally with yt-dlp and ffmpeg, and then hands over the selected frames and subtitles to the hosting agent. It can directly control the time window and frame budget, but it must maintain dependence and process download permissions. You want to evaluate the Gemini API with hosted native video input; you want to add a checkable local preprocessing process to your existing coding proxy to evaluate Claude Video.

Source: ai.google.dev/gemini-api/docs/video-understanding;https://github.com/…

Verdict

The bradautomates/claude-video project is a tool for anyone needing to analyze video content efficiently and interact with it using AI. Its integration with Claude and configurable frame extraction options make it a valuable asset for developers and content analysts, though it may require significant computational resources and more detailed documentation.

Frequently Asked Questions

What did the documentation review verify for claude-video on 2026-09-23?

Skill frontmatter annotation 0.2.0; README lists ffmpeg, yt-dlp, fourth gear detail and first installation process; changelog date is 2026-06-29, GitHub Release released on 2026-07-01 skill, ffmpeg or yt-dlp not installed; video not downloaded, framing, calling Groq/OpenAI Whisper, reading image or reviewing…

What evidence boundary applies to this claude-video review?

The review environment was: Check the official README, skills/watch/SKILL.md, CHANGELOG and v0.2.0 Release claude-video behavior outside that scope still needs a local check.

Sources and review scope
This review is based on the project's public documentation. Versions, installation commands, and feature boundaries can change upstream; check the cited sources and current release before use. Sources checked on: 2026-09-23 13:55.

Reference materials: README, GitHub API, dependency files