mcpField
Y
youtube

youtube

github.com/steveclarkeCreative & media36124 installsUpdated today
Repository

About youtube

A skill for downloading and processing YouTube video and playlist content. It directs transcript and subtitle tasks to one workflow, and audio downloads, MP3 tagging, and library organization to another.

Key features

  1. 01Downloads subtitles and transcripts
  2. 02Provides a VTT-to-text and Whisper fallback workflow
  3. 03Downloads audio and playlists as MP3s
  4. 04Supports MP3 tagging and music organization
  5. 05Selects a workflow based on the request

Use cases

  1. 01Retrieve captions or text from a video
  2. 02Download playlist audio for a music library
  3. 03Tag and organize downloaded MP3 files

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/steveclarke/dotfiles --skill youtube

After installing, type/youtubein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
mp3-download.md
transcripts.md
scripts/
ytmp3

Details

From the project README

YouTube

Download and process content from YouTube videos and playlists.

Capabilities

This skill handles two main workflows:

TaskReferenceUse When
Transcriptsreferences/transcripts.mdUser wants captions, subtitles, or text content from a video
Music/MP3sreferences/mp3-download.mdUser wants to download audio, tag MP3s, or build a music library

Quick Start

For Transcripts
# Check available subtitles
yt-dlp --list-subs "YOUTUBE_URL"

# Download auto-generated subtitles
yt-dlp --write-auto-sub --skip-download -o "transcript" "YOUTUBE_URL"

Load references/transcripts.md for the full workflow including VTT-to-text conversion and Whisper fallback.

For Music/MP3s
# Check playlist info
ytmp3 info "YOUTUBE_URL"

# Download playlist
ytmp3 download "YOUTUBE_URL"

Load references/mp3-download.md for the full tagging and organization workflow.

Prerequisites

  • yt-dlp — YouTube downloader (install via brew install yt-dlp)
  • eyeD3 — MP3 tagging (install via brew install eye-d3, needed for MP3 workflow)

Workflow Selection

Based on the user's request:

  • "transcript", "captions", "subtitles", "transcribe", "text from video" → Load references/transcripts.md
  • "download music", "MP3", "playlist", "tag", "album", "music library" → Load references/mp3-download.md

If unclear, ask the user what they want to do with the YouTube content.

Comments

Markdown supported