[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71AZE3MPF891RM354EMRYA1":3,"skill-same:01M71AZE3MPF891RM354EMRYA1":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":52,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M71AZE3MPF891RM354EMRYA1","youtube",null,"Download YouTube video transcripts when user provides a YouTube URL or asks to download\u002Fget\u002Ffetch a transcript from YouTube. Also use when user wants to transcribe or get captions\u002Fsubtitles from a YouTube video.","ariadoss\u002Fsuperskills","ariadoss","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F414341?v=4","01M71AC7383PT6JCRZSQJ4AVTM","Danilo Stern-Sapad","01M71AC73Y7NTBTJ9KQYNENRRE",12,"MIT","https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",[5,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"transcript","download","user","transcripts","subtitles","use","transcribe","write","read","video transcripts","Bash","URL","when","Captions","get","fetch","Video","2026-11-10 10:12:30",false,"---\nname: youtube\ndescription: Download YouTube video transcripts when user provides a YouTube URL or asks to download\u002Fget\u002Ffetch a transcript from YouTube. Also use when user wants to transcribe or get captions\u002Fsubtitles from a YouTube video.\nallowed-tools: Bash,Read,Write\n---\n\n# YouTube Transcript Downloader\n\nThis skill helps download transcripts (subtitles\u002Fcaptions) from YouTube videos using yt-dlp.\n\n## When to Use This Skill\n\nActivate this skill when the user:\n- Provides a YouTube URL and wants the transcript\n- Asks to \"download transcript from YouTube\"\n- Wants to \"get captions\" or \"get subtitles\" from a video\n- Asks to \"transcribe a YouTube video\"\n- Needs text content from a YouTube video\n\n## How It Works\n\n### Priority Order:\n1. **Check if yt-dlp is installed** - install if needed\n2. **List available subtitles** - see what's actually available\n3. **Try manual subtitles first** (`--write-sub`) - highest quality\n4. **Fallback to auto-generated** (`--write-auto-sub`) - usually available\n5. **Last resort: Whisper transcription** - if no subtitles exist (requires user confirmation)\n6. **Confirm the download** and show the user where the file is saved\n7. **Optionally clean up** the VTT format if the user wants plain text\n\n## Installation Check\n\n**IMPORTANT**: Always check if yt-dlp is installed first:\n\n```bash\nwhich yt-dlp || command -v yt-dlp\n```\n\n### If Not Installed\n\nAttempt automatic installation based on the system:\n\n**macOS (Homebrew)**:\n```bash\nbrew install yt-dlp\n```\n\n**Linux (apt\u002FDebian\u002FUbuntu)**:\n```bash\nsudo apt update && sudo apt install -y yt-dlp\n```\n\n**Alternative (pip - works on all systems)**:\n```bash\npip3 install yt-dlp\n# or\npython3 -m pip install yt-dlp\n```\n\n**If installation fails**: Inform the user they need to install yt-dlp manually and provide them with installation instructions from https:\u002F\u002Fgithub.com\u002Fyt-dlp\u002Fyt-dlp#installation\n\n## Check Available Subtitles\n\n**ALWAYS do this first** before attempting to download:\n\n```bash\nyt-dlp --list-subs \"YOUTUBE_URL\"\n```\n\nThis shows what subtitle types are available without downloading anything. Look for:\n- Manual subtitles (better quality)\n- Auto-generated subtitles (usually available)\n- Available languages\n\n## Download Strategy\n\n### Option 1: Manual Subtitles (Preferred)\n\nTry this first - highest quality, human-created:\n\n```bash\nyt-dlp --write-sub --skip-download --output \"OUTPUT_NAME\" \"YOUTUBE_URL\"\n```\n\n### Option 2: Auto-Generated Subtitles (Fallback)\n\nIf manual subtitles aren't available:\n\n```bash\nyt-dlp --write-auto-sub --skip-download --output \"OUTPUT_NAME\" \"YOUTUBE_URL\"\n```\n\nBoth commands create a `.vtt` file (WebVTT subtitle format).\n\n## Option 3: Whisper Transcription (Last Resort)\n\n**ONLY use this if both manual and auto-generated subtitles are unavailable.**\n\n### Step 1: Show File Size and Ask for Confirmation\n\n```bash\n# Get audio file size estimate\nyt-dlp --print \"%(filesize,filesize_approx)s\" -f \"bestaudio\" \"YOUTUBE_URL\"\n\n# Or get duration to estimate\nyt-dlp --print \"%(duration)s %(title)s\" \"YOUTUBE_URL\"\n```\n\n**IMPORTANT**: Display the file size to the user and ask: \"No subtitles are available. I can download the audio (approximately X MB) and transcribe it using Whisper. Would you like to proceed?\"\n\n**Wait for user confirmation before continuing.**\n\n### Step 2: Check for Whisper Installation\n\n```bash\ncommand -v whisper\n```\n\nIf not installed, ask user: \"Whisper is not installed. Install it with `pip install openai-whisper` (requires ~1-3GB for models)? This is a one-time installation.\"\n\n**Wait for user confirmation before installing.**\n\nInstall if approved:\n```bash\npip3 install openai-whisper\n```\n\n### Step 3: Download Audio Only\n\n```bash\nyt-dlp -x --audio-format mp3 --output \"audio_%(id)s.%(ext)s\" \"YOUTUBE_URL\"\n```\n\n### Step 4: Transcribe with Whisper\n\n```bash\n# Auto-detect language (recommended)\nwhisper audio_VIDEO_ID.mp3 --model base --output_format vtt\n\n# Or specify language if known\nwhisper audio_VIDEO_ID.mp3 --model base --language en --output_format vtt\n```\n\n**Model Options** (stick to `base` for now):\n- `tiny` - fastest, least accurate (~1GB)\n- `base` - good balance (~1GB) ← **USE THIS**\n- `small` - better accuracy (~2GB)\n- `medium` - very good (~5GB)\n- `large` - best accuracy (~10GB)\n\n### Step 5: Cleanup\n\nAfter transcription completes, ask user: \"Transcription complete! Would you like me to delete the audio file to save space?\"\n\nIf yes:\n```bash\nrm audio_VIDEO_ID.mp3\n```\n\n## Getting Video Information\n\n### Extract Video Title (for filename)\n\n```bash\nyt-dlp --print \"%(title)s\" \"YOUTUBE_URL\"\n```\n\nUse this to create meaningful filenames based on the video title. Clean the title for filesystem compatibility:\n- Replace `\u002F` with `-`\n- Replace special characters that might cause issues\n- Consider using sanitized version: `$(yt-dlp --print \"%(title)s\" \"URL\" | tr '\u002F' '-' | tr ':' '-')`\n\n## Post-Processing\n\n### Convert to Plain Text (Recommended)\n\nYouTube's auto-generated VTT files contain **duplicate lines** because captions are shown progressively with overlapping timestamps. Always deduplicate when converting to plain text while preserving the original speaking order.\n\n```bash\npython3 -c \"\nimport sys, re\nseen = set()\nwith open('transcript.en.vtt', 'r') as f:\n    for line in f:\n        line = line.strip()\n        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:\n            clean = re.sub('\u003C[^>]*>', '', line)\n            clean = clean.replace('&', '&').replace('>', '>').replace('<', '\u003C')\n            if clean and clean not in seen:\n                print(clean)\n                seen.add(clean)\n\" > transcript.txt\n```\n\n### Complete Post-Processing with Video Title\n\n```bash\n# Get video title\nVIDEO_TITLE=$(yt-dlp --print \"%(title)s\" \"YOUTUBE_URL\" | tr '\u002F' '_' | tr ':' '-' | tr '?' '' | tr '\"' '')\n\n# Find the VTT file\nVTT_FILE=$(ls *.vtt | head -n 1)\n\n# Convert with deduplication\npython3 -c \"\nimport sys, re\nseen = set()\nwith open('$VTT_FILE', 'r') as f:\n    for line in f:\n        line = line.strip()\n        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:\n            clean = re.sub('\u003C[^>]*>', '', line)\n            clean = clean.replace('&', '&').replace('>', '>').replace('<', '\u003C')\n            if clean and clean not in seen:\n                print(clean)\n                seen.add(clean)\n\" > \"${VIDEO_TITLE}.txt\"\n\necho \"✓ Saved to: ${VIDEO_TITLE}.txt\"\n\n# Clean up VTT file\nrm \"$VTT_FILE\"\necho \"✓ Cleaned up temporary VTT file\"\n```\n\n## Output Formats\n\n- **VTT format** (`.vtt`): Includes timestamps and formatting, good for video players\n- **Plain text** (`.txt`): Just the text content, good for reading or analysis\n\n## Tips\n\n- The filename will be `{output_name}.{language_code}.vtt` (e.g., `transcript.en.vtt`)\n- Most YouTube videos have auto-generated English subtitles\n- Some videos may have multiple language options\n- If auto-subtitles aren't available, try `--write-sub` instead for manual subtitles\n\n## Complete Workflow Example\n\n```bash\nVIDEO_URL=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=dQw4w9WgXcQ\"\n\n# Get video title for filename\nVIDEO_TITLE=$(yt-dlp --print \"%(title)s\" \"$VIDEO_URL\" | tr '\u002F' '_' | tr ':' '-' | tr '?' '' | tr '\"' '')\nOUTPUT_NAME=\"transcript_temp\"\n\n# ============================================\n# STEP 1: Check if yt-dlp is installed\n# ============================================\nif ! command -v yt-dlp &> \u002Fdev\u002Fnull; then\n    echo \"yt-dlp not found, attempting to install...\"\n    if command -v brew &> \u002Fdev\u002Fnull; then\n        brew install yt-dlp\n    elif command -v apt &> \u002Fdev\u002Fnull; then\n        sudo apt update && sudo apt install -y yt-dlp\n    else\n        pip3 install yt-dlp\n    fi\nfi\n\n# ============================================\n# STEP 2: List available subtitles\n# ============================================\necho \"Checking available subtitles...\"\nyt-dlp --list-subs \"$VIDEO_URL\"\n\n# ============================================\n# STEP 3: Try manual subtitles first\n# ============================================\necho \"Attempting to download manual subtitles...\"\nif yt-dlp --write-sub --skip-download --output \"$OUTPUT_NAME\" \"$VIDEO_URL\" 2>\u002Fdev\u002Fnull; then\n    echo \"✓ Manual subtitles downloaded successfully!\"\n    ls -lh ${OUTPUT_NAME}.*\nelse\n    # ============================================\n    # STEP 4: Fallback to auto-generated\n    # ============================================\n    echo \"Manual subtitles not available. Trying auto-generated...\"\n    if yt-dlp --write-auto-sub --skip-download --output \"$OUTPUT_NAME\" \"$VIDEO_URL\" 2>\u002Fdev\u002Fnull; then\n        echo \"✓ Auto-generated subtitles downloaded successfully!\"\n        ls -lh ${OUTPUT_NAME}.*\n    else\n        # ============================================\n        # STEP 5: Last resort - Whisper transcription\n        # ============================================\n        echo \"⚠ No subtitles available for this video.\"\n\n        # Get file size\n        FILE_SIZE=$(yt-dlp --print \"%(filesize_approx)s\" -f \"bestaudio\" \"$VIDEO_URL\")\n        DURATION=$(yt-dlp --print \"%(duration)s\" \"$VIDEO_URL\")\n        TITLE=$(yt-dlp --print \"%(title)s\" \"$VIDEO_URL\")\n\n        echo \"Video: $TITLE\"\n        echo \"Duration: $((DURATION \u002F 60)) minutes\"\n        echo \"Audio size: ~$((FILE_SIZE \u002F 1024 \u002F 1024)) MB\"\n        echo \"\"\n        echo \"Would you like to download and transcribe with Whisper? (y\u002Fn)\"\n        read -r RESPONSE\n\n        if [[ \"$RESPONSE\" =~ ^[Yy]$ ]]; then\n            # Check for Whisper\n            if ! command -v whisper &> \u002Fdev\u002Fnull; then\n                echo \"Whisper not installed. Install now? (requires ~1-3GB) (y\u002Fn)\"\n                read -r INSTALL_RESPONSE\n                if [[ \"$INSTALL_RESPONSE\" =~ ^[Yy]$ ]]; then\n                    pip3 install openai-whisper\n                else\n                    echo \"Cannot proceed without Whisper. Exiting.\"\n                    exit 1\n                fi\n            fi\n\n            # Download audio\n            echo \"Downloading audio...\"\n            yt-dlp -x --audio-format mp3 --output \"audio_%(id)s.%(ext)s\" \"$VIDEO_URL\"\n\n            # Get the actual audio filename\n            AUDIO_FILE=$(ls audio_*.mp3 | head -n 1)\n\n            # Transcribe\n            echo \"Transcribing with Whisper (this may take a few minutes)...\"\n            whisper \"$AUDIO_FILE\" --model base --output_format vtt\n\n            # Cleanup\n            echo \"Transcription complete! Delete audio file? (y\u002Fn)\"\n            read -r CLEANUP_RESPONSE\n            if [[ \"$CLEANUP_RESPONSE\" =~ ^[Yy]$ ]]; then\n                rm \"$AUDIO_FILE\"\n                echo \"Audio file deleted.\"\n            fi\n\n            ls -lh *.vtt\n        else\n            echo \"Transcription cancelled.\"\n            exit 0\n        fi\n    fi\nfi\n\n# ============================================\n# STEP 6: Convert to readable plain text with deduplication\n# ============================================\nVTT_FILE=$(ls ${OUTPUT_NAME}*.vtt 2>\u002Fdev\u002Fnull || ls *.vtt | head -n 1)\nif [ -f \"$VTT_FILE\" ]; then\n    echo \"Converting to readable format and removing duplicates...\"\n    python3 -c \"\nimport sys, re\nseen = set()\nwith open('$VTT_FILE', 'r') as f:\n    for line in f:\n        line = line.strip()\n        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:\n            clean = re.sub('\u003C[^>]*>', '', line)\n            clean = clean.replace('&', '&').replace('>', '>').replace('<', '\u003C')\n            if clean and clean not in seen:\n                print(clean)\n                seen.add(clean)\n\" > \"${VIDEO_TITLE}.txt\"\n    echo \"✓ Saved to: ${VIDEO_TITLE}.txt\"\n\n    # Clean up temporary VTT file\n    rm \"$VTT_FILE\"\n    echo \"✓ Cleaned up temporary VTT file\"\nelse\n    echo \"⚠ No VTT file found to convert\"\nfi\n\necho \"✓ Complete!\"\n```\n\n**Note**: This complete workflow handles all scenarios with proper error checking and user prompts at each decision point.\n\n## Error Handling\n\n### Common Issues and Solutions:\n\n**1. yt-dlp not installed**\n- Attempt automatic installation based on system (Homebrew\u002Fapt\u002Fpip)\n- If installation fails, provide manual installation link\n- Verify installation before proceeding\n\n**2. No subtitles available**\n- List available subtitles first to confirm\n- Try both `--write-sub` and `--write-auto-sub`\n- If both fail, offer Whisper transcription option\n- Show file size and ask for user confirmation before downloading audio\n\n**3. Invalid or private video**\n- Check if URL is correct format: `https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_ID`\n- Some videos may be private, age-restricted, or geo-blocked\n- Inform user of the specific error from yt-dlp\n\n**4. Whisper installation fails**\n- May require system dependencies (ffmpeg, rust)\n- Provide fallback: \"Install manually with: `pip3 install openai-whisper`\"\n- Check available disk space (models require 1-10GB depending on size)\n\n**5. Download interrupted or failed**\n- Check internet connection\n- Verify sufficient disk space\n- Try again with `--no-check-certificate` if SSL issues occur\n\n**6. Multiple subtitle languages**\n- By default, yt-dlp downloads all available languages\n- Can specify with `--sub-langs en` for English only\n- List available with `--list-subs` first\n\n### Best Practices:\n\n- ✅ Always check what's available before attempting download (`--list-subs`)\n- ✅ Verify success at each step before proceeding to next\n- ✅ Ask user before large downloads (audio files, Whisper models)\n- ✅ Clean up temporary files after processing\n- ✅ Provide clear feedback about what's happening at each stage\n- ✅ Handle errors gracefully with helpful messages\n","# YouTube Transcript Downloader\n\nThis skill helps download transcripts (subtitles\u002Fcaptions) from YouTube videos using yt-dlp.\n\n## When to Use This Skill\n\nActivate this skill when the user:\n- Provides a YouTube URL and wants the transcript\n- Asks to \"download transcript from YouTube\"\n- Wants to \"get captions\" or \"get subtitles\" from a video\n- Asks to \"transcribe a YouTube video\"\n- Needs text content from a YouTube video\n\n## How It Works\n\n### Priority Order:\n1. **Check if yt-dlp is installed** - install if needed\n2. **List available subtitles** - see what's actually available\n3. **Try manual subtitles first** (`--write-sub`) - highest quality\n4. **Fallback to auto-generated** (`--write-auto-sub`) - usually available\n5. **Last resort: Whisper transcription** - if no subtitles exist (requires user confirmation)\n6. **Confirm the download** and show the user where the file is saved\n7. **Optionally clean up** the VTT format if the user wants plain text\n\n## Installation Check\n\n**IMPORTANT**: Always check if yt-dlp is installed first:\n\n```bash\nwhich yt-dlp || command -v yt-dlp\n```\n\n### If Not Installed\n\nAttempt automatic installation based on the system:\n\n**macOS (Homebrew)**:\n```bash\nbrew install yt-dlp\n```\n\n**Linux (apt\u002FDebian\u002FUbuntu)**:\n```bash\nsudo apt update && sudo apt install -y yt-dlp\n```\n\n**Alternative (pip - works on all systems)**:\n```bash\npip3 install yt-dlp\n# or\npython3 -m pip install yt-dlp\n```\n\n**If installation fails**: Inform the user they need to install yt-dlp manually and provide them with installation instructions from https:\u002F\u002Fgithub.com\u002Fyt-dlp\u002Fyt-dlp#installation\n\n## Check Available Subtitles\n\n**ALWAYS do this first** before attempting to download:\n\n```bash\nyt-dlp --list-subs \"YOUTUBE_URL\"\n```\n\nThis shows what subtitle types are available without downloading anything. Look for:\n- Manual subtitles (better quality)\n- Auto-generated subtitles (usually available)\n- Available languages\n\n## Download Strategy\n\n### Option 1: Manual Subtitles (Preferred)\n\nTry this first - highest quality, human-created:\n\n```bash\nyt-dlp --write-sub --skip-download --output \"OUTPUT_NAME\" \"YOUTUBE_URL\"\n```\n\n### Option 2: Auto-Generated Subtitles (Fallback)\n\nIf manual subtitles aren't available:\n\n```bash\nyt-dlp --write-auto-sub --skip-download --output \"OUTPUT_NAME\" \"YOUTUBE_URL\"\n```\n\nBoth commands create a `.vtt` file (WebVTT subtitle format).\n\n## Option 3: Whisper Transcription (Last Resort)\n\n**ONLY use this if both manual and auto-generated subtitles are unavailable.**\n\n### Step 1: Show File Size and Ask for Confirmation\n\n```bash\n# Get audio file size estimate\nyt-dlp --print \"%(filesize,filesize_approx)s\" -f \"bestaudio\" \"YOUTUBE_URL\"\n\n# Or get duration to estimate\nyt-dlp --print \"%(duration)s %(title)s\" \"YOUTUBE_URL\"\n```\n\n**IMPORTANT**: Display the file size to the user and ask: \"No subtitles are available. I can download the audio (approximately X MB) and transcribe it using Whisper. Would you like to proceed?\"\n\n**Wait for user confirmation before continuing.**\n\n### Step 2: Check for Whisper Installation\n\n```bash\ncommand -v whisper\n```\n\nIf not installed, ask user: \"Whisper is not installed. Install it with `pip install openai-whisper` (requires ~1-3GB for models)? This is a one-time installation.\"\n\n**Wait for user confirmation before installing.**\n\nInstall if approved:\n```bash\npip3 install openai-whisper\n```\n\n### Step 3: Download Audio Only\n\n```bash\nyt-dlp -x --audio-format mp3 --output \"audio_%(id)s.%(ext)s\" \"YOUTUBE_URL\"\n```\n\n### Step 4: Transcribe with Whisper\n\n```bash\n# Auto-detect language (recommended)\nwhisper audio_VIDEO_ID.mp3 --model base --output_format vtt\n\n# Or specify language if known\nwhisper audio_VIDEO_ID.mp3 --model base --language en --output_format vtt\n```\n\n**Model Options** (stick to `base` for now):\n- `tiny` - fastest, least accurate (~1GB)\n- `base` - good balance (~1GB) ← **USE THIS**\n- `small` - better accuracy (~2GB)\n- `medium` - very good (~5GB)\n- `large` - best accuracy (~10GB)\n\n### Step 5: Cleanup\n\nAfter transcription completes, ask user: \"Transcription complete! Would you like me to delete the audio file to save space?\"\n\nIf yes:\n```bash\nrm audio_VIDEO_ID.mp3\n```\n\n## Getting Video Information\n\n### Extract Video Title (for filename)\n\n```bash\nyt-dlp --print \"%(title)s\" \"YOUTUBE_URL\"\n```\n\nUse this to create meaningful filenames based on the video title. Clean the title for filesystem compatibility:\n- Replace `\u002F` with `-`\n- Replace special characters that might cause issues\n- Consider using sanitized version: `$(yt-dlp --print \"%(title)s\" \"URL\" | tr '\u002F' '-' | tr ':' '-')`\n\n## Post-Processing\n\n### Convert to Plain Text (Recommended)\n\nYouTube's auto-generated VTT files contain **duplicate lines** because captions are shown progressively with overlapping timestamps. Always deduplicate when converting to plain text while preserving the original speaking order.\n\n```bash\npython3 -c \"\nimport sys, re\nseen = set()\nwith open('transcript.en.vtt', 'r') as f:\n    for line in f:\n        line = line.strip()\n        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:\n            clean = re.sub('\u003C[^>]*>', '', line)\n            clean = clean.replace('&', '&').replace('>', '>').replace('<', '\u003C')\n            if clean and clean not in seen:\n                print(clean)\n                seen.add(clean)\n\" > transcript.txt\n```\n\n### Complete Post-Processing with Video Title\n\n```bash\n# Get video title\nVIDEO_TITLE=$(yt-dlp --print \"%(title)s\" \"YOUTUBE_URL\" | tr '\u002F' '_' | tr ':' '-' | tr '?' '' | tr '\"' '')\n\n# Find the VTT file\nVTT_FILE=$(ls *.vtt | head -n 1)\n\n# Convert with deduplication\npython3 -c \"\nimport sys, re\nseen = set()\nwith open('$VTT_FILE', 'r') as f:\n    for line in f:\n        line = line.strip()\n        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:\n            clean = re.sub('\u003C[^>]*>', '', line)\n            clean = clean.replace('&', '&').replace('>', '>').replace('<', '\u003C')\n            if clean and clean not in seen:\n                print(clean)\n                seen.add(clean)\n\" > \"${VIDEO_TITLE}.txt\"\n\necho \"✓ Saved to: ${VIDEO_TITLE}.txt\"\n\n# Clean up VTT file\nrm \"$VTT_FILE\"\necho \"✓ Cleaned up temporary VTT file\"\n```\n\n## Output Formats\n\n- **VTT format** (`.vtt`): Includes timestamps and formatting, good for video players\n- **Plain text** (`.txt`): Just the text content, good for reading or analysis\n\n## Tips\n\n- The filename will be `{output_name}.{language_code}.vtt` (e.g., `transcript.en.vtt`)\n- Most YouTube videos have auto-generated English subtitles\n- Some videos may have multiple language options\n- If auto-subtitles aren't available, try `--write-sub` instead for manual subtitles\n\n## Complete Workflow Example\n\n```bash\nVIDEO_URL=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=dQw4w9WgXcQ\"\n\n# Get video title for filename\nVIDEO_TITLE=$(yt-dlp --print \"%(title)s\" \"$VIDEO_URL\" | tr '\u002F' '_' | tr ':' '-' | tr '?' '' | tr '\"' '')\nOUTPUT_NAME=\"transcript_temp\"\n\n# ============================================\n# STEP 1: Check if yt-dlp is installed\n# ============================================\nif ! command -v yt-dlp &> \u002Fdev\u002Fnull; then\n    echo \"yt-dlp not found, attempting to install...\"\n    if command -v brew &> \u002Fdev\u002Fnull; then\n        brew install yt-dlp\n    elif command -v apt &> \u002Fdev\u002Fnull; then\n        sudo apt update && sudo apt install -y yt-dlp\n    else\n        pip3 install yt-dlp\n    fi\nfi\n\n# ============================================\n# STEP 2: List available subtitles\n# ============================================\necho \"Checking available subtitles...\"\nyt-dlp --list-subs \"$VIDEO_URL\"\n\n# ============================================\n# STEP 3: Try manual subtitles first\n# ============================================\necho \"Attempting to download manual subtitles...\"\nif yt-dlp --write-sub --skip-download --output \"$OUTPUT_NAME\" \"$VIDEO_URL\" 2>\u002Fdev\u002Fnull; then\n    echo \"✓ Manual subtitles downloaded successfully!\"\n    ls -lh ${OUTPUT_NAME}.*\nelse\n    # ============================================\n    # STEP 4: Fallback to auto-generated\n    # ============================================\n    echo \"Manual subtitles not available. Trying auto-generated...\"\n    if yt-dlp --write-auto-sub --skip-download --output \"$OUTPUT_NAME\" \"$VIDEO_URL\" 2>\u002Fdev\u002Fnull; then\n        echo \"✓ Auto-generated subtitles downloaded successfully!\"\n        ls -lh ${OUTPUT_NAME}.*\n    else\n        # ============================================\n        # STEP 5: Last resort - Whisper transcription\n        # ============================================\n        echo \"⚠ No subtitles available for this video.\"\n\n        # Get file size\n        FILE_SIZE=$(yt-dlp --print \"%(filesize_approx)s\" -f \"bestaudio\" \"$VIDEO_URL\")\n        DURATION=$(yt-dlp --print \"%(duration)s\" \"$VIDEO_URL\")\n        TITLE=$(yt-dlp --print \"%(title)s\" \"$VIDEO_URL\")\n\n        echo \"Video: $TITLE\"\n        echo \"Duration: $((DURATION \u002F 60)) minutes\"\n        echo \"Audio size: ~$((FILE_SIZE \u002F 1024 \u002F 1024)) MB\"\n        echo \"\"\n        echo \"Would you like to download and transcribe with Whisper? (y\u002Fn)\"\n        read -r RESPONSE\n\n        if [[ \"$RESPONSE\" =~ ^[Yy]$ ]]; then\n            # Check for Whisper\n            if ! command -v whisper &> \u002Fdev\u002Fnull; then\n                echo \"Whisper not installed. Install now? (requires ~1-3GB) (y\u002Fn)\"\n                read -r INSTALL_RESPONSE\n                if [[ \"$INSTALL_RESPONSE\" =~ ^[Yy]$ ]]; then\n                    pip3 install openai-whisper\n                else\n                    echo \"Cannot proceed without Whisper. Exiting.\"\n                    exit 1\n                fi\n            fi\n\n            # Download audio\n            echo \"Downloading audio...\"\n            yt-dlp -x --audio-format mp3 --output \"audio_%(id)s.%(ext)s\" \"$VIDEO_URL\"\n\n            # Get the actual audio filename\n            AUDIO_FILE=$(ls audio_*.mp3 | head -n 1)\n\n            # Transcribe\n            echo \"Transcribing with Whisper (this may take a few minutes)...\"\n            whisper \"$AUDIO_FILE\" --model base --output_format vtt\n\n            # Cleanup\n            echo \"Transcription complete! Delete audio file? (y\u002Fn)\"\n            read -r CLEANUP_RESPONSE\n            if [[ \"$CLEANUP_RESPONSE\" =~ ^[Yy]$ ]]; then\n                rm \"$AUDIO_FILE\"\n                echo \"Audio file deleted.\"\n            fi\n\n            ls -lh *.vtt\n        else\n            echo \"Transcription cancelled.\"\n            exit 0\n        fi\n    fi\nfi\n\n# ============================================\n# STEP 6: Convert to readable plain text with deduplication\n# ============================================\nVTT_FILE=$(ls ${OUTPUT_NAME}*.vtt 2>\u002Fdev\u002Fnull || ls *.vtt | head -n 1)\nif [ -f \"$VTT_FILE\" ]; then\n    echo \"Converting to readable format and removing duplicates...\"\n    python3 -c \"\nimport sys, re\nseen = set()\nwith open('$VTT_FILE', 'r') as f:\n    for line in f:\n        line = line.strip()\n        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:\n            clean = re.sub('\u003C[^>]*>', '', line)\n            clean = clean.replace('&', '&').replace('>', '>').replace('<', '\u003C')\n            if clean and clean not in seen:\n                print(clean)\n                seen.add(clean)\n\" > \"${VIDEO_TITLE}.txt\"\n    echo \"✓ Saved to: ${VIDEO_TITLE}.txt\"\n\n    # Clean up temporary VTT file\n    rm \"$VTT_FILE\"\n    echo \"✓ Cleaned up temporary VTT file\"\nelse\n    echo \"⚠ No VTT file found to convert\"\nfi\n\necho \"✓ Complete!\"\n```\n\n**Note**: This complete workflow handles all scenarios with proper error checking and user prompts at each decision point.\n\n## Error Handling\n\n### Common Issues and Solutions:\n\n**1. yt-dlp not installed**\n- Attempt automatic installation based on system (Homebrew\u002Fapt\u002Fpip)\n- If installation fails, provide manual installation link\n- Verify installation before proceeding\n\n**2. No subtitles available**\n- List available subtitles first to confirm\n- Try both `--write-sub` and `--write-auto-sub`\n- If both fail, offer Whisper transcription option\n- Show file size and ask for user confirmation before downloading audio\n\n**3. Invalid or private video**\n- Check if URL is correct format: `https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_ID`\n- Some videos may be private, age-restricted, or geo-blocked\n- Inform user of the specific error from yt-dlp\n\n**4. Whisper installation fails**\n- May require system dependencies (ffmpeg, rust)\n- Provide fallback: \"Install manually with: `pip3 install openai-whisper`\"\n- Check available disk space (models require 1-10GB depending on size)\n\n**5. Download interrupted or failed**\n- Check internet connection\n- Verify sufficient disk space\n- Try again with `--no-check-certificate` if SSL issues occur\n\n**6. Multiple subtitle languages**\n- By default, yt-dlp downloads all available languages\n- Can specify with `--sub-langs en` for English only\n- List available with `--list-subs` first\n\n### Best Practices:\n\n- ✅ Always check what's available before attempting download (`--list-subs`)\n- ✅ Verify success at each step before proceeding to next\n- ✅ Ask user before large downloads (audio files, Whisper models)\n- ✅ Clean up temporary files after processing\n- ✅ Provide clear feedback about what's happening at each stage\n- ✅ Handle errors gracefully with helpful messages\n",{"name":5,"description":7,"allowed-tools":46},"Bash,Read,Write","main","c7ec8d78e5dc37484c2cfe90ab04de163d97dd41","skills\u002Fyoutube",0,"https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills","https:\u002F\u002Fhyperion360.com\u002Fblog\u002Fparallel-ai-agents-engineering-workflow\u002F","https:\u002F\u002Fgithub.com\u002Fariadoss","https:\u002F\u002Fdanilosapad.com\u002F","CEO & Founder of @Hyperion360","2026-11-01 12:36:50",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add ariadoss\u002Fsuperskills --skill youtube",{"tool":63,"command":64},"bunx","bunx skills add ariadoss\u002Fsuperskills --skill youtube",{"tool":66,"command":67},"pnpm","pnpm dlx skills add ariadoss\u002Fsuperskills --skill youtube","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube\u002FSKILL.md",true,[],[72,97,116,145,161,177],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":41},"01M71AZAYR85PW6BJGSQXS4BN2","write-plan","Use when you have a spec or requirements for a multi-step task, before touching code. Produces an engineering plan complete with TDD tasks, DRY\u002FSOLID\u002FYAGNI principles, a required Test Plan & Verification section, and a coverage target — then auto-runs \u002Fplan-eng-review as an independent double-check before execution.","https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-plan\u002FSKILL.md",[],[79,80,31,81,82,83,36,84,85,86,87,88,89,90,91,92,93,94,95,96],"write plan","plan","coverage","eng","auto","you","code","tasks","review","dry","verification","yagni","as","target","test plan","for","section","complete",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":41},"01M71AZ8NDDP5ZMGEE6FSC4FKR","worktrees","Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification","https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Fworktrees\u002FSKILL.md",[],[99,104,36,105,89,106,107,108,109,110,111,112,29,113,114,115],"selection","git worktrees","work","directory","Safety","git","isolation","feature","plans","with","workspace","implementation",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":125,"publishedAt":41},"01M71AZ4ZQHTNWFRZVYHKQFP08","web-perf","Analyzes web performance using Chrome DevTools MCP. Measures Core Web Vitals (LCP, INP, CLS) and supplementary metrics (FCP, TBT, Speed Index), identifies render-blocking resources, network dependency chains, layout shifts, caching issues, and accessibility gaps. Use when asked to audit, profile, debug, or optimize page load performance, Lighthouse scores, or site speed. Biases towards retrieval from current documentation over pre-trained knowledge.","https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Fweb-perf\u002FSKILL.md",[122],{"categoryNo":123,"categoryName":124,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,36,141,142,143,144],"web perf","perf","web","resources","never","vitals","chrome devtools","performance","re","render","issues","devtools","knowledge","qa","MCP","caching","documentation","optimize","layout",{"skillNo":146,"name":147,"nameZh":6,"description":148,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":149,"categories":150,"keywords":151,"publishedAt":41},"01M71AZ2KZNWYEGKKRMJH8PYG2","verify","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Fverify\u002FSKILL.md",[],[147,152,153,96,154,155,29,156,36,157,158,89,106,159,160],"running","evidence","prs","claim","assertions","output","claims","about","commands",{"skillNo":162,"name":163,"nameZh":6,"description":164,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":165,"categories":166,"keywords":167,"publishedAt":41},"01M71AZ0ACCK7N1QMWQK1FV2HJ","validate-idea","Validate a business idea using the minimalist entrepreneur framework. Use when someone has a business idea and wants to test if it's worth pursuing before building anything.","https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Fvalidate-idea\u002FSKILL.md",[],[168,169,170,171,29,172,36,173,174,175,176],"validate idea","validate","idea","before building","business","test","minimalist","it","framework",{"skillNo":178,"name":179,"nameZh":6,"description":180,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":181,"categories":182,"keywords":186,"publishedAt":41},"01M71AYVHKX89YAFQA2Y7S4ZRP","test-coverage","Finds complex business logic, edge cases, corner cases, and past regressions\nthat lack tests, then writes the missing unit tests (and integration\u002FE2E\ntests when the risk genuinely crosses a boundary) — enforcing Google's\nTesting on the Toilet best practices (real > fake > mock, don't mock types\nyou don't own, verify state not queries, avoid change-detector tests, DAMP\nover DRY in tests, limit mocks per test). Use when asked to \"add tests\",\n\"cover edge cases\", \"check test coverage\", \"write missing tests\", \"harden\nthe tests\", \"test this properly\", or \"make sure this is tested\".","https:\u002F\u002Fgithub.com\u002Fariadoss\u002Fsuperskills\u002Fblob\u002Fmain\u002Fskills\u002Ftest-coverage\u002FSKILL.md",[183],{"categoryNo":184,"categoryName":185,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",[81,187,173,188,189,190,191,192,36,84,34,88,193,194,195,196,32,31,197,198],"test coverage","unit","types","scope","testing","toilet","sure","change","e2e tests","past","edit","paths"]