video-frames — Claude Code skill: what it does, how to install
video-frames pulls frames and thumbnails from video files using ffmpeg. It helps Claude Code inspect video contents or grab screenshots at specific timestamps.
MIT ★ 138 updated 2026-09-03
npx skills add happycapy-ai/Happycapy-skills --skill video-frames -a claude-codeWhat video-frames does
The skill handles single-frame video extraction using an ffmpeg script at scripts/frame.sh. You specify the video path along with the --out destination path. Without ffmpeg installed in your system PATH, the execution fails immediately.
To grab a specific moment, pass the --time flag with a timestamp. The author recommends .png for crisp UI screenshots and .jpg for quick inspection. It keeps visual validation fast.
What it helps with
- extract the first frame from a video file
- capture a specific scene using the
--timeflag - export crisp UI frames in
.pngformat - create lightweight
.jpgthumbnails for inspection
Example prompts for the agent
- Extract the first frame from
test.mp4to/tmp/frame.jpg - Save a screenshot from
app-demo.mp4at 00:00:15 as a.pngimage
How to install video-frames
1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill video-frames -a claude-code2Manually: put the files in place
~/.claude/skills/video-frames/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/video-frames/
1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill video-frames -a codex2Manually: put the files in place
.agents/skills/video-frames/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill video-frames -a cursor2Manually: put the files in place
.cursor/skills/video-frames/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install happycapy-ai/Happycapy-skills skills/video-frames2Manually: put the files in place
.github/skills/video-frames/SKILL.md1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill video-frames -a gemini-cli2Platform CLI
gemini skills install https://github.com/happycapy-ai/Happycapy-skills --path skills/video-framesManually: put the files in place
.devin/skills/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 video-frames
How do I install video-frames in Claude Code?
Run npx skills add happycapy-ai/Happycapy-skills --skill video-frames -a claude-code in your terminal.
What does video-frames do?
It runs a shell script that invokes ffmpeg to capture individual static images and thumbnails from video files.
What dependencies does video-frames require?
You must have the ffmpeg binary installed on your machine. On macOS, you can install it using brew install ffmpeg.
Source text
SKILL.md · MIT
---
name: video-frames
description: Extract frames or short clips from videos using ffmpeg.
homepage: https://ffmpeg.org
metadata:
{
"openclaw":
{
"emoji": "🎞️",
"requires": { "bins": ["ffmpeg"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "ffmpeg",
"bins": ["ffmpeg"],
"label": "Install ffmpeg (brew)",
},
],
},
}
---
# Video Frames (ffmpeg)
Extract a single frame from a video, or create quick thumbnails for inspection.
## Quick start
First frame:
```bash
{baseDir}/scripts/frame.sh /path/to/video.mp4 --out /tmp/frame.jpg
```
At a timestamp:
```bash
{baseDir}/scripts/frame.sh /path/to/video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
```
## Notes
- Prefer `--time` for “what is happening around here?”.
- Use a `.jpg` for quick share; use `.png` for crisp UI frames.
© happycapy-ai · MIT · happycapy-ai/Happycapy-skills