Agentic video understanding
Use when an agent must extract moments, quotes, objections, hooks, or evidence from long video or audio cheaper than full-frame ingest — sales calls, podcasts, YouTube episodes, Loom trials, discovery recordings.
Install / Use
npx skills add ericosiu/ai-marketing-skills --skill agentic-video-understandingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SalesSupported Platforms
Tags
Our assessment of Agentic video understanding
Agentic video understanding scores 87/100 on our quality scale, 27th of 41 Sales skills we index.
Its SKILL.md is 3.9 KB long, well organised into 10 sections with 1 code example: a solid amount of guidance for an agent.
With 3,573 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so Agentic video understanding is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
Agentic video understanding compared with similar skills
All 4 of these similar skills score higher than Agentic video understanding; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| Agentic video understanding (this skill)by ericosiu | 87 | 3.6k | 55d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install Agentic video understanding?
- Run
npx skills add ericosiu/ai-marketing-skills --skill "Agentic video understanding". The install tabs above show the steps for each supported agent. - Which AI agents does Agentic video understanding work with?
- It is written for Gemini CLI, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is Agentic video understanding safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is Agentic video understanding still maintained?
- The repository was last updated about 2 months ago, so Agentic video understanding is actively maintained.
Skill content
View source on GitHubname: Agentic video understanding description: >- Use when an agent must extract moments, quotes, objections, hooks, or evidence from long video or audio cheaper than full-frame ingest — sales calls, podcasts, YouTube episodes, Loom trials, discovery recordings. Goal-directed watch via Gemini agentic video understanding (frames, audio, or transcript). Not for cutting, overlays, rendering, scheduling, or publishing.
Agentic video understanding
Hireable understanding layer. The model takes a goal and decides what to watch, at what speed, and through which modality (frames, audio, transcript), fetching only the moments needed. Vendor claims: up to ~66% lower cost and ~88% fewer tokens vs static fixed-FPS ingest, with higher accuracy.
What this is / is not
Is: goal → watch only what you need → timestamps + quotes + confidence.
Is not: a video editor. Do not cut, overlay, caption-burn, render, schedule, post, email, or write CRM from this skill. Hand cuts to Overlap, FFmpeg, or net-new-video-editor. Approvals stay with the calling lane.
When to use
- Pre-call / sales-call mining: buyer objection, next step, competitive mention
- Shortform scoring: find a 3-second standalone hook and in/out points
- Longform / X research: named-person + contrast moments in podcast or YouTube tape
- Talent review: bar evidence in a Loom or trial recording
- Client audit: every mention of a keyword across a discovery recording
Skip when the job is already a clean transcript and you only need text search.
Inputs
| Field | Required | Notes |
|-------|----------|-------|
| source | yes | URL or local media path the runtime can read |
| goal | yes | One sentence retrieval goal |
| keywords | no | Extra strings to bias retrieval |
| max_moments | no | Default 5 |
| modality | no | auto (default), frames, audio, or transcript |
Process
- Restate the goal as 1–3 retrieval queries. Done when each query is falsifiable (you would know if a moment matched).
- Call Gemini agentic video understanding (Gemini API or AI Studio) with
source, queries,max_moments, and modality preference. Prefer the agentic path over fixed-FPS full ingest when available. Done when the API returns candidate windows or an explicit empty set. - Normalize moments into the output schema below. Flag paraphrase vs verbatim. Drop fabricated timestamps. Done when every kept moment has
t_start,t_end,modality,quote,why,confidence. - Stop and hand off to the caller. Do not cut, overlay, schedule, publish, email, or CRM-write.
Output schema
Markdown for humans, optional JSON for machines:
{
"goal": "",
"source": "",
"moments": [
{
"t_start": "MM:SS",
"t_end": "MM:SS",
"modality": "frames|audio|transcript",
"quote": "",
"verbatim": true,
"why": "",
"confidence": 0.0
}
],
"empty_reason": null,
"tokens_note": "agentic path used|fallback static ingest"
}
Hard gates
- No full fixed-FPS ingest when the agentic path is available
- No invented timestamps or quotes
- No dumping full transcripts or client PII into public artifacts
- No cut / render / overlay / schedule / publish / send from this skill
Setup
- Gemini API key or Google AI Studio access: https://ai.studio
- See Google’s developer guide for agentic video understanding in Gemini
- Env:
GEMINI_API_KEY(or the project’s existing Google AI credential)
Caller one-liners
- Pre-call:
goal="exact next-step commitment and any pricing pushback" - Shortform:
goal="best 3-second standalone hook; return in/out for one clip" - Talent:
goal="evidence they hit the role bar on X; max 5 moments" - Audit:
goal="every mention of Reddit, AEO, or budget"
Completion
Done when the caller has the schema above (or a documented empty set) and this skill has performed no side effects beyond the Gemini read.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
