video-content-analyzer

Q: How do I install video-content-analyzer?

Run npx skills add https://github.com/bradautomates/head-of-content --skill video-content-analyzer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/video-content-analyzer/ (personal) or .claude/skills/video-content-analyzer/ (project).

by bradautomatesMedia & Creative

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"

Installs: 838
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/bradautomates/head-of-content --skill video-content-analyzer

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads video-content-analyzer automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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 variable
google-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": {
        "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": "..."
    }
  }
]

Hook Techniques

The analyzer identifies these hook types:

pattern-interrupt - Breaks expected patterns
question - Opens with engaging question
bold-claim - Makes surprising statement
story-tease - Hints at compelling narrative
visual-shock - Striking visual opening
curiosity-gap - Creates information gap
direct-address - Speaks to specific audience
controversial-take - Polarizing opinion
relatable-pain - Targets common struggle
transformation-preview - Shows before/after

Content Formats

problem-solution - Present problem, offer fix
listicle - Numbered tips/items
story - Narrative arc
tutorial - Step-by-step how-to
before-after - Transformation reveal
day-in-life - Lifestyle content
reaction - Response to other content
hot-take - Opinion piece
tool-demo - Product/tool showcase

FAQ

What does the video-content-analyzer skill do?

How do I install video-content-analyzer?

Run npx skills add https://github.com/bradautomates/head-of-content --skill video-content-analyzer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/video-content-analyzer/ (personal) or .claude/skills/video-content-analyzer/ (project).

Which AI agents can use video-content-analyzer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is video-content-analyzer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains video-content-analyzer?

It is published by bradautomates in bradautomates/head-of-content. It has 838 recorded installs.

More from bradautomates/head-of-content

View all →

instagram-research

bradautomates/head-of-content

Research high-performing Instagram content (posts and reels) from tracked accounts using Apify's Instagram Scraper. Identifies outlier content, analyzes top 5 videos with AI, and generates reports with actionable hook formulas. Use when asked to: - Find trending Instagram content in a niche - Research what's performing on Instagram - Identify high-performing reel patterns - Analyze competitors' Instagram content - Generate content ideas from Instagram trends - Run Instagram research - Find viral reels - Analyze hooks and content structure Triggers: "instagram research", "ig research", "find trending reels", "analyze instagram accounts", "what's working on instagram", "content research instagram", "reel analysis", "instagram trends"

Marketing & SEO1.5K installs

tiktok-research

bradautomates/head-of-content

Research high-performing TikTok videos from tracked accounts using Apify's TikTok Scraper. Identifies outlier content, analyzes top 5 videos with AI, and generates reports with actionable hook formulas. Use when asked to: - Find trending TikTok content in a niche - Research what's performing on TikTok - Identify high-performing video patterns - Analyze competitors' TikTok content - Generate content ideas from TikTok trends - Run TikTok research - Find viral TikToks - Analyze hooks and content structure Triggers: "tiktok research", "tt research", "find trending tiktoks", "analyze tiktok accounts", "what's working on tiktok", "content research tiktok", "tiktok analysis", "tiktok trends"

Marketing & SEO1.2K installs

youtube-research

bradautomates/head-of-content

Open the skill to read its SKILL.md instructions.

Productivity & Automation373 installs

content-planner

bradautomates/head-of-content

Open the skill to read its SKILL.md instructions.

256 installs

x-research

bradautomates/head-of-content

Open the skill to read its SKILL.md instructions.

Productivity & Automation246 installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs

video-content-analyzer

Install

Install

Describe the task

Review the result

SKILL.md

Video Content Analyzer

Prerequisites

Usage

Parameters

Input Format

Output

Hook Techniques

Content Formats

FAQ

More from bradautomates/head-of-content

Popular media & creative skills