Claude Code Plugins

Community-maintained marketplace

Feedback

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.

Install Skill

Shared

Installs to .agents/skills, used by Codex, Amp, Warp, Cursor, OpenCode, and more.

CodexAmp
Warp
CursorOpenCode
Cline
Gemini CLI
GitHub Copilot
Personal

Available across projects.

$npx skills-installer add @j8647877-hash/claude-code-skills/video-analyzer --client shared
Project

Writes to .agents/skills.

$npx skills-installer add @j8647877-hash/claude-code-skills/video-analyzer -p --client shared
Note: Review the skill instructions before using it.

SKILL.md

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