| name | video-analyzer |
| description | Analyze any local video file using Gemini's video understanding capabilities. Use when the user asks to analyze a video, describe video contents, understand what happens in a video, extract information from a video, or mentions 'video-analyzer'. Supports MP4, MOV, AVI, WebM, MKV, and more. |
| version | 1.0.0 |
| metadata | [object Object] |
Video Analyzer
Analyze any local video file using Gemini 3.1 Pro (gemini-3.1-pro-preview) video understanding.
When to use
Use this skill when the user wants to:
- Analyze or describe the contents of a video file
- Understand what happens in a video
- Extract text, speech, or information from a video
- Get a detailed summary of video content
- Ask specific questions about a video
- Mentions "video-analyzer" or asks to "analyze this video"
Required Environment Variables
GEMINI_API_KEY- Google AI API key for Gemini API access
Supported Formats
MP4, MOV, AVI, WebM, MKV, FLV, WMV, MPEG, 3GP
Limits: Up to 2 GB per file. Videos up to 1 hour at standard resolution.
Workflow
Step 1: Identify the video file
Determine the video file path. If the user provides a relative path, resolve it to an absolute path. If no specific file is given, look for video files in the current working directory.
Step 2: Determine the analysis prompt
If the user has a specific question about the video, use that as the prompt. Otherwise, use the default comprehensive analysis prompt.
Step 3: Run the analysis script
export GEMINI_API_KEY="YOUR_KEY_HERE"
python ~/.claude/skills/video-analyzer/scripts/analyze.py "<video_path>" "<optional prompt>"
Arguments:
<video_path>(required) - Absolute path to the video file<optional prompt>(optional) - Specific question or analysis request. If omitted, performs a comprehensive analysis.
Examples:
# Comprehensive analysis
python ~/.claude/skills/video-analyzer/scripts/analyze.py "/path/to/video.mp4"
# Specific question
python ~/.claude/skills/video-analyzer/scripts/analyze.py "/path/to/video.mp4" "What text appears on screen?"
# Count people
python ~/.claude/skills/video-analyzer/scripts/analyze.py "/path/to/video.mp4" "How many people are in this video and what are they doing?"
Step 4: Present results
Present the Gemini analysis to the user in a clear, well-formatted way. If the user asked a specific question, highlight the answer. If it was a general analysis, present the full description.
Troubleshooting
- GEMINI_API_KEY not set: Ensure the environment variable is exported before running
- File not found: Verify the video path is correct and absolute
- Processing timeout: Very large videos may take longer; the script waits up to 5 minutes
- Unsupported format: Convert the video to MP4 first using
ffmpeg -i input.xyz output.mp4