extract-video-frames — Claude Code skill: video frames and audio
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.
no license ★ 1,357 updated 2026-03-01
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a claude-codeWhat extract-video-frames 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.
What it helps with
- 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 for the agent
- Extract frames and audio from
recording.mp4every 5 seconds. - Sample
screen.gifand save the frames in./frames. - Prepare timestamped frames and audio clips from
meeting.movfor another agent to review.
How to install extract-video-frames
1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a claude-code2Manually: put the files in place
~/.claude/skills/extract-video-frames/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/extract-video-frames/
1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a codex2Manually: put the files in place
.agents/skills/extract-video-frames/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a cursor2Manually: put the files in place
.cursor/skills/extract-video-frames/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qdhenry/Claude-Command-Suite .claude/skills/extract-video-frames2Manually: put the files in place
.github/skills/extract-video-frames/SKILL.md1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a gemini-cli2Platform CLI
gemini skills install https://github.com/qdhenry/Claude-Command-Suite --path .claude/skills/extract-video-framesManually: put the files in place
.devin/skills/extract-video-frames/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 extract-video-frames
How do I install extract-video-frames in Claude Code?
Run npx skills add qdhenry/Claude-Command-Suite --skill extract-video-frames -a claude-code. The skill file is at ~/.claude/skills/extract-video-frames/SKILL.md.
What does extract-video-frames do?
It saves PNG frames at set intervals and, when the source has audio, creates matching AAC clips plus a continuous audio track. The manifest.json lists timestamps and output paths.
Does the skill require ffmpeg?
Yes. The extraction script uses ffmpeg, which needs to be available on the system before you run it.