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 togemini-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 |