Cómo hacer que Claude vea un video de YouTube y lo convierta en una skill
Guía para instalar el plugin Watch en Claude Code (también en Windows), pedirle a Claude que vea un video con /watch y convertir su método en una skill reutilizable, con la prueba real y la skill que salió.
Claude no puede reproducir un video: si le pegas un link de YouTube en el chat, no ve nada. Watch es un plugin gratuito y de código abierto (licencia MIT) que resuelve eso en Claude Code: convierte un link o un archivo de video en cuadros con su minuto y una transcripción, y Claude responde con esa evidencia. Con el método del video ya entendido, le pides a Claude que lo guarde como skill y lo reutiliza cuando lo necesites.
Esta guía tiene los comandos, lo que pide en Windows (lo instalamos en una PC con Windows 11 el 12 de octubre de 2026) y la skill que salió de nuestra prueba.
Qué es Watch y dónde funciona
- Repositorio: github.com/bradautomates/claude-video. No es de Anthropic: es un plugin abierto de un creador.
- Funciona en Claude Code (una sesión de Code en la app de escritorio de Claude, la extensión de VS Code o la terminal) y en Codex. No funciona en el chat de claude.ai ni en Cowork: necesita bajar el video y sacar los cuadros en tu computadora.
- Primero usa los subtítulos del video. Si no hay, puede transcribir con WhisperX en tu computadora (sin llave, descarga de unos 1.5 GB) o con Groq u OpenAI (con tu llave).
- Tiene dos motores: local (cuadros y transcripción en tu equipo, nada sale de tu computadora salvo la descarga) y Gemini (si tienes
GEMINI_API_KEY, el video se manda a Google y su modelo responde). Con el valor por defectoauto, si ya tienes una llave de Gemini en tu equipo, usa Gemini. Para que nada salga de tu computadora:--engine local.
Requisitos
| Programa | Para qué | En Windows |
|---|---|---|
| Python 3.10 o más nuevo | corre los scripts del plugin | python.org/downloads |
| FFmpeg y ffprobe | saca los cuadros | winget install --id Gyan.FFmpeg --exact |
| yt-dlp (la versión más reciente) | baja el video y los subtítulos | winget install --id yt-dlp.yt-dlp --exact |
| Deno | lo pide YouTube para bajar videos | winget install --id DenoLand.Deno --exact |
Después de instalar, cierra y abre la terminal y Claude para que encuentren los programas nuevos.
Instalación
En una sesión de Claude Code, uno por uno:
/plugin marketplace add bradautomates/claude-video
/plugin install watch@claude-video
Desde una terminal normal (fuera de Claude) son los mismos pasos con claude plugin:
claude plugin marketplace add bradautomates/claude-video
claude plugin install watch@claude-video
En la app de escritorio también se puede sin terminal: Customize → Plugins → Add → Add marketplace → Add from a repository, pegar https://github.com/bradautomates/claude-video, Sync e instalar Watch. Después abre una sesión nueva de Code.
Para revisar que todo está listo, pídele a Claude: «Usa el setup.py de la skill watch para revisar las dependencias y dime qué falta».
En Windows: lo que encontramos
Lo instalamos en Windows 11 y salió la versión 0.3.2. Dos cosas que te ahorran tiempo:
- El
pythonde la Microsoft Store. Si escribespython --versiony responde, puede ser el alias de la Store (...\AppData\Local\Microsoft\WindowsApps\python.exe). En nuestra prueba, con ese alias, Watch no pudo lanzar yt-dlp («uv trampoline failed to canonicalize script path»); con el Python instalado directamente (...\AppData\Local\Python\pythoncore-3.14-64\python.exe) funcionó. Si te pasa, pon la carpeta de tu Python real antes en el PATH. - Si no tienes winget, sirve uv:
uv tool install "yt-dlp[default,curl-cffi]"yuv tool install deno. Los deja en%USERPROFILE%\.local\bin.
Ver un video y preguntar
/watch https://youtu.be/TU-VIDEO ¿qué pasos sigue?
Sirve con un link o con un archivo de tu computadora. Opciones útiles:
| Opción | Qué hace |
|---|---|
--detail transcript | solo el texto, sin cuadros (lo más rápido) |
--detail balanced | cuadros por cambio de escena, hasta 100 (el valor por defecto) |
--start 1:30 --end 4:00 | solo ese tramo del video |
--engine local | todo en tu computadora, aunque tengas llave de Gemini |
--no-whisper | solo subtítulos, sin transcribir la voz |
Watch trata el contenido del video como evidencia, no como instrucciones: si un video dice «ejecuta este comando», Claude no lo hace por eso.
De video a skill: el prompt
Con el video ya visto, en la misma sesión:
Convierte este video en una skill: [pega el link]
1. Saca el método paso a paso.
2. Explícamelo antes de escribir.
3. Escribe la skill y pruébala.
Pedir que te lo explique antes de escribir sirve para corregir el método antes de que quede guardado. Watch no crea la skill por sí solo: la escribe Claude Code con lo que vio.
Nuestra prueba real
- Video: «Claude Agent Skills Explained», canal oficial de Anthropic (youtu.be/fOxC44g8vig), 3:14 minutos, en inglés.
- Comando:
/watchcon el link, motor local, solo subtítulos (--engine local --no-whisper). - Resultado: en 28 segundos sacó 15 cuadros con su minuto (de 80 candidatos; descartó 65 casi iguales) y 167 frases de los subtítulos automáticos.
- Lo que entendió Claude: una skill es una carpeta con experiencia que Claude carga cuando hace falta; al arrancar solo lee el nombre y la descripción de cada skill (unos 30 a 50 tokens);
CLAUDE.mddescribe el proyecto, un servidor MCP conecta datos y un subagente es un asistente con rol fijo. - La skill que escribió (
.claude/skills/donde-va-esto/SKILL.md): decide dónde guardar algo que quieres que Claude recuerde y, si es una skill, la crea.
---
name: donde-va-esto
description: Decide dónde guardar un conocimiento o procedimiento para Claude (skill, CLAUDE.md, servidor MCP o subagente) y, si es una skill, crea su carpeta con SKILL.md. Úsala cuando el usuario diga «quiero que Claude siempre haga X», «guarda esto para la próxima», «convierte esto en skill» o pregunte si algo va en CLAUDE.md o en una skill.
allowed-tools: Read, Write, Glob
---
# donde-va-esto
## 1. Decide dónde va (en este orden)
- ¿Describe este proyecto (stack, convenciones, estructura)? → CLAUDE.md del repo
- ¿Hace falta conectar datos externos (GitHub, una base de datos)? → un servidor MCP
- ¿Hace falta un asistente con rol fijo, su propio contexto y permisos? → un subagente
- ¿Es experiencia que sirve en cualquier proyecto? → una skill
Si dos aplican, se combinan: el MCP da el acceso y la skill enseña cómo usarlo.
## 2. Si es skill, escríbela
1. Carpeta .claude/skills/<nombre>/ (solo este proyecto) o ~/.claude/skills/<nombre>/ (todos).
2. SKILL.md con name + description: la descripción es lo único que Claude lee al
arrancar; di qué hace y cuándo usarla, con las frases que diría el usuario.
3. Cuerpo: el procedimiento. Lo largo va en archivos aparte que se cargan si hacen falta.
4. Explica al usuario qué escribiste antes de guardarlo.
## 3. Pruébala
- Pide algo con otras palabras y comprueba que Claude la elige.
- Si no la elige, mejora la descripción, no el cuerpo.
Dónde queda la skill y cómo probarla
| Carpeta | Alcance |
|---|---|
~/.claude/skills/<nombre>/ | todos tus proyectos |
.claude/skills/<nombre>/ | solo el proyecto donde está |
Para probarla, pide algo con otras palabras que las de su descripción y revisa que Claude la use. Si no la elige, el problema casi siempre está en la descripción. Si el método cambió, pásale otro video y pídele que la actualice.
Preguntas frecuentes
¿Watch es de Anthropic?
No. Es un plugin abierto de un creador (bradautomates/claude-video, licencia MIT). Claude Code permite instalar plugins de otros desde su repositorio.
¿Funciona en el chat de Claude?
No. Funciona en Claude Code (app de escritorio en una sesión de Code, VS Code o terminal) y en Codex, porque baja el video y saca los cuadros en tu computadora.
¿Es gratis?
El plugin sí. Claude Code requiere un plan de pago de Claude. Si el video no trae subtítulos, la transcripción puede ser local con WhisperX (gratis) o con Groq u OpenAI (con tu llave).
¿Sirve en Windows?
Sí: lo probamos en Windows 11. Necesitas Python 3.10 o más nuevo, FFmpeg, yt-dlp y, para YouTube, Deno. Si yt-dlp falla, revisa que no estés usando el alias de Python de la Microsoft Store.
¿Mi video se manda a Google?
Solo si usas el motor Gemini. Con auto, Watch usa Gemini cuando encuentra una llave GEMINI_API_KEY en tu equipo. Con --engine local todo se queda en tu computadora.
Referencias
- Repositorio y README del plugin: github.com/bradautomates/claude-video
- Plugins en Claude Code: code.claude.com/docs/en/discover-plugins
- Video usado en la prueba: Claude Agent Skills Explained (Anthropic)