# video-analysis

Inspects local video files using direct model ingestion for small clips or ffmpeg frame extraction and Whisper audio transcription for larger media.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1800 installs · ★ 29
- Author: Starchild-ai-agent
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/video-analysis/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/video-analysis

## What it does

The tool processes video files depending on their size threshold, which defaults to 20MB. Smaller clips go directly to a model that handles video input natively, with `google/gemini-3.1-flash-lite` selected as the default. The model reviews both the image sequence and the audio stream together.

When a file exceeds 20MB, the workflow switches to extraction mode. It runs `ffmpeg` to capture keyframes: sampling every 2 seconds for clips under 60 seconds or picking scene-change frames on longer footage, capped at 30 images. Whisper transcribes the spoken dialogue, and the agent receives the resulting stills alongside the transcript context.

The skill operates on local workspace file paths. Direct dotted Python imports fail with a syntax error due to the hyphen in the directory name, so scripts must invoke it from within the skill directory or via dynamic loaders.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill video-analysis -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill video-analysis -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill video-analysis -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills video-analysis
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill video-analysis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path video-analysis
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill video-analysis -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/Starchild-ai-agent/official-skills/tree/HEAD/video-analysis/SKILL.md

## When to use it
- summarize visual events and actions inside a local video file
- extract spoken dialogue into text using Whisper
- split long video recordings into keyframes via scene detection
- read video dimensions, runtime, and audio presence without a full review

## Example prompts
- What happens in this video `output/videos/clip.mp4`?
- Summarize the recording at `output/videos/demo.mp4` and extract the dialogue
- Check the technical metadata for `media/interview.mp4`

## Similar
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [media-use](https://affpapa.org/en/nevibecode/skills/media-use.md) — skill · 1100000 installs
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [subagent-driven-development](https://affpapa.org/en/nevibecode/skills/subagent-driven-development.md) — skill · 237746 installs
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 349800 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 30 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