OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add bradautomates/head-of-content --skill video-content-analyzer
Analyze short-form videos with Gemini AI to extract hooks, content structure, and replicable patterns. Supports Instagram Reels, TikTok, and YouTube Shorts.
npx skills add bradautomates/head-of-content --skill video-content-analyzer
Analyze short-form videos with Gemini AI to extract hooks, content structure, delivery style, and CTA strategies.
GEMINI_API_KEY environment variablegoogle-genai and requests Python packages| 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) |
Accepts outlier JSON from platform-specific research skills. Handles both formats:
[{post1}, {post2}, ...]{"outliers": [{post1}, {post2}, ...]}The script automatically maps platform-specific fields:
| Platform | Video URL Fields | Caption | Username |
|---|---|---|---|
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.
Returns JSON array with analysis for each video:
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/afterproblem-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[
{
"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": {
"format": "problem-solution",
"sections": [...],
"pacing": "fast",
"retention_techniques": ["pattern interrupts", "text overlays"]
},
"delivery_style": {
"speaking": "direct-to-camera",
"energy": "high-energy",
"text_overlays": true,
"visual_style": "quick cuts with b-roll"
},
"cta_strategy": {
"type": "follow",
"cta_text": "Follow for more tips",
"placement": "end"
},
"why_it_works": "..."
}
}
]