Analyze Video Skill
Use this skill when you need to understand the content of a video file before creating clips.
What This Skill Does
Sends a video to Gemini 3 Pro for comprehensive analysis, extracting:
- Speakers: Who appears in the video, their roles/titles if identifiable
- Topics: Main subjects discussed
- Notable Quotes: Memorable statements with timestamps
- Visual Highlights: Dynamic moments, gestures, reveals
- Audience Reactions: Applause, laughter, engagement
- Panel Exchanges: Interesting back-and-forth between speakers
Usage
# Analyze a single video
python skills/analyze-video/analyze.py <video_path>
# Output goes to assets/outputs/analysis/<video_name>.json
Output Format
{
"video_file": "path/to/video.mp4",
"duration_seconds": 120,
"speakers": [
{"name": "Speaker Name", "role": "Title/Organization", "first_seen": "00:05"}
],
"topics": ["Topic 1", "Topic 2"],
"notable_quotes": [
{"speaker": "Name", "quote": "...", "timestamp": "01:23", "context": "..."}
],
"visual_highlights": [
{"timestamp": "02:15", "description": "...", "type": "gesture|reveal|reaction"}
],
"clip_opportunities": [
{
"start": "01:20",
"end": "01:45",
"type": "quote|exchange|highlight",
"description": "...",
"score": 8
}
]
}
Notes
- For videos >100MB, upload to Gemini File API (handled automatically)
- Analysis typically takes 30-60 seconds per video
- Timestamps are in MM:SS format