Video
Convierte lo que el usuario te entregue en un video que alguien realmente elegiría ver en lugar de leer la fuente: historia clara, imágenes reales, cada escena con movimiento y afirmaciones precisas.
Todos los videos residen en este estudio (la carpeta videos/ de este repositorio). Lee CLAUDE.md primero: ahí están los comandos, el flujo de trabajo, las convenciones de escenas y los trucos. Esta skill trata sobre el criterio; CLAUDE.md trata sobre la mecánica. Nunca inicialices un nuevo proyecto. Usa npm run new, o edita un video existente en videos/ directamente.
Cómo trabajar
Ejecuta de principio a fin. Haz suposiciones razonables, construye el video e informa lo que asumiste. Haz una pausa para preguntar solo si el usuario te pidió explícitamente que consultes, o si estás realmente bloqueado (la fuente es inaccesible, o no está claro qué PRs o alcance quiere decir).
Sé ingenioso. Apunta al mejor video posible, no al mínimo que funcione con lo que te dieron. Usa cualquier herramienta que ayude: búsqueda web, las referencias y páginas enlazadas de la fuente, publicaciones o documentos relacionados, el trabajo anterior del autor, gh, clonar y ejecutar código, el producto en vivo y otras skills. Completa el contexto faltante, verifica afirmaciones, encuentra mejores imágenes visuales y averigua qué es un término o sistema en lugar de adivinarlo. Una fuente limitada no te limita a lo que contiene. Si un enfoque falla, prueba otro antes de conformarte con menos.
Audiencia por defecto:
- Artículos, publicaciones y artículos académicos: un espectador inteligente que no ha leído la fuente.
- PRs, ramas, repositorios y código: interna. El espectador es el usuario, que quiere entender lo que se hizo, a menudo porque está a punto de revisarlo. Optimiza para "Ahora podría revisar o discutir esto con confianza." Haz un video público o de lanzamiento solo cuando el usuario lo indique.
La duración sigue al contenido. Un PR pequeño puede durar 1–2 minutos; una publicación densa, 5–8. No alargues ni comprimas. Una idea por escena.
1. Entiéndelo mejor que un vistazo
Ve al material principal y léelo todo antes de escribir una palabra.
- Enlaces y artículos académicos: obtén la página en sí. HTML sin procesar primero, luego Playwright si está renderizado por el cliente, si necesitas ver o grabar imágenes visuales, o si está bloqueado (consulta CLAUDE.md). Nunca trabajes a partir de un resumen. Obtén el texto completo y cada figura, video e interactivo. Si está detrás de un inicio de sesión, dilo.
- PRs y diffs: descripción, diff completo, confirmaciones, hilos de revisión, issues vinculadas, resultados de CI. Lee también el código circundante, no solo las líneas cambiadas: llamadores, flujo de datos, pruebas. Descubre por qué se hizo, cuáles eran las alternativas y dónde está el riesgo. Si ver el comportamiento ayuda, ejecútalo y captura antes/después.
- Repositorios: puntos de entrada, arquitectura, el flujo principal de datos o control, y lo que es inusual.
- Notas o un tema: investiga lo suficiente para ser correcto y cita de dónde provienen las afirmaciones.
2. Encuentra la historia
Decide primero la conclusión en una oración, luego el arco que la justifica. Normalmente es: el problema, la idea clave, cómo funciona, la evidencia y lo que significa. Para videos de PR orientados a revisión, cubre también: la forma del cambio, las decisiones importantes, qué es riesgoso o sutil, cómo se prueba y dónde debe mirar un revisor.
Escribe la narración para el oído, con tus propias palabras. Mantén números exactos, nombres y citas de la fuente, y nunca inventes métricas. Si simplificas, mantente fiel a la verdad.
Voz: Kokoro por defecto. Si el usuario quiere una voz más natural, o .env tiene OPENROUTER_API_KEY, usa Gemini TTS (CLAUDE.md, "Voces").
3. Hazlo visual
- Artefactos reales primero: las propias figuras y grabaciones de la fuente, la UI real (capturas de pantalla o grabaciones de la aplicación en ejecución) y código real mostrado como fragmentos enfocados con líneas resaltadas, nunca muros de código.
- Diagramas animados personalizados para todo lo demás: flujos, antes/después, arquitectura, números que cuentan hacia arriba, comparaciones. Cada escena debe tener algo en movimiento que explique la idea, sincronizado con las palabras.
- Tema: que coincida con la marca de la fuente. Para código sin marca, usa el aspecto del producto o un tema limpio y amigable para el código.
4. Verifica, luego entrega
Sigue el bucle de verificación → imágenes fijas → previsualización → renderizado completo en CLAUDE.md. Mira las imágenes fijas y corrige lo que veas, incluyendo superposiciones, tramos vacíos, texto ilegible y sincronización que no coincida con las palabras. Luego informa: la ruta de salida, duración, qué cubre el video, qué verificaste, y cualquier suposición o brecha. Di claramente que no lo has visto de principio a fin.
Deja el estudio mejor
Si te encuentras con un truco reutilizable, agrégalo a CLAUDE.md. Si construyes algo que otros videos querrán (una escena de diff de código, una línea de tiempo de PR, un primitivo de gráfico), muévelo a lib/ o templates/default. Los recursos generados en videos/*/public/ están en gitignore, por lo que cualquier cosa que un clon nuevo no pueda regenerar (medios descargados, imágenes hechas a mano) debe ser obtenida por un script, no simplemente colocada.