ericgandrade/claude-superskills/youtube-summarizer

# Test 1: Can we run local Python?
python3 --version 2>/dev/null
PYTHON_AVAILABLE=$?
 
# Test 2: Is youtube-transcript-api installed?
python3 -c "import youtube_transcript_api" 2>/dev/null
LIB_AVAILABLE=$?

youtube-transcript-api is required but not installed.
 
Would you like to install it now?
- [ ] Yes - Install with pip (pip install youtube-transcript-api)
- [ ] No - I'll install it manually

pip install youtube-transcript-api

⚠️  YouTube is not accessible in this environment.
 
Options:
1. Run this skill in Claude Code (CLI) — it has full network access and can install Python libraries.
2. Paste the video transcript text directly into this chat — the skill will summarize whatever text you provide.
3. Copy the transcript from youtube.com/watch?v=VIDEO_ID → click "..." → "Show transcript" → paste here.

echo "[████░░░░░░░░░░░░░░░░] 20% - Step 1/5: Validating URL"

╔══════════════════════════════════════════════════════════════╗
║     📹  YOUTUBE SUMMARIZER - Processing Video                ║
╠══════════════════════════════════════════════════════════════╣
║ → Step 1: Validating URL                 [IN PROGRESS]       ║
║ ○ Step 2: Checking Availability                              ║
║ ○ Step 3: Extracting Transcript                              ║
║ ○ Step 4: Generating Summary                                 ║
║ ○ Step 5: Formatting Output                                  ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%               ║
╚══════════════════════════════════════════════════════════════╝

# Extract video ID using regex or URL parsing
URL="$USER_PROVIDED_URL"
 
# Pattern 1: youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Pattern 2: youtu.be/VIDEO_ID  
elif echo "$URL" | grep -qE 'youtu\.be/'; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
    echo "❌ Invalid YouTube URL format"
    exit 1
fi
 
echo "📹 Video ID extracted: $VIDEO_ID"

❌ Invalid YouTube URL
 
Please provide a valid YouTube URL in one of these formats:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
 
Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ

echo "[████████░░░░░░░░░░░░] 40% - Step 2/5: Checking Availability"

from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    print(f"✅ Video accessible: {video_id}")
    for transcript in transcript_list:
        lang_type = "[Auto-generated]" if transcript.is_generated else "[Manual]"
        print(f"  - {transcript.language} ({transcript.language_code}) {lang_type}")
except TranscriptsDisabled:
    print(f"❌ Transcripts are disabled for video {video_id}")
    sys.exit(1)
except NoTranscriptFound:
    print(f"❌ No transcript found for video {video_id}")
    sys.exit(1)
except Exception as e:
    print(f"❌ Error accessing video: {e}")
    sys.exit(1)

echo "[████████████░░░░░░░░] 60% - Step 3/5: Extracting Transcript"

from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id,
        languages=['pt', 'en']  # Prefer Portuguese, fallback to English
    )
    full_text = " ".join([entry['text'] for entry in transcript])
    print("✅ Transcript extracted successfully")
    print(f"📊 Transcript length: {len(full_text)} characters")
    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
        f.write(full_text)
except Exception as e:
    print(f"❌ Error extracting transcript: {e}")
    exit(1)

⚠️  YouTube is not accessible in this environment (proxy/sandbox restriction).
 
To proceed, paste the video transcript text directly into this chat.
To get it: go to youtube.com/watch?v=VIDEO_ID → click "..." below the video → "Show transcript" → copy all text.
 
Alternatively, run this skill in Claude Code (CLI) for automatic extraction.

echo "[████████████████░░░░] 80% - Step 4/5: Generating Summary"

# Use the transcript file as input to the AI prompt
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
 
# The AI agent will:
# 1. Read the transcript
# 2. Apply the STAR + R-I-S-E summarization framework
# 3. Generate comprehensive Markdown output
# 4. Structure with headers, lists, and highlights
 
Read "$TRANSCRIPT_FILE"  # Read transcript into context

echo "[████████████████████] 100% - Step 5/5: Formatting Output"

# [Video Title]
 
**Channel:** [Channel Name]  
**Duration:** [Duration]  
**URL:** [https://youtube.com/watch?v=VIDEO_ID]  
**Published:** [Date if available]
 
 
## 📝 Detailed Summary
 
### [Topic 1]
 
[Comprehensive explanation with examples, data, quotes...]
 
#### [Subtopic 1.1]
 
[Detailed breakdown...]
 
### [Topic 2]
 
[Continued detailed analysis...]
 
 
## 📚 Concepts and Terminology
 
-**[Term 1]:** [Definition and context]
-**[Term 2]:** [Definition and context]
 
 
## 📌 Conclusion
 
[Final synthesis and takeaways]
 
 
*(Output follows same structure as Example 1.)*
 
## 📊 Executive Summary
 
This 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.
 
[... continued detailed summary ...]

What would you like to save?
→ Summary + raw transcript