video-content-analyzer

Analyze short-form videos with Gemini AI to extract hooks, content structure, delivery style, and CTA strategies.

bradautomates/head-of-content|Updated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGoose

Documentation

Installation Guide

Select your AI agent

How to use video-content-analyzer on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add video-content-analyzer

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

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

Fetches video-content-analyzer from bradautomates/head-of-content and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/video-content-analyzer

Restart Cursor to activate video-content-analyzer. Access via /video-content-analyzer in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

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

video-content-analyzer

Documentation

Installation Guide

How to use video-content-analyzer on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

List & Monetize Your Skill

Use Cases

Task Automation & Efficiency

Knowledge Enhancement

Quality Improvement

Install Skill

Video Content Analyzer

Prerequisites

Usage

Parameters

Input Format

Output

Hook Techniques

Content Formats

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

video-analyzer

remotion-video-production

video-editing

video-downloader

remotion-best-practices

video-understand

Reviews

Discussion