avivsinai 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