
Youtube Video Analyst
- 1.1k installs
- 31 repo stars
- Updated August 2, 2026
- shipshitdev/library
youtube-video-analyst provides documented workflows for Forensic-level deconstruction of YouTube videos to extract viral formulas, hooks, retention mechanics, and emotional engineering. Use when analyzing video trans
About
The youtube-video-analyst skill 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 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 bash 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 ext.
- 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
Youtube Video Analyst by the numbers
- 1,056 all-time installs (skills.sh)
- Ranked #382 of 2,203 Security skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
youtube-video-analyst capabilities & compatibility
- Capabilities
- want to analyze a youtube video transcript · need to reverse engineer viral content formulas · ask for hooks, retention mechanics, or emotional · want to create content templates based on succes · request a "viral blueprint" or content deconstru
- Use cases
- documentation
What youtube-video-analyst says it does
# YouTube Video Analyst Deconstructs YouTube video transcripts to extract viral formulas, hook architecture, retention mechanics, and emotional engineering patterns.
### Method 2: Manual Paste User can paste the transcript directly.
npx skills add https://github.com/shipshitdev/library --skill youtube-video-analystAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.1k |
|---|---|
| repo stars | ★ 31 |
| Security audit | 2 / 3 scanners passed |
| Last updated | August 2, 2026 |
| Repository | shipshitdev/library ↗ |
How do I use youtube-video-analyst for the task described in its SKILL.md triggers?
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 ne.
Who is it for?
Teams invoking youtube-video-analyst when the user request matches documented triggers and prerequisites.
Skip if: Skip when cached docs are missing, the request is a negative trigger, or another sibling skill owns the workflow.
When should I use this skill?
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.
What you get
Step-by-step guidance grounded in youtube-video-analyst documentation and reference files.
- viral deconstruction report
- hook type classification
- retention mechanics map
By the numbers
- Ships an 11-section viral content deconstruction checklist
- Version 1.0.0 under MIT license
Files
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:
1. First, read the entire transcript to understand the full arc 2. Identify and categorize every hook, transition, and retention mechanism 3. Map the emotional journey beat-by-beat 4. Decode the structural framework underlying the content 5. Extract reusable patterns as fill-in-the-blank templates 6. Assign virality scores and explain WHY each element works 7. 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
1. Get transcript (auto-fetch or paste) 2. Provide your context (niche, style, platform, length) 3. Receive full 11-section viral blueprint 4. Use templates to create your own content
{
"name": "youtube-video-analyst",
"version": "1.0.0",
"description": "Forensic-level deconstruction of YouTube videos to extract viral formulas, hooks, retention mechanic",
"author": {
"name": "Ship Shit Dev",
"email": "hello@shipshit.dev",
"url": "https://github.com/shipshitdev"
},
"license": "MIT",
"skills": "."
}
Viral Video Analysis Framework
Quick reference for the 11-section viral content deconstruction.
---
Analysis Checklist
1. Hook Architecture
- [ ] Primary hook extracted (first 3-8 seconds)
- [ ] Hook type identified (curiosity gap, pattern interrupt, bold claim, controversy, story loop, identity trigger)
- [ ] Secondary hooks cataloged with timestamps
- [ ] Fill-in-blank templates created
2. Structural Blueprint
- [ ] Content framework identified (PAS, Story-Lesson-CTA, List-Depth-Summary, etc.)
- [ ] Beat map complete (all transition points)
- [ ] Pacing pattern analyzed
- [ ] Section breakdown with time percentages
3. Retention Mechanics
- [ ] Open loops cataloged
- [ ] Pattern interrupts listed
- [ ] Curiosity gaps identified
- [ ] Payoff points mapped
4. Emotional Engineering
- [ ] Emotional arc graphed
- [ ] Trigger words extracted
- [ ] Identity hooks found
- [ ] Us vs. Them dynamics noted
5. Storytelling Elements
- [ ] Narrative framework identified
- [ ] Character positioning analyzed
- [ ] Conflict/stakes mapped
- [ ] Specificity anchors listed
6. Linguistic Patterns
- [ ] Power phrases extracted
- [ ] Sentence rhythm analyzed
- [ ] Repetition techniques noted
- [ ] Conversational triggers mapped
7. Algorithm Signals
- [ ] Watch time optimizers found
- [ ] Engagement bait identified
- [ ] Share/save triggers noted
- [ ] Subscribe hooks analyzed
8. CTA Architecture
- [ ] Primary CTA mapped
- [ ] Soft CTAs throughout noted
- [ ] Timing analyzed
- [ ] Value exchange defined
9. Viral Coefficient
- [ ] Shareability scored (1-10)
- [ ] Comment bait density measured
- [ ] Controversy calibration assessed
- [ ] Crossover potential evaluated
10. Reusable Templates
- [ ] Opening hook templates (3 variations)
- [ ] Section templates with blanks
- [ ] Transition phrase library
- [ ] CTA templates
11. Implementation Playbook
- [ ] Top 10 steal-this elements
- [ ] Niche adaptation guide
- [ ] Common mistakes listed
- [ ] A/B test suggestions
---
Hook Types Reference
| Type | Description | Example Pattern |
|---|---|---|
| Curiosity Gap | Creates information deficit | "The one thing nobody tells you about..." |
| Pattern Interrupt | Breaks expectations | "Forget everything you know about..." |
| Bold Claim | Makes audacious statement | "This changed my entire business in 30 days" |
| Controversy | Challenges consensus | "Why [popular thing] is actually wrong" |
| Story Loop | Opens narrative | "Last week, something happened that..." |
| Identity Trigger | Speaks to who viewer is | "If you're a [type of person], this is for you" |
---
Content Framework Templates
Problem-Agitate-Solve (PAS)
[PROBLEM]: State the pain point
[AGITATE]: Make it worse, show consequences
[SOLVE]: Present your solutionStory-Lesson-CTA
[STORY]: Personal narrative or case study
[LESSON]: Key takeaway or insight
[CTA]: What viewer should do nextList-Depth-Summary
[LIST]: Introduce N items/tips/strategies
[DEPTH]: Deep dive on each
[SUMMARY]: Recap + action stepBefore-After-Bridge
[BEFORE]: Current painful state
[AFTER]: Desired future state
[BRIDGE]: How to get there---
Emotional Arc Patterns
The Rollercoaster
Hope → Tension → Relief → Excitement → ActionThe Build-Up
Curiosity → Anticipation → Revelation → SatisfactionThe Transformation
Pain → Struggle → Breakthrough → Triumph---
Power Phrase Templates
Opening Hooks
- "Here's what [experts/nobody] won't tell you about [TOPIC]..."
- "I spent [TIME] figuring out [TOPIC] so you don't have to..."
- "Stop [COMMON MISTAKE] - do this instead..."
- "The [NUMBER] [TOPIC] mistakes that cost me [CONSEQUENCE]..."
Retention Phrases
- "But here's where it gets interesting..."
- "And this is the part most people miss..."
- "Wait, it gets better..."
- "Now pay attention to this next part..."
Transition Phrases
- "Now that you understand [X], let's talk about [Y]..."
- "This brings us to the most important point..."
- "Here's where everything changes..."
CTA Phrases
- "If this helped, you'll love [NEXT ACTION]..."
- "Drop a [COMMENT] if you want me to cover [TOPIC]..."
- "The link is in the description..."
---
Viral Scorecard
Rate each element 1-10:
| Element | Score | Notes |
|---|---|---|
| Hook Strength | /10 | |
| Retention Mechanics | /10 | |
| Emotional Intensity | /10 | |
| Shareability | /10 | |
| Comment Bait | /10 | |
| Practical Value | /10 | |
| Production Quality | /10 | |
| TOTAL | /70 |
Score Interpretation:
- 60-70: Viral potential
- 45-59: Strong performer
- 30-44: Average
- <30: Needs work
---
Quick Implementation Guide
To Clone a Viral Formula
1. Extract the skeleton - Get the structural framework 2. Keep the timing - Match percentage breakdowns 3. Steal the hooks - Adapt exact patterns 4. Match the energy - Follow pacing rhythm 5. Use the loops - Apply same retention techniques 6. Mirror the arc - Follow emotional journey
Common Mistakes to Avoid
- Copying words instead of patterns
- Ignoring pacing/timing
- Skipping the hook stack
- Weak open loops
- No payoff points
- Generic CTAs
#!/usr/bin/env python3
"""
YouTube Transcript Fetcher
Extracts transcripts from YouTube videos using the youtube-transcript-api library.
No API key required.
Usage:
python fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
python fetch_transcript.py "VIDEO_ID"
python fetch_transcript.py "https://youtu.be/VIDEO_ID"
Install dependency:
pip install youtube-transcript-api
"""
import argparse
import re
import sys
try:
from youtube_transcript_api import YouTubeTranscriptApi
from youtube_transcript_api._errors import (
NoTranscriptFound,
TranscriptsDisabled,
VideoUnavailable,
)
except ImportError:
print("Error: youtube-transcript-api not installed.")
print("Install with: pip install youtube-transcript-api")
sys.exit(1)
def extract_video_id(url_or_id: str) -> str:
"""Extract video ID from various YouTube URL formats or return as-is if already an ID."""
# Already a video ID (11 characters, alphanumeric with - and _)
if re.match(r"^[a-zA-Z0-9_-]{11}$", url_or_id):
return url_or_id
# Standard YouTube URL: youtube.com/watch?v=VIDEO_ID
match = re.search(r"[?&]v=([a-zA-Z0-9_-]{11})", url_or_id)
if match:
return match.group(1)
# Short YouTube URL: youtu.be/VIDEO_ID
match = re.search(r"youtu\.be/([a-zA-Z0-9_-]{11})", url_or_id)
if match:
return match.group(1)
# YouTube Shorts: youtube.com/shorts/VIDEO_ID
match = re.search(r"shorts/([a-zA-Z0-9_-]{11})", url_or_id)
if match:
return match.group(1)
# Embedded URL: youtube.com/embed/VIDEO_ID
match = re.search(r"embed/([a-zA-Z0-9_-]{11})", url_or_id)
if match:
return match.group(1)
# If nothing matched, return as-is and let the API handle the error
return url_or_id
def format_timestamp(seconds: float) -> str:
"""Convert seconds to MM:SS or HH:MM:SS format."""
hours = int(seconds // 3600)
minutes = int((seconds % 3600) // 60)
secs = int(seconds % 60)
if hours > 0:
return f"{hours:02d}:{minutes:02d}:{secs:02d}"
return f"{minutes:02d}:{secs:02d}"
def fetch_transcript(video_id: str, include_timestamps: bool = False, language: str = "en") -> str:
"""
Fetch transcript for a YouTube video.
Args:
video_id: YouTube video ID
include_timestamps: Whether to include timestamps in output
language: Preferred language code (default: "en")
Returns:
Formatted transcript text
"""
try:
# Try to get transcript in preferred language first
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
try:
# Try manual transcript first (usually higher quality)
transcript = transcript_list.find_manually_created_transcript([language])
except NoTranscriptFound:
try:
# Fall back to auto-generated
transcript = transcript_list.find_generated_transcript([language])
except NoTranscriptFound:
# Fall back to any available transcript
transcript = transcript_list.find_transcript([language])
# Fetch the actual transcript data
transcript_data = transcript.fetch()
# Format output
lines = []
for entry in transcript_data:
text = entry["text"].strip()
if not text:
continue
if include_timestamps:
timestamp = format_timestamp(entry["start"])
lines.append(f"[{timestamp}] {text}")
else:
lines.append(text)
return "\n".join(lines)
except TranscriptsDisabled:
return "Error: Transcripts are disabled for this video."
except VideoUnavailable:
return "Error: Video is unavailable (private, deleted, or invalid ID)."
except NoTranscriptFound:
return f"Error: No transcript found for this video in language '{language}'."
except Exception as e:
return f"Error: {str(e)}"
def main():
parser = argparse.ArgumentParser(
description="Fetch YouTube video transcripts for analysis.",
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog="""
Examples:
python fetch_transcript.py "https://youtube.com/watch?v=dQw4w9WgXcQ"
python fetch_transcript.py "dQw4w9WgXcQ" --timestamps
python fetch_transcript.py "https://youtu.be/dQw4w9WgXcQ" --lang es
"""
)
parser.add_argument(
"video",
help="YouTube video URL or video ID"
)
parser.add_argument(
"--timestamps", "-t",
action="store_true",
help="Include timestamps in output"
)
parser.add_argument(
"--lang", "-l",
default="en",
help="Preferred transcript language (default: en)"
)
parser.add_argument(
"--output", "-o",
help="Output file path (default: print to stdout)"
)
args = parser.parse_args()
# Extract video ID
video_id = extract_video_id(args.video)
# Fetch transcript
transcript = fetch_transcript(
video_id,
include_timestamps=args.timestamps,
language=args.lang
)
# Output
if args.output:
with open(args.output, "w", encoding="utf-8") as f:
f.write(transcript)
print(f"Transcript saved to: {args.output}")
else:
print(transcript)
if __name__ == "__main__":
main()
Related skills
How it compares
Pick youtube-video-analyst when you need frame-by-frame hook and retention forensics on a specific video rather than channel-wide analytics dashboards.
FAQ
What does youtube-video-analyst do?
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.
When should I use youtube-video-analyst?
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.
What are common prerequisites?
--- name: youtube-video-analyst description: Forensic-level deconstruction of YouTube videos to extract viral formulas, hooks, retention mechanics, and emotional engineering.
Is Youtube Video Analyst safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.