youtube-video-analyst
shipshitdev/library
Forensic deconstruction of YouTube videos to extract viral formulas, hooks, and retention mechanics.
What is youtube-video-analyst?
Analyzes YouTube video transcripts to reverse-engineer viral content patterns, hook architecture, emotional triggers, and structural frameworks. Use this when you need to understand what makes a video successful and extract reusable templates for your own content creation.
- Extracts primary and secondary hooks with psychological mechanism analysis
- Maps structural blueprints, pacing patterns, and beat-by-beat transitions
- Identifies open loops, pattern interrupts, and curiosity gaps that drive retention
- Analyzes emotional arcs, trigger words, and identity hooks for viewer connection
- Decodes linguistic patterns, power phrases, and conversational techniques
- Generates fill-in-the-blank script templates based on extracted patterns
How to install youtube-video-analyst
npx skills add https://github.com/shipshitdev/library --skill youtube-video-analyst- YouTube video transcript (auto-fetched via URL or manually pasted)
- Python installed (for optional auto-fetch script)
- Access to transcript sources like YouTube's built-in feature or ytscribe.ai
How to use youtube-video-analyst
- 1.Provide a YouTube URL or video ID, or paste a transcript directly
- 2.Optionally share your niche, content style, target platform, and desired video length for contextualized analysis
- 3.The skill will systematically deconstruct the transcript across 11 analysis sections
- 4.Review the extracted hooks, structural patterns, retention mechanics, and emotional engineering
- 5.Use the fill-in-the-blank templates and implementation checklist to create your own content
Use cases
- Analyze a competitor's viral video to understand its success formula before creating similar content
- Extract hook templates from educational videos to apply to your own tutorials
- Reverse-engineer emotional engineering from storytelling videos to improve your narrative structure
- Study retention mechanics from high-performing videos in your niche to optimize watch time
- Generate content templates by deconstructing multiple successful videos in your category
- Content creators and YouTubers seeking to improve video performance
- Marketing professionals analyzing competitor content strategy
- Course creators studying successful educational video structures
- Social media strategists building viral content frameworks
- Anyone creating video content who wants to understand proven success patterns
youtube-video-analyst FAQ
Use YouTube's built-in transcript feature (click '...' → 'Show transcript'), or use free services like ytscribe.ai or youtubetotranscript.com. You can also run the included fetch_transcript.py script with a YouTube URL.
This skill is optimized for YouTube transcripts, but can analyze any video transcript. The framework applies to any platform (TikTok, Instagram Reels, etc.) if you provide the transcript.
You can manually transcribe the video yourself or use auto-transcription tools. The skill works with any transcript text you provide.
The analysis is exhaustive, covering 11 sections: hooks, structure, retention mechanics, emotional engineering, storytelling, linguistics, algorithm signals, CTAs, virality scoring, templates, and implementation playbooks.
Yes. The skill generates fill-in-the-blank templates specifically designed for adaptation. The implementation guide includes instructions for applying patterns to different topics and styles.
Full instructions (SKILL.md)
Source of truth, from shipshitdev/library.
name: youtube-video-analyst description: Forensic-level deconstruction of YouTube videos to extract viral formulas, hooks, retention mechanics, and emotional engineering. Use when analyzing video transcripts to clone success patterns for new content. disable-model-invocation: true metadata: version: "1.0.0" tags: "content-analysis, youtube, viral-content, hooks, content-strategy"
YouTube Video Analyst
Deconstructs YouTube video transcripts to extract viral formulas, hook architecture, retention mechanics, and emotional engineering patterns.
When to Use This Skill
This skill activates when users:
- Want to analyze a YouTube video transcript
- Need to reverse-engineer viral content formulas
- Ask for hooks, retention mechanics, or emotional triggers from a video
- Want to create content templates based on successful videos
- Request a "viral blueprint" or content deconstruction
Getting the Transcript
Method 1: Auto-Fetch from YouTube URL
Run the fetch script to automatically extract the transcript:
python ${CLAUDE_SKILL_DIR}/scripts/fetch_transcript.py "YOUTUBE_URL_OR_VIDEO_ID"
The script outputs the full transcript text ready for analysis.
Method 2: Manual Paste
User can paste the transcript directly. Common sources:
- YouTube's built-in transcript feature (click "..." → "Show transcript")
- Services like ytscribe.ai, youtubetotranscript.com
- Any other transcript extraction tool
Analysis Process
Approach the transcript like a crime scene investigator examining evidence. Extract EVERYTHING systematically:
- First, read the entire transcript to understand the full arc
- Identify and categorize every hook, transition, and retention mechanism
- Map the emotional journey beat-by-beat
- Decode the structural framework underlying the content
- Extract reusable patterns as fill-in-the-blank templates
- Assign virality scores and explain WHY each element works
- Compile everything into a modular blueprint ready for immediate use
Think step-by-step. Be exhaustive. Miss nothing. Every sentence exists for a reason in viral content—find that reason.
Analysis Framework
Analyze the transcript and extract the following components with surgical precision:
SECTION 1: HOOK ARCHITECTURE
- Primary Hook (first 3-8 seconds): Extract exact wording, identify hook TYPE (curiosity gap, pattern interrupt, bold claim, controversy, story loop, identity trigger), explain psychological mechanism
- Secondary Hooks: Every re-engagement hook throughout the video with timestamp markers
- Hook Templates: Convert each hook into a [BLANK] template for any topic
- Hook Stack Analysis: How multiple hooks layer together in the opening
SECTION 2: STRUCTURAL BLUEPRINT
- Content Framework: Identify the macro-structure (Problem-Agitate-Solve, Story-Lesson-CTA, List-Depth-Summary, etc.)
- Beat Map: Every major transition point and what triggers the shift
- Pacing Pattern: Fast/slow rhythm, where energy peaks and valleys
- Section Breakdown: Divide into clear acts/segments with purpose of each
- Time Allocation: Percentage of video spent on each structural element
SECTION 3: RETENTION MECHANICS
- Open Loops: Every unresolved question or promise that keeps viewers watching
- Pattern Interrupts: Moments designed to snap attention back
- Curiosity Gaps: Information deliberately withheld to create tension
- Payoff Points: Where loops close and satisfaction hits
- Cliffhanger Techniques: Mini-cliffhangers between sections
- "Wait, What?" Moments: Lines designed to stop the scroll
SECTION 4: EMOTIONAL ENGINEERING
- Emotional Arc Map: Graph the emotional journey (anticipation → tension → relief → excitement)
- Trigger Words: Specific words chosen for emotional impact
- Identity Hooks: Moments that make viewers feel "this is for ME"
- Us vs. Them: Any tribal/belonging dynamics created
- Status Plays: Appeals to aspiration, fear of missing out, superiority
- Vulnerability Points: Where authenticity creates connection
SECTION 5: STORYTELLING ELEMENTS
- Narrative Framework: Core story structure used (Hero's Journey, Rags-to-Riches, etc.)
- Character Elements: How the speaker positions themselves
- Conflict/Tension: What creates stakes and drama
- Specificity Anchors: Concrete details that make it believable
- Sensory Language: Words that create mental images
- Dialogue/Quotes: How direct speech is used for impact
SECTION 6: LINGUISTIC PATTERNS
- Power Phrases: High-impact phrases worth stealing
- Sentence Rhythm: Short vs. long sentence patterns
- Repetition Techniques: What gets repeated and why
- Contrast Pairs: Before/after, problem/solution contrasts
- Command Language: Direct instructions to the viewer
- Conversational Triggers: Words that create intimacy ("you," "we," "imagine")
SECTION 7: ALGORITHM SIGNALS
- Watch Time Optimizers: Elements designed to maximize retention
- Engagement Bait: Moments designed to trigger comments
- Share Triggers: What makes someone send this to a friend
- Save Triggers: Information worth bookmarking
- Subscribe Hooks: Why someone would want more
- Thumbnail/Title Alignment: How content delivers on the click promise
SECTION 8: CALL-TO-ACTION ARCHITECTURE
- Primary CTA: Main ask and how it's positioned
- Soft CTAs: Subtle nudges throughout
- CTA Timing: When asks happen and why that timing works
- Value Exchange: What viewer gets for taking action
- Objection Handling: How resistance is preemptively addressed
SECTION 9: VIRAL COEFFICIENT ANALYSIS
- Shareability Score (1-10): With specific reasoning
- Comment Bait Density: How many discussion triggers exist
- Controversy Calibration: Edgy enough to engage, safe enough to share
- Niche Crossover Potential: Appeal beyond core audience
- Emotional Intensity Map: Peaks that trigger sharing impulse
SECTION 10: REUSABLE TEMPLATE OUTPUT
Create a complete fill-in-the-blank script template that captures ALL extracted patterns:
- Opening Hook Template (with 3 variations)
- Section-by-section framework with [BLANKS]
- Transition phrases as templates
- Retention hook templates for each section
- Emotional beat markers
- CTA template sequence
- Suggested timing for each section (as percentages)
SECTION 11: IMPLEMENTATION PLAYBOOK
- "Steal This" Checklist: Top 10 elements to use immediately
- Adaptation Guide: How to apply to different niches
- Common Mistakes: What would break the formula
- Enhancement Opportunities: Where the original could be better
- A/B Test Suggestions: Elements to experiment with
User Context Collection
Before analysis, gather this context from the user:
- MY NICHE/TOPIC: What topic will you create content about?
- MY CONTENT STYLE: Your typical tone (casual, educational, hype, etc.)
- TARGET PLATFORM: YouTube, TikTok, Instagram Reels, Shorts, etc.
- VIDEO LENGTH GOAL: Short-form (<60s), Mid-form (2-10min), Long-form (10min+)
Output Format
Structure your analysis with these sections:
## Hook Architecture
[Primary Hook Analysis]
[Hook Type Classification]
[Secondary Hooks List with Timestamps]
[Fill-in-Blank Hook Templates]
## Structural Blueprint
[Content Framework Identification]
[Complete Beat Map]
[Pacing Analysis]
[Section Breakdown with Percentages]
## Retention Mechanics
[Open Loops Catalog]
[Pattern Interrupts List]
[Curiosity Gap Analysis]
[Payoff Mapping]
## Emotional Engineering
[Emotional Arc Visualization]
[Trigger Word Library]
[Identity Hook Analysis]
[Psychological Lever Breakdown]
## Storytelling Elements
[Narrative Framework]
[Character Positioning]
[Conflict/Stakes Analysis]
[Specificity Anchors List]
## Linguistic Patterns
[Power Phrase Library]
[Rhythm Analysis]
[Repetition Catalog]
[Conversational Trigger Map]
## Algorithm Signals
[Retention Optimizer List]
[Engagement Trigger Catalog]
[Share/Save Trigger Analysis]
## CTA Architecture
[CTA Sequence Map]
[Timing Analysis]
[Value Exchange Framework]
## Viral Coefficient
[Scorecard with Ratings]
[Shareability Analysis]
[Crossover Potential Assessment]
## Reusable Template
[COMPLETE FILL-IN-BLANK SCRIPT TEMPLATE]
[Opening Variations]
[Section Templates]
[Transition Library]
[CTA Templates]
## Implementation Playbook
[Top 10 Steal-This Elements]
[Niche Adaptation Guide]
[Mistake Prevention Checklist]
[Enhancement Opportunities]
[A/B Test Recommendations]
## Quick Reference Cheatsheet
[One-page summary of all extracted patterns for rapid implementation]
Integration with Other Skills
After analysis, use the content-creator skill to:
- Generate new video scripts using the extracted templates
- Create social media content promoting the new video
- Build a content lineup based on the viral formula
Quick Start
- Get transcript (auto-fetch or paste)
- Provide your context (niche, style, platform, length)
- Receive full 11-section viral blueprint
- Use templates to create your own content
Related skills
More from shipshitdev/library and the wider catalog.

financial-operations-expert
Indie business financial clarity: profit tracking, tax planning, and cash flow management across multiple ventures.

nestjs-testing-expert
Testing patterns for NestJS apps using Jest, covering unit, integration, and e2e tests.

web-content-fetcher
Extract article content from any URL as clean Markdown with automatic fallback between fast HTTP and headless browser modes.

shopify-admin
Deprecated skill for Shopify Admin GraphQL—use 'shopify' instead.

shopify-admin-execution
Execute validated Admin GraphQL operations against a Shopify store using Shopify CLI.

shopify-app-store-review
Pre-submission compliance checker for Shopify apps (deprecated—use shopify skill instead).