# media-analysis

media-analysis — a skill for videos, images, and carousels. It builds a local contact sheet first and only reaches for cloud speech analysis when subtitles fall short.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 127 installs · ★ 26 repo stars
- Author: PostPlusAI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/40-creative/media-analysis/SKILL.md
- Updated: 2026-10-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/media-analysis

## What it does

The skill starts any video by creating a local contact sheet. The CLI samples about a frame each second, catches scene-change candidates, and keeps the last decoded frame, each with real source timestamps. Check these sheets before deciding on any cloud work.

Most visual questions are answered from those local frames: structure, scene order, composition, visible copy, how a product is shown. Small text gets a full-size look. Cloud inference is reserved for a specific gap in speech that readable subtitles cannot establish, like pauses, laughter, interruptions, or who is speaking. Subtitles are visible text, not a verified transcript.

Install with `npx skills add PostPlusAI/postplus-skills --skill media-analysis -a claude-code`, then look for the file at `~/.claude/skills/media-analysis/SKILL.md`. The local pass needs no PostPlus account; the cloud step spends credits. Without credits the cloud step will not run, so top up before you rely on it. A sample run: `postplus media analyze video-analysis --video ./reference.mp4 --json --output ./contact-sheet.json`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostPlusAI/postplus-skills skills/40-creative/media-analysis
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/40-creative/media-analysis
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill media-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/PostPlusAI/postplus-skills/tree/HEAD/skills/40-creative/media-analysis/SKILL.md

## When to use it
- build a contact sheet from a local video file
- map the visual order of a carousel
- check which frames the sampler caught before spending cloud credits
- assess spoken tone when subtitles miss fillers and pauses

## Example prompts
- Show me the contact sheet for `./reference.mp4`
- List the frames in this carousel in order
- Is there a speech gap in this video that the subtitles don't cover?

## Similar
- [reference-media-analysis](https://affpapa.org/en/nevibecode/skills/reference-media-analysis.md) — skill · 193 installs
- [social-media-image-sizes](https://affpapa.org/en/nevibecode/skills/social-media-image-sizes.md) — skill · 1900 installs
- [tracelens-analysis-orchestrator](https://affpapa.org/en/nevibecode/skills/tracelens-analysis-orchestrator.md) — skill · 1300 installs
- [measure-survey-analysis](https://affpapa.org/en/nevibecode/skills/measure-survey-analysis.md) — skill · 730 installs
- [results-analysis](https://affpapa.org/en/nevibecode/skills/results-analysis.md) — skill · 556 installs
- [media-asset-management](https://affpapa.org/en/nevibecode/skills/media-asset-management.md) — skill · 302 installs

From the same set: [postplusai/postplus-skills](https://affpapa.org/en/nevibecode/by/postplusai/postplus-skills.md) — 25 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
