Communitygithub.com

triptu/create-explicación-en-video

Crea un video explicativo narrado y con subtítulos a partir de cualquier cosa: una URL de artículo o blog, un artículo académico, uno o más pull requests, una rama o diff, un repositorio, notas preliminares; o revisa un video existente.

¿Qué es create-explicación-en-video?

Esta skill convierte cualquier fuente de contenido —artículos, PRs, repositorios, diffs o notas— en un video narrativo de alta calidad, con narración, subtítulos y animaciones personalizadas. El objetivo es que el video sea atractivo de ver, superando la simple lectura del material original. La skill prioriza la autonomía: analiza completamente la fuente, investiga de forma autónoma usando herramientas como búsqueda web, `gh`, o Playwright, y construye el video de principio a fin sin interrupciones, solo preguntando si está realmente bloqueada. Está diseñada para agentes de IA que trabajan con las herramientas de edición de video y narración del repositorio `triptu/create-explainers`. Soporta múltiples formatos de video, audiencia (interna para PRs/código, general para artículos), y puede variar la voz (Kokoro por defecto, Gemini TTS si está configurado). El flujo de trabajo incluye comprensión profunda, búsqueda de la historia, creación visual con diagramas animados y capturas reales, y verificación mediante un bucle de previsualización y renderizado final.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/triptu/create-explainer-videos/tree/HEAD/.claude/skills/video

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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.

Skills relacionados