# extract-frames

extract-frames detects shot boundaries in a video and saves the first or last frame of each shot. Use it to review an edit or collect frames from selected shots.

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

## What it does

The skill scans a video for shot changes, then writes extracted frames to a `{video_basename}_frames/` directory beside the input. It defaults to the first frame of each shot. Options let you extract last frames, both ends, or only shots selected by number.

The workflow uses `ffprobe` and `ffmpeg`. For automatic threshold selection, it reviews scene scores and asks you to confirm a proposed value; `--threshold` skips that confirmation. It keeps `scores.txt` so a later run can reuse the frame scores instead of generating them again. Frame extraction depends on both tools being available.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-content@Claudest
```
This installs the whole claude-content plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-frames -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-frames -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-frames -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-content/skills/extract-frames
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-frames -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-content/skills/extract-frames
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/extract-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/gupsammy/Claudest/tree/HEAD/plugins/claude-content/skills/extract-frames/SKILL.md

## When to use it
- detect shot changes in a video
- save the opening frame of every shot
- extract last frames or both ends of each shot
- rerun detection with a different threshold
- process only selected shot numbers

## Example prompts
- Find the shot boundaries in `clip.mp4` and save the first frame of each shot.
- Extract the last frames from `clip.mp4` using threshold `0.15`.
- Save the first and last frames for shots 3 and 5 in `clip.mp4`.

## Similar
- [extract-video-frames](https://affpapa.org/en/nevibecode/skills/extract-video-frames.md) — skill · ★ 1357 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
- [bangumi-frames](https://affpapa.org/en/nevibecode/skills/bangumi-frames.md) — skill · 2300 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1700000 installs
- [manim-video](https://affpapa.org/en/nevibecode/skills/manim-video.md) — skill · 6600 installs

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 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
