# Youtube Transcript

> Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.

Source: https://skillsagentes.com/skills/intellectronica/agent-skills/youtube-transcript
Repository: https://github.com/intellectronica/agent-skills
Author: intellectronica
License: CC0-1.0
Updated: hace 6 meses
Context cost: 60 tok installed, 393 tok once triggered, 955 tok with every bundled file
Bundle: 2 files, 4 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add intellectronica/agent-skills --skill youtube-transcript --agent claude-code
```

## What it does

- Extrae la transcripción de un video de YouTube a partir de su URL o ID
- Ejecuta scripts/get_transcript.py con la URL/ID del video
- Devuelve texto plano por segmento o con marcas de tiempo [MM:SS] o [HH:MM:SS]
- Guarda la transcripción en un archivo, usando VIDEO_ID-transcript.txt si no se indica nombre

## Use it when

- El usuario pide la transcripción, subtítulos o captions de un video de YouTube
- El usuario proporciona una URL de youtube.com/watch?v=, youtu.be/ o similar

## What triggers it

- "Dame la transcripción de este video de YouTube: https://youtu.be/abc123"
- "Necesito los subtítulos con marcas de tiempo de https://www.youtube.com/watch?v=xyz"
- "Extrae los captions de este video y guárdalos en transcript.txt"

## Before you install

- El video debe tener captions habilitados (manuales o auto-generados) y se requiere youtube-transcript-api vía uv.

## Files

- SKILL.md — 2 KB
- scripts/get_transcript.py — 2 KB

## SKILL.md

Reproduced verbatim from intellectronica/agent-skills under CC0-1.0. This section is the upstream document and is in English.

# YouTube Transcript

Extract transcripts from YouTube videos using the youtube-transcript-api.

## Usage

Run the script with a YouTube URL or video ID:

```bash
uv run scripts/get_transcript.py "VIDEO_URL_OR_ID"
```

With timestamps:

```bash
uv run scripts/get_transcript.py "VIDEO_URL_OR_ID" --timestamps
```

## Defaults

- **Without timestamps** (default): Plain text, one line per caption segment
- **With timestamps**: `[MM:SS] text` format (or `[HH:MM:SS]` for longer videos)

## Supported URL Formats

- `https://www.youtube.com/watch?v=VIDEO_ID`
- `https://youtu.be/VIDEO_ID`
- `https://youtube.com/embed/VIDEO_ID`
- Raw video ID (11 characters)

## Output

- CRITICAL: YOU MUST NEVER MODIFY THE RETURNED TRANSCRIPT
- If the transcript is without timestamps, you SHOULD clean it up so that it is arranged by complete paragraphs and the lines don't cut in the middle of sentences.
- If you were asked to save the transcript to a specific file, save it to the requested file.
- If no output file was specified, use the YouTube video ID with a `-transcript.txt` suffix.

## Notes

- Fetches auto-generated or manually added captions (whichever is available)
- Requires the video to have captions enabled
- Falls back to auto-generated captions if manual ones aren't available

---

Skills Agentes — https://skillsagentes.com/skills/intellectronica/agent-skills/youtube-transcript