Video Understanding: Video analysis with Gemini
File support
This skill supports video analysis using Google Gemini models. Supported formats:
Category Extensions
Video .mp4 , .mov , .webm , .avi , .mkv
-
Local video files up to an hour long
-
YouTube links (youtube.com/watch, youtu.be, youtube.com/embed)
Reference: https://ai.google.dev/gemini-api/docs/video-understanding
How to use
bash ${CLAUDE_PLUGIN_ROOT}/scripts/gemini.sh --file=VIDEO_PATH "YOUR QUESTION ABOUT THE VIDEO"
Arguments:
-
--file
-
Required: Local video file path or YouTube URL
-
--model
-
Optional: Model to use (defaults to gemini-3-flash-preview )
Examples:
Analyze a local video
npx -y superconductor-gemini-skills --file=video.mp4 "Summarize this video" npx -y superconductor-gemini-skills --file=presentation.mov "What are the key points discussed?"
Analyze a YouTube video
npx -y superconductor-gemini-skills --file="https://www.youtube.com/watch?v=F0I5M4Pb85k" "Summarize the video" npx -y superconductor-gemini-skills --file="https://youtu.be/F0I5M4Pb85k" "What happens at the 2 minute mark?"
Find specific moments
npx -y superconductor-gemini-skills --file=video.mp4 "What is the best timestamp to represent this video's content?"
API Key
The GEMINI_API_KEY environment variable must be set. Get your key at: https://ai.google.dev/gemini-api/docs/api-key
Models
Model ID Context Window Pricing (Input / Output)
gemini-3-pro-preview
1M / 64k $2 / $12 (<200k), $4 / $18 (>200k)
gemini-3-flash-preview
1M / 64k $0.50 / $3
gemini-2.5-pro
1M / 65k $1.25 / $10 (<200k), $2.50 / $15 (>200k)
gemini-2.5-flash
1M / 65k $0.30 / $2.50