Lo que necesitas
Claude Code y unos programas gratuitos. La clave de Whisper solo hace falta si el vídeo no trae subtítulos.
| Pieza | Para qué | Cómo instalarla |
|---|---|---|
| Python 3 | Ejecuta los scripts de Watch (3.10 o posterior) | winget install Python.Python.3.12brew install python |
| yt-dlp | Descarga el vídeo y sus subtítulos | winget install yt-dlp.yt-dlpbrew install yt-dlp |
| ffmpeg | Saca los fotogramas y mide el vídeo | winget install Gyan.FFmpegbrew install ffmpeg |
| Deno | Lo necesita yt-dlp para los vídeos de YouTube | winget install --id DenoLand.Deno --exactYa viene con el yt-dlp de Homebrew |
| Whisper | Transcribe vídeos sin subtítulos (opcional) | Clave de Groq u OpenAI, paso 02 |
| Gemini | Vídeos públicos muy largos (opcional) | Clave gratis de Google, paso 04 |
Escribe los comandos en PowerShell. Al terminar, ciérralo y vuelve a abrirlo para que Windows encuentre los programas nuevos.Escribe los comandos en la app Terminal. Si no tienes Homebrew, instálalo antes desde brew.sh. Comprueba que todo está con yt-dlp --version y ffmpeg -version: si responden con un número, listo.
Instala Watch
Dos comandos dentro de Claude Code. Menos de un minuto.
- Abre Claude Code y pega esto:
/plugin marketplace add bradautomates/claude-video /plugin install watch@claude-video
Si no aparece enseguida, abre una sesión nueva de Claude Code. Al escribir /watch, elige /watch:watch en el autocompletado.
npx skills add bradautomates/claude-video -g --skill watch
- Clave de Whisper (opcional). Solo para vídeos sin subtítulos, como tus propias grabaciones. Créala gratis en console.groq.com/keys y guárdala en este archivo:
C:\Users\TU_USUARIO\.config\watch\.env~/.config/watch/.env
GROQ_API_KEY=pega_aquí_tu_clave
¿Ya tienes clave de OpenAI? Usa OPENAI_API_KEY= en su lugar. No compartas nunca esta clave ni la pegues en un chat.
- Pruébalo con un vídeo que ya hayas visto y hazle una pregunta cuya respuesta conozcas. Si acierta, está funcionando.
/watch https://www.youtube.com/watch?v=ENLACE ¿qué herramientas aparecen en pantalla?
Pregunta bien
Un «resúmelo» te da un resumen. Una pregunta concreta te da algo que puedes usar.
/watch ENLACE resúmelo/watch ENLACE ¿qué pasos exactos sigue y qué valores pone en cada campo?Para un trozo concreto, recorta con --start y --end:
/watch ENLACE --start 2:15 --end 4:30 ¿qué comando escribe aquí?
Elige cuánto mira
--detail (solo cuando Watch mira el vídeo en tu ordenador; ver paso 04).| Modo | Qué mira | Úsalo para |
|---|---|---|
transcript | Solo lo que se dice | Charlas, pódcasts, entrevistas |
efficient | Hasta 50 fotogramas clave | Vídeos largos o una primera pasada |
balanced | Hasta 100, en cada cambio de escena (por defecto) | Tutoriales normales |
token-burner | Todos los cambios de escena | Pantallas con muchos clics |
Watch o Gemini
Watch es para mirar de cerca. Gemini, para entender de qué va un vídeo largo sin gastar tus tokens.
--start y --end.Conecta Gemini en 3 pasos
- Saca una clave gratis en aistudio.google.com/apikey.
- Guárdala en tu ordenador como variable de entorno, con este comando. Después cierra y abre la terminal y Claude Code.
setx GEMINI_API_KEY "pega_aquí_tu_clave"
echo 'export GEMINI_API_KEY="pega_aquí_tu_clave"' >> ~/.zshrc
- Pídeselo a Claude Code con este prompt:
Usa la API de Gemini con mi clave (variable GEMINI_API_KEY) para analizar este vídeo público de YouTube pasándole directamente la URL: ENLACE Devuélveme: 1. Un índice con los temas y el minuto en el que empieza cada uno. 2. Los 3 tramos más prácticos, con minuto de inicio y de fin. 3. Qué herramientas se mencionan. No descargues el vídeo. Si algo falla, dime el error tal cual.
Ojo: Watch ya trae Gemini dentro. Desde sus últimas versiones, si encuentra la clave GEMINI_API_KEY, Watch le pasa el vídeo entero a Gemini por defecto y no mira los fotogramas en tu ordenador (entonces --detail no se aplica). Para mirar de cerca, añade --engine local a tu /watch. Ejemplo: /watch ENLACE --engine local --detail token-burner ¿qué escribe en cada campo?
Límites actuales de Gemini con enlaces de YouTube: solo vídeos públicos, hasta 8 horas de vídeo al día en el plan gratuito y hasta 10 vídeos por petición con Gemini 2.5 o posterior. La función está en fase de prueba y, por ahora, no se cobra.
La fábrica de skills
Se crea una sola vez. A partir de ahí, cada vídeo que veas puede acabar convertido en una skill.
Pega este prompt en Claude Code:
Crea una skill llamada "fabrica-de-skills" en ~/.claude/skills/fabrica-de-skills/. Su trabajo: a partir de lo que /watch ha extraído de un vídeo, escribir una skill nueva y reutilizable. Cómo debe trabajar: 1. Separa tres cosas: lo que el vídeo DICE, lo que MUESTRA en pantalla y lo que solo es relleno o promoción. Usa solo las dos primeras. 2. Si lo dicho y lo mostrado no coinciden, quédate con lo mostrado y anótalo. 3. Escribe un SKILL.md con: nombre en minúsculas con guiones; una descripción de una frase que diga CUÁNDO usarla; requisitos; pasos numerados con los comandos y valores exactos; cómo comprobar que ha salido bien; y errores típicos. 4. No inventes nada que no esté en el vídeo. Si falta un dato, déjalo marcado como PENDIENTE. 5. No guardes claves, contraseñas ni datos personales que aparezcan en pantalla. 6. Antes de instalarla, escribe 3 frases con las que SÍ debería activarse y 3 con las que NO, y comprueba que la descripción las separa bien. 7. Enséñame el borrador y espera mi OK antes de instalarlo en ~/.claude/skills/. Usa la skill skill-creator si está instalada para revisar el formato.
El recorrido completo
/watch ENLACE ¿qué proceso enseña, paso a paso, con los valores exactos?Usa fabrica-de-skills con lo que acabas de ver.- Lee el borrador. Corrige lo que no cuadre y rellena lo que haya quedado PENDIENTE.
- Da el OK y Claude la instala.
- Abre una conversación nueva y pide la tarea sin nombrar la skill. Si Claude la usa sola, la descripción está bien escrita.
Skill, subagente o comando
No todo vídeo debe acabar en una skill. Según lo que enseñe, encaja mejor una de estas tres piezas.
| Pieza | Cómo trabaja | Dónde vive | Elígela si el vídeo enseña… |
|---|---|---|---|
| Skill | Claude la lee cuando sale el tema, dentro de tu conversación | ~/.claude/skills/ | Un método o criterio que quieres que Claude aplique |
| Subagente | Trabaja aparte, con su propio contexto, y te entrega solo el resultado | .claude/agents/ | Un trabajo largo que se puede delegar: auditar, investigar, revisar |
| Comando | Ejecuta pasos fijos en orden cuando escribes /nombre | .claude/commands/ | Una receta que siempre se hace igual |
Si dudas, deja que Claude decida antes de escribir nada:
Con lo que acabas de ver en el vídeo, dime primero si esto debería ser una skill, un subagente o un comando, y por qué en dos líneas. Si es un subagente, créalo en .claude/agents/ con: - Un nombre y una descripción que digan cuándo usarlo, para que se elija solo. - El método del vídeo como instrucciones, con criterios de decisión y lo que NO debe hacer. - Solo las herramientas que necesita, ninguna más. - El formato exacto en el que me entrega el resultado. Si ya existe uno con ese nombre, pregúntame antes de sobrescribirlo. Al terminar, pruébalo con un caso real y enséñame qué ha devuelto.
Tu primer día
Cuatro pasos, en este orden. En una tarde lo tienes funcionando.
- Instala Watch y no sigas hasta que responda bien a la prueba del paso 02.
- Pruébalo con un vídeo que ya conozcas. Si sabes la respuesta, sabrás si se equivoca.
- Saca la clave de Gemini antes de necesitarla y pruébala con un vídeo público corto.
- Crea la fábrica y conviértela en tu primera skill con un tutorial que uses a menudo.
Biblioteca de prompts
Doce prompts listos para copiar, ordenados por lo que quieres conseguir.
Solo lo que se dice
/watch ENLACE --detail transcript dame cada idea importante con su minutoLeer la pantalla
/watch ENLACE --detail token-burner ¿qué menús abre y qué escribe en cada campo?Tu propia grabación
/watch mi-grabacion.mp4 ¿qué pasos hago, en orden, y dónde me lío?Comparar dos versiones
Después de ver los dos vídeos: ¿qué ha cambiado de uno a otro y qué se mantiene?Índice de un vídeo largo
Con la API de Gemini, hazme un índice con minutos de este vídeo público: ENLACEVarios vídeos a la vez
Con la API de Gemini, cruza estos vídeos públicos y dime en qué coinciden y en qué no: ENLACE1, ENLACE2, ENLACE3¿Watch o Gemini?
Para este vídeo y esta pregunta, ¿me conviene Watch o Gemini? Dímelo en una línea con el motivo: ENLACEDel vídeo a la skill en un mensaje
/watch ENLACE y después usa fabrica-de-skills para convertir lo que enseña en una skill. Enséñame el borrador antes de instalar.Comprobar que se activa
Dame 5 frases con las que la skill NOMBRE debería activarse y 5 con las que no, y dime si su descripción las separa bien.Mejorarla con otro vídeo
/watch ENLACE2 y mejora la skill NOMBRE: añade solo lo que este vídeo enseña de nuevo y quita lo que era una manía del primero.Sacar la estructura
/watch ENLACE ¿cuál es la estructura de este vídeo, paso a paso, para reutilizarla con otro tema?Control antes de instalar
Dime qué partes de la skill no salen en el vídeo y te las has imaginado.Si algo falla
| Lo que pasa | Solución |
|---|---|
| «yt-dlp no se reconoce» | Cierra y abre la terminal. Si sigue, reinicia el ordenador. |
| YouTube da error | yt-dlp está desactualizado. Actualízalo: winget upgrade --id yt-dlp.yt-dlp --exactbrew upgrade yt-dlp |
| No sale transcripción | El vídeo no tiene subtítulos: añade la clave de Groq (paso 02). |
| Gasta muchos tokens | --detail efficient, recorta con --start y --end o pásalo antes por Gemini. |
Watch no hace caso a --detail | Tienes la clave de Gemini guardada y la está usando: añade --engine local. |
| Gemini no encuentra la clave | Cierra y abre la terminal y Claude Code después de guardarla. |
| Gemini rechaza el vídeo | Solo acepta vídeos públicos. Si es privado u oculto, usa Watch con --engine local. |
| La skill no se activa | Pide que reescriba la descripción empezando por «Úsala cuando…». |
| La skill inventa pasos | Repite la fábrica y exige que marque como PENDIENTE lo que falte. |