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