| name | video-content-analyzer |
| description | Analyze short-form videos with Gemini AI to extract hooks, content structure, and replicable patterns.
Supports Instagram Reels, TikTok, and YouTube Shorts.
Use when asked to:
- Analyze video content for hooks and structure
- Extract replicable formulas from viral videos
- Understand why a video performed well
- Get AI analysis of video content patterns
Triggers: "analyze videos", "extract hooks", "video analysis", "analyze reels",
"what makes this video work", "hook analysis", "content structure analysis"
|
Video Content Analyzer
Analyze short-form videos with Gemini AI to extract hooks, content structure, delivery style, and CTA strategies.
Prerequisites
GEMINI_API_KEY environment variablegoogle-genai and requests Python packages
Usage
python3 .claude/skills/video-content-analyzer/scripts/analyze_videos.py \
--input outliers.json \
--output video-analysis.json \
--platform instagram \
--max-videos 5
Parameters
| Arg | Description |
|---|
--input, -i | Input JSON file with outlier posts (required) |
--output, -o | Output JSON file for results (required) |
--platform, -p | Platform: instagram, tiktok, or youtube (default: instagram) |
--max-videos, -n | Max videos to analyze (default: 5) |
Input Format
Accepts outlier JSON from platform-specific research skills. Handles both formats:
- Direct list:
[{post1}, {post2}, ...]
- Wrapped:
{"outliers": [{post1}, {post2}, ...]}
The script automatically maps platform-specific fields:
| Platform | Video URL Fields | Caption | Username |
|---|
| Instagram | videoUrl | caption | ownerUsername |
| TikTok | videoUrl, video_url, webVideoUrl | text, desc | authorUsername |
| YouTube | videoUrl, url | title | channelTitle |
TikTok Note: The Apify TikTok Scraper returns webVideoUrl (the TikTok page URL) rather than a direct video download URL. Gemini will attempt to analyze from this page URL.
Output
Returns JSON array with analysis for each video:
[
{
"post_id": "ABC123",
"username": "creator",
"url": "https://...",
"platform": "instagram",
"likes": 50000,
"comments": 1200,
"views": 500000,
"analysis": {
"hook": {
"technique": "pattern-interrupt",
"opening_line": "Stop scrolling if you...",
"attention_grab": "Creates urgency and targets specific audience",
"replicable_formula": "Stop scrolling if you [pain point]"
},
"content_structure": {
...
Hook Techniques
The analyzer identifies these hook types:
pattern-interrupt - Breaks expected patternsquestion - Opens with engaging questionbold-claim - Makes surprising statementstory-tease - Hints at compelling narrativevisual-shock - Striking visual openingcuriosity-gap - Creates information gapdirect-address - Speaks to specific audiencecontroversial-take - Polarizing opinionrelatable-pain - Targets common struggletransformation-preview - Shows before/after
Content Formats
problem-solution - Present problem, offer fixlisticle - Numbered tips/itemsstory - Narrative arctutorial - Step-by-step how-tobefore-after - Transformation revealday-in-life - Lifestyle contentreaction - Response to other contenthot-take - Opinion piecetool-demo - Product/tool showcase
