youtube-downloader

$npx mdskill add guia-matthieu/clawfu-skills/youtube-downloader

Downloads YouTube videos, extracts audio, and retrieves transcripts for research and content repurposing.

  • Helps with competitor analysis, podcast creation, and archiving webinars or tutorials.
  • Integrates with yt-dlp for reliable extraction and optionally OpenAI Whisper for transcription.
  • Uses structured workflows and best practices to suggest technical approaches for content processing.
  • Presents results through downloadable files and generated templates or checklists for user review.

SKILL.md

.github/skills/youtube-downloaderView on GitHub ↗
---
name: youtube-downloader
description: "Download and process YouTube content for research. Use when: downloading competitor videos for analysis; extracting audio for podcasts; getting transcripts for content repurposing; archiving webinars; research content curation"
license: MIT
metadata:
  author: ClawFu
  version: 1.0.0
  mcp-server: "@clawfu/mcp-skills"
---

# YouTube Downloader

> Download YouTube videos, extract audio, and get transcripts using yt-dlp - the most reliable YouTube extraction tool.

## When to Use This Skill

- **Competitor research** - Download and analyze competitor videos
- **Content repurposing** - Extract audio for podcasts or transcripts for blogs
- **Training material** - Archive webinars and tutorials
- **Quote extraction** - Get transcripts for pulling quotable moments
- **Offline access** - Save videos for travel or presentations


## What Claude Does vs What You Decide

| Claude Does | You Decide |
|-------------|------------|
| Structures production workflow | Final creative direction |
| Suggests technical approaches | Equipment and tool choices |
| Creates templates and checklists | Quality standards |
| Identifies best practices | Brand/voice decisions |
| Generates script outlines | Final script approval |

## Dependencies

```bash
pip install yt-dlp click
# Optional for transcription:
pip install openai-whisper
```

## Commands

### Download Video
```bash
python scripts/main.py download "https://youtube.com/watch?v=..." --format mp4
python scripts/main.py download "https://youtube.com/watch?v=..." --quality 1080p
```

### Extract Audio
```bash
python scripts/main.py audio "https://youtube.com/watch?v=..." --format mp3
python scripts/main.py audio "https://youtube.com/watch?v=..." --format wav
```

### Get Transcript
```bash
python scripts/main.py transcript "https://youtube.com/watch?v=..."
python scripts/main.py transcript "https://youtube.com/watch?v=..." --translate en
```

### Download Playlist
```bash
python scripts/main.py playlist "https://youtube.com/playlist?list=..." --limit 10
python scripts/main.py playlist "https://youtube.com/playlist?list=..." --audio-only
```

### Get Metadata
```bash
python scripts/main.py info "https://youtube.com/watch?v=..."
python scripts/main.py info "https://youtube.com/watch?v=..." --format json
```

## Examples

### Example 1: Research Competitor Content
```bash
# Get video metadata
python scripts/main.py info "https://youtube.com/watch?v=ABC123"

# Output:
# Title: How We Grew to $1M ARR
# Channel: SaaS Founder
# Duration: 15:32
# Views: 45,230
# Published: 2024-01-15
# Tags: saas, growth, startup

# Download transcript for analysis
python scripts/main.py transcript "https://youtube.com/watch?v=ABC123"
# Output: how-we-grew-to-1m-arr.txt
```

### Example 2: Create Podcast from Webinar
```bash
# Download audio only
python scripts/main.py audio "https://youtube.com/watch?v=WEBINAR" --format mp3 --quality best

# Output: webinar-title.mp3 (ready for podcast editing)

# Get transcript for show notes
python scripts/main.py transcript "https://youtube.com/watch?v=WEBINAR"
# Output: webinar-title.txt
```

### Example 3: Archive Training Playlist
```bash
# Download entire playlist
python scripts/main.py playlist "https://youtube.com/playlist?list=TRAINING" \
  --output ./training-videos/ \
  --limit 20

# Output:
# ./training-videos/
# ├── 01-introduction.mp4
# ├── 02-getting-started.mp4
# └── ...
```

## Quality Options

| Option | Resolution | File Size | Use Case |
|--------|------------|-----------|----------|
| `best` | Highest available | Largest | Archival |
| `1080p` | 1920x1080 | ~1GB/hour | Standard |
| `720p` | 1280x720 | ~500MB/hour | Balance |
| `480p` | 854x480 | ~250MB/hour | Mobile |
| `audio` | N/A | ~100MB/hour | Podcasts |

## Audio Formats

| Format | Quality | Size | Compatibility |
|--------|---------|------|---------------|
| `mp3` | Good | Small | Universal |
| `m4a` | Better | Medium | Apple/Modern |
| `wav` | Lossless | Large | Editing |
| `opus` | Best | Smallest | Modern apps |

## Legal Considerations

