video-frames

Extract single frames from video files at timestamps or frame indexes using ffmpeg.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill video-frames-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: video-frames
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/video-frames
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill video-frames-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, and includes scripts (resource) components.

What problem does it solve? Inspecting video content often requires pulling out individual frames for review, thumbnails, or debugging, and doing this manually through a video player is slow and imprecise. This Skill extracts exact frames from any video file with a single command. ## Core Features & Use Cases - Timestamp Extraction: Capture the frame at an exact time position (e.g., 00:00:10) to see what is happening at a specific moment. - Frame Index Selection: Extract a frame by its numeric index for precise, deterministic grabs. - Format Flexibility: Output JPG for quick sharing or PNG for crisp UI captures. - Use Case: While reviewing a screen recording of a failed test run, extract the frame at the exact timestamp where the error dialog appeared and attach it to a bug report. ## Quick Start Extract the frame at the 10-second mark from recording.mp4 and save it as frame-10s.jpg.

Frequently Asked Questions about video-frames

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract a frame from a video at a specific timestamp?

Run the frame.sh script with the video path, the --time flag in HH:MM:SS format, and an --out path. It invokes ffmpeg with -ss to seek to that position and writes a single frame image.

How to extract a frame by index using ffmpeg?

Pass the --index flag with a frame number to frame.sh. The script applies ffmpeg's select filter with eq(n,INDEX) and outputs exactly one frame, which is useful when you know the frame number rather than the timestamp.

Does frame extraction require ffmpeg to be installed?

Yes, the ffmpeg binary must be available on the system. The Skill metadata declares ffmpeg as a required binary and provides a Homebrew install option for macOS.

Should I use JPG or PNG for extracted video frames?

Use JPG for quick sharing and smaller file sizes. Use PNG when you need crisp detail, such as capturing UI elements or text from screen recordings where compression artifacts would reduce readability.

Why does frame extraction fail on my video file?

The script exits with an error if the input file does not exist or if --out is missing. Also verify ffmpeg supports the video's codec and container format, since unsupported files cause ffmpeg itself to fail.