← Learning
Guía práctica · Herramientas de IA

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 defecto auto, si ya tienes una llave de Gemini en tu equipo, usa Gemini. Para que nada salga de tu computadora: --engine local.

Requisitos

ProgramaPara quéEn Windows
Python 3.10 o más nuevocorre los scripts del pluginpython.org/downloads
FFmpeg y ffprobesaca los cuadroswinget install --id Gyan.FFmpeg --exact
yt-dlp (la versión más reciente)baja el video y los subtítuloswinget install --id yt-dlp.yt-dlp --exact
Denolo pide YouTube para bajar videoswinget 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:

  1. El python de la Microsoft Store. Si escribes python --version y 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.
  2. Si no tienes winget, sirve uv: uv tool install "yt-dlp[default,curl-cffi]" y uv 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ónQué hace
--detail transcriptsolo el texto, sin cuadros (lo más rápido)
--detail balancedcuadros por cambio de escena, hasta 100 (el valor por defecto)
--start 1:30 --end 4:00solo ese tramo del video
--engine localtodo en tu computadora, aunque tengas llave de Gemini
--no-whispersolo 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: /watch con 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.md describe 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

CarpetaAlcance
~/.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