Youtube Summarizer

1---2name: youtube-summarizer3description: "Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks"4category: content5risk: safe6source: community7tags: "[video, summarization, transcription, youtube, content-analysis]"8date_added: "2026-02-27"9---10 11# youtube-summarizer12 13## Purpose14 15This skill extracts transcripts from YouTube videos and generates comprehensive, verbose summaries using the STAR + R-I-S-E framework. It validates video availability, extracts transcripts using the `youtube-transcript-api` Python library, and produces detailed documentation capturing all insights, arguments, and key points.16 17The skill is designed for users who need thorough content analysis and reference documentation from educational videos, lectures, tutorials, or informational content.18 19## When to Use This Skill20 21This skill should be used when:22 23- User provides a YouTube video URL and wants a detailed summary24- User needs to document video content for reference without rewatching25- User wants to extract insights, key points, and arguments from educational content26- User needs transcripts from YouTube videos for analysis27- User asks to "summarize", "resume", or "extract content" from YouTube videos28- User wants comprehensive documentation prioritizing completeness over brevity29 30## Step 0: Discovery & Setup31 32Before processing videos, validate the environment and dependencies:33 34```bash35# Check if youtube-transcript-api is installed36python3 -c "import youtube_transcript_api" 2>/dev/null37if [ $? -ne 0 ]; then38    echo "⚠️  youtube-transcript-api not found"39    # Offer to install40fi41 42# Check Python availability43if ! command -v python3 &>/dev/null; then44    echo "❌ Python 3 is required but not installed"45    exit 146fi47```48 49**Ask the user if dependency is missing:**50 51```52youtube-transcript-api is required but not installed.53 54Would you like to install it now?55- [ ] Yes - Install with pip (pip install youtube-transcript-api)56- [ ] No - I'll install it manually57```58 59**If user selects "Yes":**60 61```bash62pip install youtube-transcript-api63```64 65**Verify installation:**66 67```bash68python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api installed successfully')"69```70 71## Main Workflow72 73### Progress Tracking Guidelines74 75Throughout the workflow, display a visual progress gauge before each step to keep the user informed. The gauge format is:76 77```bash78echo "[████░░░░░░░░░░░░░░░░] 20% - Step 1/5: Validating URL"79```80 81**Format specifications:**82- 20 characters wide (use █ for filled, ░ for empty)83- Percentage increments: Step 1=20%, Step 2=40%, Step 3=60%, Step 4=80%, Step 5=100%84- Step counter showing current/total (e.g., "Step 3/5")85- Brief description of current phase86 87**Display the initial status box before Step 1:**88 89```90╔══════════════════════════════════════════════════════════════╗91║     📹  YOUTUBE SUMMARIZER - Processing Video                ║92╠══════════════════════════════════════════════════════════════╣93║ → Step 1: Validating URL                 [IN PROGRESS]       ║94║ ○ Step 2: Checking Availability                              ║95║ ○ Step 3: Extracting Transcript                              ║96║ ○ Step 4: Generating Summary                                 ║97║ ○ Step 5: Formatting Output                                  ║98╠══════════════════════════════════════════════════════════════╣99║ Progress: ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%               ║100╚══════════════════════════════════════════════════════════════╝101```102 103### Step 1: Validate YouTube URL104 105**Objective:** Extract video ID and validate URL format.106 107**Supported URL Formats:**108- `https://www.youtube.com/watch?v=VIDEO_ID`109- `https://youtube.com/watch?v=VIDEO_ID`110- `https://youtu.be/VIDEO_ID`111- `https://m.youtube.com/watch?v=VIDEO_ID`112 113**Actions:**114 115```bash116# Extract video ID using regex or URL parsing117URL="$USER_PROVIDED_URL"118 119# Pattern 1: youtube.com/watch?v=VIDEO_ID120if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then121    VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')122# Pattern 2: youtu.be/VIDEO_ID  123elif echo "$URL" | grep -qE 'youtu\.be/'; then124    VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')125else126    echo "❌ Invalid YouTube URL format"127    exit 1128fi129 130echo "📹 Video ID extracted: $VIDEO_ID"131```132 133**If URL is invalid:**134 135```136❌ Invalid YouTube URL137 138Please provide a valid YouTube URL in one of these formats:139- https://www.youtube.com/watch?v=VIDEO_ID140- https://youtu.be/VIDEO_ID141 142Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ143```144 145### Step 2: Check Video & Transcript Availability146 147**Progress:**148```bash149echo "[████████░░░░░░░░░░░░] 40% - Step 2/5: Checking Availability"150```151 152**Objective:** Verify video exists and transcript is accessible.153 154**Actions:**155 156```python157from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound158import sys159 160video_id = sys.argv[1]161 162try:163    # Get list of available transcripts164    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)165    166    print(f"✅ Video accessible: {video_id}")167    print("📝 Available transcripts:")168    169    for transcript in transcript_list:170        print(f"  - {transcript.language} ({transcript.language_code})")171        if transcript.is_generated:172            print("    [Auto-generated]")173    174except TranscriptsDisabled:175    print(f"❌ Transcripts are disabled for video {video_id}")176    sys.exit(1)177    178except NoTranscriptFound:179    print(f"❌ No transcript found for video {video_id}")180    sys.exit(1)181    182except Exception as e:183    print(f"❌ Error accessing video: {e}")184    sys.exit(1)185```186 187**Error Handling:**188 189| Error | Message | Action |190|-------|---------|--------|191| Video not found | "❌ Video does not exist or is private" | Ask user to verify URL |192| Transcripts disabled | "❌ Transcripts are disabled for this video" | Cannot proceed |193| No transcript available | "❌ No transcript found (not auto-generated or manually added)" | Cannot proceed |194| Private/restricted video | "❌ Video is private or restricted" | Ask for public video |195 196### Step 3: Extract Transcript197 198**Progress:**199```bash200echo "[████████████░░░░░░░░] 60% - Step 3/5: Extracting Transcript"201```202 203**Objective:** Retrieve transcript in preferred language.204 205**Actions:**206 207```python208from youtube_transcript_api import YouTubeTranscriptApi209 210video_id = "VIDEO_ID"211 212try:213    # Try to get transcript in user's preferred language first214    # Fall back to English if not available215    transcript = YouTubeTranscriptApi.get_transcript(216        video_id, 217        languages=['pt', 'en']  # Prefer Portuguese, fallback to English218    )219    220    # Combine transcript segments into full text221    full_text = " ".join([entry['text'] for entry in transcript])222    223    # Get video metadata224    from youtube_transcript_api import YouTubeTranscriptApi225    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)226    227    print("✅ Transcript extracted successfully")228    print(f"📊 Transcript length: {len(full_text)} characters")229    230    # Save to temporary file for processing231    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:232        f.write(full_text)233    234except Exception as e:235    print(f"❌ Error extracting transcript: {e}")236    exit(1)237```238 239**Transcript Processing:**240 241- Combine all transcript segments into coherent text242- Preserve punctuation and formatting where available243- Remove duplicate or overlapping segments (if auto-generated artifacts)244- Store in temporary file for analysis245 246### Step 4: Generate Comprehensive Summary247 248**Progress:**249```bash250echo "[████████████████░░░░] 80% - Step 4/5: Generating Summary"251```252 253**Objective:** Apply enhanced STAR + R-I-S-E prompt to create detailed summary.254 255**Prompt Applied:**256 257Use the enhanced prompt from Phase 2 (STAR + R-I-S-E framework) with the extracted transcript as input.258 259**Actions:**260 2611. Load the full transcript text2622. Apply the comprehensive summarization prompt2633. Use AI model (Claude/GPT) to generate structured summary2644. Ensure output follows the defined structure:265   - Header with video metadata266   - Executive synthesis267   - Detailed section-by-section breakdown268   - Key insights and conclusions269   - Concepts and terminology270   - Resources and references271 272**Implementation:**273 274```bash275# Use the transcript file as input to the AI prompt276TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"277 278# The AI agent will:279# 1. Read the transcript280# 2. Apply the STAR + R-I-S-E summarization framework281# 3. Generate comprehensive Markdown output282# 4. Structure with headers, lists, and highlights283 284Read "$TRANSCRIPT_FILE"  # Read transcript into context285```286 287Then apply the full summarization prompt (from enhanced version in Phase 2).288 289### Step 5: Format and Present Output290 291**Progress:**292```bash293echo "[████████████████████] 100% - Step 5/5: Formatting Output"294```295 296**Objective:** Deliver the summary in clean, well-structured Markdown.297 298**Output Structure:**299 300```markdown301# [Video Title]302 303**Canal:** [Channel Name]  304**Duração:** [Duration]  305**URL:** [https://youtube.com/watch?v=VIDEO_ID]  306**Data de Publicação:** [Date if available]307 308 309## 📝 Detailed Summary310 311### [Topic 1]312 313[Comprehensive explanation with examples, data, quotes...]314 315#### [Subtopic 1.1]316 317[Detailed breakdown...]318 319### [Topic 2]320 321[Continued detailed analysis...]322 323 324## 📚 Concepts and Terminology325 326- **[Term 1]:** [Definition and context]327- **[Term 2]:** [Definition and context]328 329 330## 📌 Conclusion331 332[Final synthesis and takeaways]333 334 335### **Example 2: Missing Dependency**336 337**User Input:**338```339claude> summarize this youtube video https://youtu.be/abc123340```341 342**Skill Response:**343 344```345⚠️  youtube-transcript-api not installed346 347This skill requires the Python library 'youtube-transcript-api'.348 349Would you like me to install it now?350- [ ] Yes - Install with pip351- [ ] No - I'll install manually352```353 354**User selects "Yes":**355 356```bash357$ pip install youtube-transcript-api358Successfully installed youtube-transcript-api-0.6.1359 360✅ Installation complete! Proceeding with video summary...361```362 363 364### **Example 4: Invalid URL**365 366**User Input:**367```368claude> summarize youtube video www.youtube.com/some-video369```370 371**Skill Response:**372 373```374❌ Invalid YouTube URL format375 376Expected format examples:377- https://www.youtube.com/watch?v=VIDEO_ID378- https://youtu.be/VIDEO_ID379 380Please provide a valid YouTube video URL.381```382 383 384## 📊 Executive Summary385 386This video provides a comprehensive introduction to the fundamental concepts of Artificial Intelligence (AI), designed for beginners and professionals who want to understand the technical foundations and practical applications of modern AI. The instructor covers everything from basic definitions to machine learning algorithms, using practical examples and visualizations to facilitate understanding.387 388[... continued detailed summary ...]389```390 391**Save Options:**392 393```394What would you like to save?395→ Summary + raw transcript396 397✅ File saved: resumo-exemplo123-2026-02-01.md (includes raw transcript)398[████████████████████] 100% - ✓ Processing complete!399```400 401 402Welcome to this comprehensive tutorial on machine learning fundamentals. In today's video, we'll explore the core concepts that power modern AI systems...403```404 405 406**Version:** 1.2.0407**Last Updated:** 2026-02-02408**Maintained By:** Eric Andrade409 410## Limitations411- Use this skill only when the task clearly matches the scope described above.412- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.413- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.