# extract-video-frames

The extract-video-frames skill samples video at a chosen interval and saves matching audio clips when a soundtrack is present. Use it to prepare a recording for visual review, transcription, or handoff to another agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/skills/extract-video-frames/SKILL.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/extract-video-frames

## What it does

The `ffmpeg`-based script accepts GIF, MP4, and MOV files. It writes PNG images and, for videos with sound, AAC clips covering the same time spans as the corresponding frames. A separate AAC file holds the complete soundtrack. You can set the sampling interval and destination directory; the interval defaults to 1 second.

A `manifest.json` records timestamps, file paths, and audio details. Silent videos and GIFs still produce frames, but no audio files. `ffmpeg` must be installed and available before you run the script, or extraction will fail.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qdhenry/Claude-Command-Suite .claude/skills/extract-video-frames
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qdhenry/Claude-Command-Suite --path .claude/skills/extract-video-frames
```

### Windsurf (Devin Desktop)

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

### 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/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/skills/extract-video-frames/SKILL.md

## When to use it
- sample video frames at a chosen interval
- split audio into clips aligned with the sampled frames
- save the complete soundtrack for transcription
- hand off timestamped frames and audio metadata to another agent

## Example prompts
- Extract frames and audio from `recording.mp4` every 5 seconds.
- Sample `screen.gif` and save the frames in `./frames`.
- Prepare timestamped frames and audio clips from `meeting.mov` for another agent to review.

## Similar
- [extract-frames](https://affpapa.org/en/nevibecode/skills/extract-frames.md) — skill · ★ 276 repo stars
- [video-frames](https://affpapa.org/en/nevibecode/skills/video-frames.md) — skill · ★ 138 repo stars
- [Video Extract](https://affpapa.org/en/nevibecode/mcp/video-extract.md) — MCP server · ★ 12 repo stars
- [Video Processor](https://affpapa.org/en/nevibecode/skills/video-processor.md) — skill · ★ 1573 repo stars
- [c-video](https://affpapa.org/en/nevibecode/skills/c-video.md) — skill · ★ 179 repo stars
- [ffmpeg-video-editor](https://affpapa.org/en/nevibecode/skills/ffmpeg-video-editor.md) — skill · 844 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
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
