La Bóveda de Manu Lizama
Guía · Claude Code

De vídeo a skill

Pega el enlace de un tutorial y Claude lo ve, entiende lo que enseña y lo convierte en una habilidad que usará cada vez que la necesites.

Nivel PrincipianteTiempo 20 minCoste 0 €Windows y Mac
Una guía de Manu Lizama · @manulizamaes
01

Ver

Watch descarga el vídeo, saca fotogramas y transcripción. Claude oye lo que se dice y ve lo que se hace.

02

Destilar

Tu fábrica de skills separa lo que se enseña del relleno y lo escribe como SKILL.md.

03

Probar e instalar

Revisas el borrador, compruebas que se activa cuando toca y solo entonces queda instalado.

01 / 09

Lo que necesitas

Claude Code y unos programas gratuitos. La clave de Whisper solo hace falta si el vídeo no trae subtítulos.

PiezaPara quéCómo instalarla
Python 3Ejecuta los scripts de Watch (3.10 o posterior)winget install Python.Python.3.12brew install python
yt-dlpDescarga el vídeo y sus subtítuloswinget install yt-dlp.yt-dlpbrew install yt-dlp
ffmpegSaca los fotogramas y mide el vídeowinget install Gyan.FFmpegbrew install ffmpeg
DenoLo necesita yt-dlp para los vídeos de YouTubewinget install --id DenoLand.Deno --exactYa viene con el yt-dlp de Homebrew
WhisperTranscribe vídeos sin subtítulos (opcional)Clave de Groq u OpenAI, paso 02
GeminiVí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.

02 / 09

Instala Watch

Dos comandos dentro de Claude Code. Menos de un minuto.

  1. Abre Claude Code y pega esto:
Claude Code
/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.

¿Usas otro agente como Codex, Cursor o Gemini CLI? Este instalador vale para todos:
Terminal
npx skills add bradautomates/claude-video -g --skill watch
  1. 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
.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.

  1. Pruébalo con un vídeo que ya hayas visto y hazle una pregunta cuya respuesta conozcas. Si acierta, está funcionando.
Claude Code
/watch https://www.youtube.com/watch?v=ENLACE ¿qué herramientas aparecen en pantalla?
Watch no solo funciona con YouTube: también con TikTok, Vimeo y vídeos de tu ordenador, como tus grabaciones de pantalla.
03 / 09

Pregunta bien

Un «resúmelo» te da un resumen. Una pregunta concreta te da algo que puedes usar.

Así no/watch ENLACE resúmelo
Así sí/watch ENLACE ¿qué pasos exactos sigue y qué valores pone en cada campo?

Para un trozo concreto, recorta con --start y --end:

Claude Code
/watch ENLACE --start 2:15 --end 4:30 ¿qué comando escribe aquí?

Elige cuánto mira

Más fotogramas, más detalle y más tokens. Se cambia con --detail (solo cuando Watch mira el vídeo en tu ordenador; ver paso 04).
ModoQué miraÚsalo para
transcriptSolo lo que se diceCharlas, pódcasts, entrevistas
efficientHasta 50 fotogramas claveVídeos largos o una primera pasada
balancedHasta 100, en cada cambio de escena (por defecto)Tutoriales normales
token-burnerTodos los cambios de escenaPantallas con muchos clics
04 / 09

Watch o Gemini

Watch es para mirar de cerca. Gemini, para entender de qué va un vídeo largo sin gastar tus tokens.

Usa WatchDe cerca
El vídeo está en tu ordenador, no es público o lo importante está escrito en pantalla: comandos, menús, valores.
Usa GeminiDe lejos
Es un vídeo público de YouTube, dura más de una hora y quieres saber de qué se habla y dónde.
Usa los dosLejos y luego cerca
Gemini te dice en qué minuto está lo bueno y Watch mira solo ese tramo con --start y --end.

Conecta Gemini en 3 pasos

  1. Saca una clave gratis en aistudio.google.com/apikey.
  2. Guárdala en tu ordenador como variable de entorno, con este comando. Después cierra y abre la terminal y Claude Code.
PowerShell
setx GEMINI_API_KEY "pega_aquí_tu_clave"
Terminal
echo 'export GEMINI_API_KEY="pega_aquí_tu_clave"' >> ~/.zshrc
  1. Pídeselo a Claude Code con este prompt:
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.

05 / 09

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:

