Agentic video understanding

Extracts timestamped moments and quotes from video and audio via Gemini agentic video understanding.

3.6k|688|Updated Mar 28, 2026
Ready to run
npx skills add https://github.com/ericosiu/ai-marketing-skills --skill agentic-video-understanding-ericosiu
💬 Prompt for ChatGPT / Claude Chat▼
Please help me install this Agent Skill.
Skill: Agentic video understanding
Source: https://github.com/ericosiu/ai-marketing-skills/tree/main/agentic-video-understanding
Command: npx skills add https://github.com/ericosiu/ai-marketing-skills --skill agentic-video-understanding-ericosiu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Mining long video or audio recordings for specific moments normally requires ingesting every frame at a fixed rate, which is slow and expensive. This Skill performs goal-directed retrieval through Gemini agentic video understanding, returning only the timestamps, quotes, and confidence scores an agent needs. ## Core Features & Use Cases - Goal-Directed Retrieval: Accepts a source URL or local media path plus a one-sentence goal, then returns ranked moments with t_start, t_end, modality, quote, and confidence. - Multi-Modality Watching: Selects frames, audio, or transcript per query, with vendor-claimed cost and token reductions versus fixed-FPS full ingest. - Use Case: Before a sales follow-up call, ask for the exact next-step commitment and any pricing pushback from a recorded discovery call, and receive up to five timestamped, quotable moments without watching the full recording. ## Quick Start Set your GEMINI_API_KEY environment variable, then ask the agent to find the buyer objection and next step in the attached sales call recording.

Frequently Asked Questions about Agentic video understanding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract key moments from a long video with Gemini?▼

Provide a source URL or local media path plus a one-sentence goal, and Gemini agentic video understanding returns ranked moments with t_start, t_end, quote, and confidence. The model decides what to watch and through which modality instead of ingesting every frame.

What is agentic video understanding vs fixed-FPS ingest?▼

Agentic video understanding lets the model choose which frames, audio, or transcript segments to inspect based on a retrieval goal. Vendor claims cite up to roughly 66% lower cost and 88% fewer tokens than static fixed-FPS full ingest, with higher accuracy.

Can I use this to edit or cut video clips?▼

No. This Skill is understanding only and performs no cutting, overlays, rendering, scheduling, or publishing. It returns timestamps and quotes, then hands off to tools like FFmpeg or a dedicated video editor for any production work.

What API key do I need for Gemini video understanding?▼

You need a Gemini API key or Google AI Studio access, set as the GEMINI_API_KEY environment variable. AI Studio access is available at https://ai.studio, and existing Google AI project credentials also work.

When should I not use agentic video retrieval?▼

Skip it when the job is already a clean transcript and you only need plain text search. It is designed for cases where an agent needs timestamps and quotes from raw video or audio without processing every frame.