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