video-understand

Analyze video scenes, actions, and subtitles with Gemini.

30|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/qianleigood/crawclaw --skill video-understand-qianleigood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: video-understand
Source: https://github.com/qianleigood/crawclaw/tree/main/skills-optional/video-understand
Command: npx skills add https://github.com/qianleigood/crawclaw --skill video-understand-qianleigood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables rapid understanding of video content by analyzing scenes, actions, and subtitles using Gemini, helping users derive concise insights from a video file, local path, or URL.

Core Features & Use Cases

  • Gemini-powered video understanding to identify shot content, camera perspective, actor actions, scenes, and accompanying subtitles.
  • Handles both local files and URLs; returns structured insights suitable for quick briefs, storyboarding, or feature summaries.
  • Use Case: when you need a brief video summary, shot-by-shot analysis, or a quick extraction of key points for a pitch or report.

Quick Start

Run the run.sh script with a video path or URL to start analysis.

Frequently Asked Questions about video-understand

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

FAQPage Schema
How do I analyze video content to extract scenes and subtitles?

To analyze video content for scenes and subtitles, provide a local file path or URL to the processing script. It returns concise, structured insights detailing shot-level breakdowns, actor actions, and extracted text.

What is the best way to summarize a video using Gemini?

Summarizing a video using Gemini involves passing your file or URL to the analysis script. It utilizes Gemini to identify camera perspectives and actions, producing a human-readable summary suitable for quick briefs.

Can I analyze video files from a URL or do I need to upload local files?

You can analyze video content from both URLs and local file uploads. When uploading local files for scene and subtitle extraction, ensure the file size does not exceed the 20MB limit to successfully generate the structured analysis.

Does this video analysis tool have a file size limit?

Yes, the video analysis tool has a 20MB file size limit for local file uploads. If your video exceeds this constraint, you should provide a video URL instead to perform the shot-by-shot breakdown and feature extraction.

What do I need to run Gemini video analysis on my machine?

To run Gemini video analysis, you need access to the configured API endpoint and key. Once configured, execute the run.sh script with your video path or URL to generate summaries and structured insights.

What kind of insights can I get from a shot-by-shot video breakdown?

A shot-by-shot video breakdown provides structured insights including shot content, camera perspective, actor actions, and accompanying subtitles. This output is suitable for quick briefs, storyboarding, or extracting key points for reports.