⚠️ **Important**: Only download content you have rights to use.

**Generally OK:**
- Your own videos
- Creative Commons content
- Content for personal research/reference
- Content with explicit download permission

**Check First:**
- Competitor content (fair use analysis)
- Content for derivative works
- Anything for commercial use

## Skill Boundaries

### What This Skill Does Well
- Structuring audio production workflows
- Providing technical guidance
- Creating quality checklists
- Suggesting creative approaches

### What This Skill Cannot Do
- Replace audio engineering expertise
- Make subjective creative decisions
- Access or edit audio files directly
- Guarantee commercial success

## Related Skills

- [whisper-transcription](../whisper-transcription/) - Transcribe downloaded audio
- [video-processing](../video-processing/) - Process downloaded videos
- [content-repurposer](../content-repurposer/) - Repurpose transcripts

## Skill Metadata


- **Mode**: cyborg
```yaml
category: automation
subcategory: content-extraction
dependencies: [yt-dlp]
difficulty: beginner
time_saved: 4+ hours/week
```

More from guia-matthieu/clawfu-skills

SkillDescription
aarrr-metricsMeasure and optimize growth using the AARRR (Pirate Metrics) framework with stage-specific KPIs and funnel analysis
ab-test-stats"Calculate A/B test statistical significance. Use when: determining if test results are significant; calculating required sample size; estimating test duration; analyzing conversion experiments; making data-driven decisions"
account-healthAssess customer account health using product usage, support sentiment, payment status, and relationship signals
ad-spend-optimizer"Analyze paid advertising performance across channels and recommend budget reallocation to maximize ROAS and minimize CAC. Use when: planning quarterly ad budget allocation, diagnosing underperforming ad channels, deciding whether to scale spend on a channel, calculating marginal ROI across Google Ads, Meta, LinkedIn, or TikTok, rebalancing media mix after performance shifts, or setting up a test-and-scale framework for new channels."
ai-bot-log-auditUse when analyzing server logs to understand how AI crawlers (GPTBot, ClaudeBot, PerplexityBot) interact with your site. Use when optimizing content placement for LLM retrieval, diagnosing why AI search isn't citing your content, or auditing crawl patterns to find optimization gaps.
ai-storyboard-2x2"Créez des storyboards visuellement cohérents en utilisant la technique des 2x2 Grid Shots de PJ Ace, garantissant éclairage, personnages et décors uniformes entre les plans. Use when: **Après avoir finalisé un script vidéo** - Transformer le concept en visuels; **Besoin de cohérence visuelle** - Personnages et éclairage constants entre les plans; **Préparer des assets pour animation** - Frames prêtes pour Veo, Runway, Kling; **Présenter un storyboard client** - Visualisation avant production;..."
ai-video-concept"Développez une idée créative et structurez un script vidéo optimisé pour la génération IA, en suivant la méthode des scènes de 8 secondes de PJ Ace. Use when: **Démarrer une publicité vidéo IA** - Transformer une idée brute en script structuré; **Créer du contenu vidéo pour les réseaux sociaux** - TikTok, Reels, YouTube Shorts; **Développer un concept de campagne** - Avant de passer au storyboard; **Pitcher une idée vidéo** - Présenter un concept à un client ou une équipe; **Adapter un messag..."
ai-video-prompting"Générez des prompts optimisés pour chaque modèle de génération vidéo IA (Veo 3, Runway Gen-3, Kling 2.6, Pika), en exploitant leurs forces spécifiques. Use when: **Animer des frames de storyboard** - Transformer des images fixes en vidéo; **Choisir le bon modèle** - Sélectionner Veo, Runway, Kling ou Pika selon le besoin; **Optimiser la qualité de génération** - Prompts structurés pour meilleurs résultats; **Créer des transitions fluides** - Scene extension, first/last frame; **Utiliser le mo..."
ai-video-qa"Validez la qualité de vos vidéos IA avant publication avec une checklist complète couvrant technique, créatif, et positionnement marque. Use when: **Avant publication** - Dernière validation avant mise en ligne; **Revue client** - Préparer les points de feedback anticipés; **Itération qualité** - Identifier les problèmes à corriger; **Go/No-Go decision** - Décider si la vidéo est prête; **Post-mortem** - Analyser pourquoi une vidéo a (ou n'a pas) performé"
ai-voice-design"Concevez et générez des voix IA pour vos vidéos en utilisant ElevenLabs ou Qwen3-TTS, avec clonage vocal, design par description, et synchronisation lip-sync. Use when: **Créer une voix de marque** - Définir le ton vocal pour une campagne; **Cloner une voix existante** - Reproduire une voix avec autorisation; **Designer une voix originale** - Créer une voix à partir d'une description; **Multi-personnages** - Gérer plusieurs voix dans une même vidéo; **Lip-sync vidéo IA** - Synchroniser voix e..."