# Video Processor

A skill that handles video files from the agent: pull the audio track, convert to mp4 or webm, transcribe speech with Whisper. Useful when video files show up in a project.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1554
- Author: disler
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/skills/video-processor/SKILL.md
- Updated: 2026-02-08
- HTML: https://affpapa.org/en/nevibecode/skills/video-processor

## What it does

Video Processor wraps FFmpeg and Whisper into one script with straightforward commands. Four operations are available: extract audio, convert to mp4, convert to webm, and transcribe audio or video to text. Transcription extracts the audio automatically, runs it through Whisper, and cleans up temp files.

FFmpeg and openai-whisper must be installed in the environment first. On macOS that is `brew install ffmpeg`, on Ubuntu `apt-get install ffmpeg`, and Whisper installs via `pip install -U openai-whisper`. The Python dependencies click and ffmpeg-python are pulled in by the script through PEP 723, and commands run with `uv run`.

Transcription models range from tiny to large. Bigger models give better accuracy and consume more RAM. Output formats include txt, srt, vtt, and json with word-level timestamps. For subtitles on a website, the pairing is simple: to-webm first, then transcribe to srt.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill video-processor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/video-processor/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/video-processor/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill video-processor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/video-processor/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill video-processor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/video-processor/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install disler/claude-code-hooks-multi-agent-observability video-processor
```

2. **Manually: put the files in place**
- File: `.github/skills/video-processor/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill video-processor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/disler/claude-code-hooks-multi-agent-observability --path .claude/skills/video-processor
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/video-processor/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill video-processor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/skills/video-processor/SKILL.md

## When to use it
- pull an audio track from a video into wav, mp3, aac or flac
- convert an old camera avi to mp4
- produce a webm version for a web player
- transcribe a lecture or interview to text
- generate srt or vtt subtitles with timestamps

## Example prompts
- convert old_video.avi to mp4
- extract audio from lecture.mp4 and save it as wav
- transcribe this video to srt using the small model

## Similar
- [claude-real-video](https://affpapa.org/en/nevibecode/skills/claude-real-video.md) — skill · 571 installs
- [claude-real-video-for-agents](https://affpapa.org/en/nevibecode/skills/claude-real-video-for-agents.md) — skill · 507 installs
- [video-understand](https://affpapa.org/en/nevibecode/skills/video-understand.md) — skill · 1400 installs
- [video-summarizer](https://affpapa.org/en/nevibecode/skills/video-summarizer.md) — skill · 524 installs
- [video-use](https://affpapa.org/en/nevibecode/skills/video-use.md) — skill · 5100 installs
- [asr-transcribe-to-text](https://affpapa.org/en/nevibecode/skills/asr-transcribe-to-text.md) — skill · 1000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md