ac-tools-video-query

ac-tools-video-query is a skill for Claude Code from WaterplanAI/agentic-config. It costs 35 tokens per session (661 once invoked), scanned A, original, MIT.

A skill that sends a video file and a written question to Google Gemini, an AI service that can inspect video content.

In plain words
What is it for?
Use it to analyze a specified video and answer a question about its contents, provided a Gemini API key is configured.
Why use it?
It lets you ask about what happens in a video instead of reviewing the whole file manually.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: positional $N argument.

Part of the agentic-config plugin — 49 skills, 1 plugin shipped together

Good fit Use it to analyze a specified video and answer a question about its contents, provided a Gemini API key is configured.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/waterplanai/agentic-config/ac-tools-video-query
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add WaterplanAI/agentic-config --skill ac-tools-video-query
Clone the repo
git clone --depth 1 https://github.com/WaterplanAI/agentic-config

Made for: Claude Code.

Or install agentic-config, the plugin that ships this one along with the rest of its 49 skills, 1 plugin.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ac-tools-video-query

README.md
[![agentmods](https://agentmods.dev/badge/skills/waterplanai/agentic-config/ac-tools-video-query/github.svg)](https://agentmods.dev/skills/waterplanai/agentic-config/ac-tools-video-query)
Your own site
<a href="https://agentmods.dev/skills/waterplanai/agentic-config/ac-tools-video-query"><img src="https://agentmods.dev/badge/skills/waterplanai/agentic-config/ac-tools-video-query/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ac-tools-video-query

Your own site · 80×15
<a href="https://agentmods.dev/skills/waterplanai/agentic-config/ac-tools-video-query"><img src="https://agentmods.dev/badge/skills/waterplanai/agentic-config/ac-tools-video-query.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 661 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00035 $0.00661
Opus 5 $0.00017 $0.00331
Sonnet 5 $0.00007 $0.00132
Haiku 4.5 $0.00003 $0.00066

Measured 10d ago against content hash 13131848e3d6, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

ac-tools-video-query scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (video-query.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packages/pi-ac-tools/skills/ac-tools-video-query/SKILL.md · 96 lines

How it starts

The opening of the file, as written. The whole thing — 96 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Video Query Command

Compatibility Note

This pi wrapper preserves the original video-query workflow while using a bundled skill-local helper script instead of the legacy plugin root.

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

Video Path: $1 Query: $2

Pre-Flight Checks

  1. Verify Video Path Provided

    • If $1 is empty: STOP with "Error: Video path required. Usage: /skill:ac-tools-video-query "
  2. Verify Query Provided

    • If $2 is empty: STOP with "Error: Query required. Usage: /skill:ac-tools-video-query "
  3. Verify Script Exists

    • Resolve the bundled helper script path from this wrapper skill directory
    • Check that script exists at resolved path
    • If not found: STOP with "Error: video-query.py script not found in plugin"
  4. 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

  1. Resolve Script Path

    • Use skill-local path resolution:
    SCRIPT_PATH="./video-query.py"
    
  2. Run Video Query Script

    • Execute: uv run "$SCRIPT_PATH" "$1" "$2" --json
    • Capture output
  3. Parse JSON Response

    • Extract: video_path, query, model, response, usage, cost, time_seconds
  4. 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"

Read the full file on GitHub · 96 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 96 lines · 35 tokens per session scan A 13131848e3d6

Subscribe to this mod's changes

ac-tools-video-query is a skill published in the GitHub repository WaterplanAI/agentic-config (30 stars, last pushed 1mo ago), licensed MIT. It adds 35 tokens to every session and 661 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

vfx-text-cursor

A video or hero-frame effect where a cursor reveals a sentence character by character with coloured trails, light streaks, and a final shimmer.

nexu-io/html-anything · 36 tokens

dashscope

DashScope (Alibaba Cloud Bailian / 阿里云百炼) integration — image generation (qwen-image-2.0-pro), text-to-speech (qwen3-tts-flash), and ASR with word-level timestamps (qwen3-asr-flash-filetrans). Use when generating images via Qwen-Image, narrating via Qwen-TTS, or transcribing with word-level timestamps via Qwen-ASR.

calesthio/OpenMontage · 93 tokens

editorial-illustrations

Generate meaning-carrying editorial data-illustrations in the monotykamary / Linear aesthetic (near-black grayscale, Inter display + mono labels, hairline framed figures) with a single coral accent. This is a GENERATIVE GUIDE, not a template gallery: it teaches the "claim -> geometry" method so any session can invent…

huytieu/COG-second-brain · 178 tokens

content-factory

Autonomous content pipeline - scout announcements in your field, triage by trend momentum and personal angle, produce posts/blogs/videos in your voice with ledger-based dedup, hard volume caps, and screenshot-verified publishing.

huytieu/COG-second-brain · 47 tokens

museum-art

Source authentic, high-res PUBLIC-DOMAIN artwork from museum open-access APIs (Met, Cleveland, SMK, Rijksmuseum, NGA, Art Institute of Chicago, Getty, Smithsonian) instead of AI-generated or generic-stock imagery. The default move whenever a visual needs an aesthetic, credible image (blog heroes, decks, social cards…

huytieu/COG-second-brain · 83 tokens

llm-prompting-guide

Prompt format rules for generative video and music models. Use when writing or reviewing a prompt for MiniMax H3 (text/image/reference-to-video with native audio) or MiniMax Music 3 (song generation from caption plus lyrics), in ComfyUI or elsewhere. Do NOT use for chat-assistant prompts, or for generative models not…

sammcj/agentic-coding · 79 tokens