Prompt
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

  1. /watch ENLACE ¿qué proceso enseña, paso a paso, con los valores exactos?
  2. Usa fabrica-de-skills con lo que acabas de ver.
  3. Lee el borrador. Corrige lo que no cuadre y rellena lo que haya quedado PENDIENTE.
  4. Da el OK y Claude la instala.
  5. Abre una conversación nueva y pide la tarea sin nombrar la skill. Si Claude la usa sola, la descripción está bien escrita.
06 / 09

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.

PiezaCómo trabajaDónde viveElígela si el vídeo enseña…
SkillClaude la lee cuando sale el tema, dentro de tu conversación~/.claude/skills/Un método o criterio que quieres que Claude aplique
SubagenteTrabaja aparte, con su propio contexto, y te entrega solo el resultado.claude/agents/Un trabajo largo que se puede delegar: auditar, investigar, revisar
ComandoEjecuta 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:

Prompt
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.
07 / 09

Tu primer día

Cuatro pasos, en este orden. En una tarde lo tienes funcionando.

  1. Instala Watch y no sigas hasta que responda bien a la prueba del paso 02.
  2. Pruébalo con un vídeo que ya conozcas. Si sabes la respuesta, sabrás si se equivoca.
  3. Saca la clave de Gemini antes de necesitarla y pruébala con un vídeo público corto.
  4. Crea la fábrica y conviértela en tu primera skill con un tutorial que uses a menudo.
08 / 09

Biblioteca de prompts

Doce prompts listos para copiar, ordenados por lo que quieres conseguir.

Ver un vídeo

Solo lo que se dice

/watch ENLACE --detail transcript dame cada idea importante con su minuto

Leer 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?
Vídeos largos con Gemini

Índice de un vídeo largo

Con la API de Gemini, hazme un índice con minutos de este vídeo público: ENLACE

Varios 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: ENLACE
Crear y mejorar skills

Del 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.
09 / 09

Si algo falla

Lo que pasaSolución
«yt-dlp no se reconoce»Cierra y abre la terminal. Si sigue, reinicia el ordenador.
YouTube da erroryt-dlp está desactualizado. Actualízalo: winget upgrade --id yt-dlp.yt-dlp --exactbrew upgrade yt-dlp
No sale transcripciónEl 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 --detailTienes la clave de Gemini guardada y la está usando: añade --engine local.
Gemini no encuentra la claveCierra y abre la terminal y Claude Code después de guardarla.
Gemini rechaza el vídeoSolo acepta vídeos públicos. Si es privado u oculto, usa Watch con --engine local.
La skill no se activaPide que reescriba la descripción empezando por «Úsala cuando…».
La skill inventa pasosRepite la fábrica y exige que marque como PENDIENTE lo que falte.
Watch es un proyecto de código abierto de terceros (licencia MIT), no de Anthropic, y Gemini es un servicio de Google. Los dos pueden cambiar: si algo no coincide, manda su documentación oficial.

Esta guía sale de un reel. Comenta qué habilidad vas a crear primero.

Ver el reel

¿Te ha servido? Recibe la siguiente antes que nadie

Una guía nueva cada semana, directa a tu correo.

Uso tu correo solo para enviarte guías y novedades. Puedes darte de baja cuando quieras.

Más de la Bóveda

  • Watch · Claude ve cualquier vídeo

    RepoPrincipiante

    Plugin para Claude Code: /watch descarga un vídeo (o lee uno de tu ordenador), saca fotogramas y transcripción y se los da a Claude para que lo entienda.

    1 min Gratis Windows · Mac
  • Fábrica de skills · Convierte lo que ve /watch en una skill

    RepoPrincipianteDe Manu

    Mi skill para Claude Code: a partir de lo que /watch saca de un vídeo, escribe una skill nueva, sin inventar pasos y enseñándote el borrador antes de instalarla.

    1 min Gratis Windows · Mac
  • Fábrica de skills · El prompt que crea la skill

    PromptPrincipiante

    Pégalo una vez en Claude Code y tendrás una skill que convierte cualquier tutorial que vea /watch en una skill nueva.

    1 min Gratis Windows · Mac

Ver toda la Bóveda →

Sígueme en Instagram @manulizamaesCada reel trae su guía aquí.

Bienvenido a la Bóveda

Guías, repos y prompts de IA para tu negocio, cada semana

Recibe la próxima guía antes que nadie

Uso tu correo solo para enviarte guías y novedades. Puedes darte de baja cuando quieras.