# Youtube Transcriber

> A Claude skill from astoreyai/claude-skills.

- **Type:** Skill
- **Install:** `agentstack add skill-astoreyai-claude-skills-youtube-transcriber`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [astoreyai](https://agentstack.voostack.com/s/astoreyai)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [astoreyai](https://github.com/astoreyai)
- **Source:** https://github.com/astoreyai/claude-skills/tree/master/youtube-transcriber

## Install

```sh
agentstack add skill-astoreyai-claude-skills-youtube-transcriber
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# YouTube Transcriber Skill

Extract transcripts from YouTube videos, playlists, and channels with automatic intelligent processing.

## Overview

One unified command that intelligently assesses input and handles everything—single videos, batch files, playlist expansion, channel extraction. No need to choose between commands; it figures out what to do.

## Capabilities

- **Auto-Detect Input**: Single URL, file of URLs, playlist, channel
- **Smart Expansion**: Automatically expands playlists/channels to individual videos
- **Batch Processing**: Process 1-1000+ videos from mixed input file
- **Timestamps**: Automatic HH:MM:SS formatting on every line
- **Multiple Formats**: Markdown (.md) or plain text (.txt)
- **Error Handling**: Graceful failures, continues on errors

## Quick Usage

```bash
# Single video
/transcribe https://www.youtube.com/watch?v=VIDEO_ID

# Playlist (auto-expands, downloads all)
/transcribe https://www.youtube.com/playlist?list=PL123

# Channel (auto-expands, downloads all uploads)
/transcribe https://www.youtube.com/@creator

# Batch file (auto-detects each URL type, expands if needed)
/transcribe urls.txt

# With options
/transcribe urls.txt --format md --output-dir research
```

## One Command, Many Inputs

| Input | Behavior |
|-------|----------|
| Video URL | Download transcript immediately |
| Playlist URL | Expand to all videos, download transcripts |
| Channel URL | Expand to all uploads, download transcripts |
| File (mixed) | Detect each line, expand playlists/channels, download all |
| File (videos only) | Batch download all transcripts |
| Video ID | Download transcript immediately |

## How It Works

```
Input Assessment
  ↓
├─ Single URL?
│  ├─ Video → Download immediately
│  ├─ Playlist → Expand + Download
│  └─ Channel → Expand + Download
│
└─ File?
   ├─ Detect each line
   ├─ Expand playlists/channels
   └─ Download all transcripts
     ↓
  Output Directory (with all transcripts)
```

## Options

```bash
/transcribe INPUT [OPTIONS]

Options:
  --format {md|txt|both}     Output format (default: both)
  --output-dir DIR           Output directory (default: transcripts)
  --expand/--no-expand       Auto-expand playlists/channels (default: on)
  --inspect                  Show what will be done (no download)
```

## Examples

### Single Video
```bash
/transcribe https://youtu.be/dQw4w9WgXcQ
# → Creates: transcripts/transcript_dQw4w9WgXcQ.md
#           transcripts/transcript_dQw4w9WgXcQ.txt
```

### Playlist (Auto-Expansion)
```bash
/transcribe https://www.youtube.com/playlist?list=PLtqRgJ_TIq8Y6YG8G
# → Expands to all 50 videos
# → Downloads all 50 transcripts
# → Creates: transcripts/transcript_ID1.md, transcript_ID2.md, ...
```

### Batch File (Mixed URLs)
```bash
# Create file:
cat > urls.txt  sources.txt
echo "https://www.youtube.com/@educator" >> sources.txt

# One command: expand, download, ready for analysis
/transcribe sources.txt --output-dir research
```

### Content Curation
```bash
# Download transcripts from multiple creators
/transcribe creators.txt --format md
# → All uploads from all channels
# → Organized transcripts ready for processing
```

### Quick Lookup
```bash
# Just need one video's transcript
/transcribe https://youtu.be/VIDEO_ID
```

### Batch Research
```bash
# Process everything at once
/transcribe mixed_urls.txt --output-dir analysis
# → Auto-detects each line
# → Auto-expands playlists/channels
# → Downloads all transcripts
# → Organized in output-dir
```

## Integration with Agents

### In Workflow
```
Agent receives: List of YouTube URLs (mixed types)
  ↓
/transcribe urls.txt --inspect          (check what will process)
  ↓
/transcribe urls.txt --output-dir data  (download all transcripts)
  ↓
Agent reads transcript directory
  ↓
Agent processes/analyzes transcripts
  ↓
Agent generates report
```

### Function Call (Python)
```python
from skill import transcribe

result = transcribe(
    input="urls.txt",
    format="md",
    output_dir="transcripts",
    expand=True,
    inspect=False
)

# Returns:
# {
#   "success": True,
#   "processed": 150,
#   "output_dir": "transcripts",
#   "files": ["transcript_ID1.md", ...]
# }
```

## Limitations

- YouTube must allow transcripts for the video
- Some videos may have restricted captions
- Large playlists (500+ videos) expand slowly
- Language support depends on available transcripts (default: English)

## Requirements

- `youtube-transcript-api` (0.6.2)
- `yt-dlp` (≥2024.7.1)
- `click` (8.1.7)

## Author

Aaron Storey | Research & Development (Nov 2025)

## Version

1.1.0 - Unified single-command interface with automatic assessment

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [astoreyai](https://github.com/astoreyai)
- **Source:** [astoreyai/claude-skills](https://github.com/astoreyai/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-astoreyai-claude-skills-youtube-transcriber
- Seller: https://agentstack.voostack.com/s/astoreyai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.