| name | video-frames |
| description | Extracts frames from video files using ffmpeg for visual analysis. Use when users send videos and want frame-by-frame analysis, thumbnails, or key moment extraction. |
| allowed-tools | Bash, Read, Glob, Write |
Video Frames Skill
Extract frames from video files using ffmpeg for LLM visual analysis.
When to Use
Use when users:
- Send a video and ask "what's in this video?"
- Want specific frames or timestamps extracted
- Need thumbnails or key frames from a video
- Ask to analyze video content visually
Frame Extraction
Use the bundled script via telclaude skill-path:
bash "$(telclaude skill-path video-frames scripts/frame.sh)" <video_path> [output_dir] [interval]
video_path: Path to the video file (check /media/inbox/ for Telegram uploads)output_dir: Where to save frames (default: /media/outbox/frames/)interval: Seconds between frames (default: 2)
Manual extraction (alternative)
Single frame at timestamp:
ffmpeg -ss 00:00:05 -i /media/inbox/video.mp4 -frames:v 1 -q:v 2 /media/outbox/frame.jpg
Key frames only (I-frames):
ffmpeg -i /media/inbox/video.mp4 -vf "select=eq(pict_type\,I)" -vsync vfr -q:v 2 /media/outbox/keyframe_%03d.jpg
Every N seconds:
ffmpeg -i /media/inbox/video.mp4 -vf "fps=1/5" -q:v 2 /media/outbox/frame_%03d.jpg
Video Info
Get duration and metadata:
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 /media/inbox/video.mp4
Output Guidelines
- Extract 3-5 representative frames for short videos (<30s)
- For longer videos, use wider intervals or key frames only
- After extraction, use the Read tool to view frames and describe what you see
- Save output frames to
/media/outbox/ so the relay can send them back
