# Claude Real Video For Agents

Install and use crv (claude-real-video), a tool that lets any AI agent watch videos by...

- Repository: https://github.com/HUANGCHIHHUNGLeo/claude-real-video (2278 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-23
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add HUANGCHIHHUNGLeo/claude-real-video --skill claude-real-video-for-agents -g -a claude-code -y`
Codex: `npx skills add HUANGCHIHHUNGLeo/claude-real-video --skill claude-real-video-for-agents -g -a codex -y`
Cursor: `npx skills add HUANGCHIHHUNGLeo/claude-real-video --skill claude-real-video-for-agents -g -a cursor -y`
Gemini CLI: `npx skills add HUANGCHIHHUNGLeo/claude-real-video --skill claude-real-video-for-agents -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add HUANGCHIHHUNGLeo/claude-real-video`

## Description

Install and use crv (claude-real-video), a tool that lets any AI agent watch videos by extracting scene-aware keyframes, deduplicating them, and transcribing audio. Use when the user shares a video URL or file and wants it analyzed, summarized, or discussed.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# claude-real-video for AI agents

## What is crv?

`crv` (claude-real-video) is a CLI tool that extracts meaningful frames and transcripts from videos so AI agents can "see" and "read" them. It uses scene-change detection (not fixed-interval sampling), sliding-window deduplication, and optional Whisper transcription.

**Key advantage**: Same 58-second clip at fixed 1fps = 58 frames. crv keeps the **26 that actually differ**, and `--grid` packs them into **3 contact sheets**. Fewer tokens, nothing missed.

## Installation

### Prerequisites

- Python 3.10+
- ffmpeg / ffprobe on PATH

```bash
# macOS
brew install ffmpeg

# Linux
sudo apt install ffmpeg

# Windows
winget install Gyan.FFmpeg
```

### Install crv

```bash
# Recommended: with audio transcription support
pip install "claude-real-video[whisper]"

# Core only (frames + dedup)
pip install claude-real-video
```

The `[whisper]` extra never installs itself, without it there is **no speech-to-text**
(videos that ship their own subtitles still get a transcript).

### Verify installation

```bash
crv --help
ffmpeg -version
```

### Install as agent skill

Run the bundled installer to symlink this skill into all detected agent platforms:

```bash
bash install-skill.sh
```

Or manually copy to your agent's skill directory:

```bash
# Claude Code
cp -r skills/claude-real-video-for-agents ~/.claude/skills/

# Codex
cp -r skills/claude-real-video-for-agents ~/.codex/skills/

# OpenCode
cp -r skills/claude-real-video-for-agents ~/.opencode/skills/

# Gemini CLI
cp -r skills/claude-real-video-for-agents ~/.gemini/skills/
```

## Usage

### Basic: Watch a video from URL

```bash
crv "https://www.youtube.com/watch?v=VIDEO_ID"
```

Output in `crv-out/`:
- `frames/`, deduplicated keyframes
- `transcript.txt`, plain-text transcript
- `MANIFEST.txt`, summary for LLM consumption

### Recommended: With grid and intent

```bash
crv "https://youtu.be/VIDEO_ID" -o crv-out --grid --why "what the user wants to know"
```

The rest: https://github.com/HUANGCHIHHUNGLeo/claude-real-video/blob/HEAD/skills/claude-real-video-for-agents/SKILL.md