Index of every page on this site: llms.txt
All skills
bradautomates avatar

/video-content-analyzer

@d841dcf
Run it yourself

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"

Use this Skill: https://skilld.dev/gh/bradautomates/head-of-content/video-content-analyzer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈134 tokens for metadata: the name and description. ≈873 when used: this file.

Description uses 6.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈538 characters, or 6.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

2 warnings2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is functional and generally safe for its intended purpose of video analysis. However, it is susceptible to indirect prompt injection because it processes external video captions and incorporates them into AI prompts without sanitization or boundary markers. This could allow malicious content in a video's metadata to influence the agent's analysis or output format.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer9mo

    2/2 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at d841dcf. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Dormantupdated 10 months ago

README badge

README badge for bradautomates/head-of-content/video-content-analyzer