Skill

video-query

Analyzes local video files using Google Gemini API to answer questions about their content. Run via /video-query <video-path> <query>; auto-triggers on video query keywords.

Python

Bash

ai-ml

developer-tools

npx claudepluginhub waterplanai/agentic-config --plugin ac-tools

Tool Access

This skill is limited to using the following tools:

BashRead

Preview

Analyze a video file using Google Gemini API and answer questions about its content.

SKILL.md

Similar Skills

video-perception

453

Analyzes video files (.mp4, .mov, .avi, .mkv, .webm) using ffmpeg for scene changes, silence, motion, transcription; extracts targeted frames and audio segments.

claude-video-vision

volcengine-video-understanding

204

Analyzes video content using Volcengine Ark API with Files upload (up to 512MB). Supports scene/person/action/emotion understanding, Q&A, descriptions, and summaries via Python CLI scripts. Useful for video processing tasks.

1 file

ai-generation-skills

using-superpowers

178.4k

Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.

3 files

superpowers

Stats

Parent Repo Stars28

Parent Repo Forks6

Last CommitMar 6, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Video Query Command

Analyze a video file using Google Gemini API and answer questions about its content.

Video Path: $1 Query: $2

Pre-Flight Checks

Verify Video Path Provided

If $1 is empty: STOP with "Error: Video path required. Usage: /video-query "

Verify Query Provided

If $2 is empty: STOP with "Error: Query required. Usage: /video-query "

Verify Script Exists

Resolve script path from ${CLAUDE_PLUGIN_ROOT}
Check that script exists at resolved path
If not found: STOP with "Error: video-query.py script not found in plugin"

Verify GEMINI_API_KEY

Check if GEMINI_API_KEY environment variable is set
If not set: STOP with "Error: GEMINI_API_KEY not set. Export it: export GEMINI_API_KEY=your_key"

Execution

Resolve Script Path

Use plugin-root path resolution:

SCRIPT_PATH="${CLAUDE_PLUGIN_ROOT}/scripts/video-query.py"

Run Video Query Script

Execute: uv run "$SCRIPT_PATH" "$1" "$2" --json
Capture output

Parse JSON Response

Extract: video_path, query, model, response, usage, cost, time_seconds

Format and Present Results

Present results as:

## Video Analysis Results **Video:** <video_path> **Model:** <model> **Query:** <query> ### Response <model response text> --- **Cost:** $<total_cost_usd> | **Tokens:** <input_tokens> in / <output_tokens> out | **Time:** <time_seconds>s

Error Handling

Error

Action

Video not found

Show: "Video file not found: $1"

API key not set

Show: "GEMINI_API_KEY not set. Export it: export GEMINI_API_KEY=your_key"

API error

Show full error output

Script error

Show full error output

Script not found

Show: "video-query.py not found in plugin"

Setup

Requires GEMINI_API_KEY environment variable:

export GEMINI_API_KEY="your-api-key-here"

Dependencies

UV package manager (for running PEP 723 scripts)

GEMINI_API_KEY environment variable

Video Query Command

Analyze a video file using Google Gemini API and answer questions about its content.

Video Path: $1 Query: $2

Pre-Flight Checks

Verify Video Path Provided
- If $1 is empty: STOP with "Error: Video path required. Usage: /video-query "
Verify Query Provided
- If $2 is empty: STOP with "Error: Query required. Usage: /video-query "
Verify Script Exists
- Resolve script path from ${CLAUDE_PLUGIN_ROOT}
- Check that script exists at resolved path
- If not found: STOP with "Error: video-query.py script not found in plugin"
Verify GEMINI_API_KEY
- Check if GEMINI_API_KEY environment variable is set
- If not set: STOP with "Error: GEMINI_API_KEY not set. Export it: export GEMINI_API_KEY=your_key"

Execution

Resolve Script Path

Use plugin-root path resolution:

SCRIPT_PATH="${CLAUDE_PLUGIN_ROOT}/scripts/video-query.py"

Run Video Query Script
- Execute: uv run "$SCRIPT_PATH" "$1" "$2" --json
- Capture output
Parse JSON Response
- Extract: video_path, query, model, response, usage, cost, time_seconds
Format and Present Results

Present results as:

## Video Analysis Results

**Video:** <video_path>
**Model:** <model>
**Query:** <query>

### Response

<model response text>

---
**Cost:** $<total_cost_usd> | **Tokens:** <input_tokens> in / <output_tokens> out | **Time:** <time_seconds>s

Error Handling

Error	Action
Video not found	Show: "Video file not found: $1"
API key not set	Show: "GEMINI_API_KEY not set. Export it: `export GEMINI_API_KEY=your_key`"
API error	Show full error output
Script error	Show full error output
Script not found	Show: "video-query.py not found in plugin"

Setup

Requires GEMINI_API_KEY environment variable:

export GEMINI_API_KEY="your-api-key-here"

Get API key from: https://aistudio.google.com/apikey

Dependencies

UV package manager (for running PEP 723 scripts)
GEMINI_API_KEY environment variable