media-analysis — Claude Code skill: what it does, how to install
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.
no license 127 installs ★ 26 updated 2026-10-31
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a claude-codeWhat media-analysis 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.
What it helps with
- 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 for the agent
- 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?
How to install media-analysis
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a claude-code2Manually: put the files in place
~/.claude/skills/media-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/media-analysis/
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a codex2Manually: put the files in place
.agents/skills/media-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a cursor2Manually: put the files in place
.cursor/skills/media-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostPlusAI/postplus-skills skills/40-creative/media-analysis2Manually: put the files in place
.github/skills/media-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/40-creative/media-analysisManually: put the files in place
.devin/skills/media-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill media-analysis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about media-analysis
How do I install media-analysis in Claude Code?
Run npx skills add PostPlusAI/postplus-skills --skill media-analysis -a claude-code, then check that the skill file exists at ~/.claude/skills/media-analysis/SKILL.md.
What does media-analysis do?
It analyzes videos, images, and carousels, starting with a local contact sheet. Cloud analysis is only used for important speech gaps that subtitles cannot resolve.
Do I need PostPlus credits for local analysis?
No, the local contact sheet and visual inspection work without an account. Cloud speech analysis spends credits.