Communitygithub.com

science-video

Crea videos animados de divulgación y explicación con código (ciencia, idiomas, vida cotidiana, productos, etc.). Pregunta el tema, busca información real con fuentes, ofrece tres propuestas diferenciadas, produce por escenas, sincroniza con música y genera carátulas.

¿Qué es science-video?

Este Skill permite a agentes AI (como Claude, Cursor o Codex) crear videos animados de divulgación y explicación sobre cualquier tema de conocimiento, usando exclusivamente código. El flujo comienza preguntando al usuario qué quiere (idea, artículo, producto, repositorio o video de referencia), investiga información real y la documenta con enlaces, luego ofrece tres propuestas visuales muy diferenciadas: A (Flash animado con SVG), B (píxeles retro con CRT) y C (una tercera opción sugerida según el tema). Cada propuesta incluye un fotograma clave o una muestra de 2–4 segundos. Tras la selección, se genera un `brief.md` con la guía completa, se produce escena por escena con autocontrol en cada una, se sincroniza la música de fondo con los efectos de sonido sintetizados en Python, se renderiza en MP4 y se crean carátulas 3:4 y 4:3. Soporta formatos horizontal (1920×1080) y vertical (1080×1920 para TikTok/shorts). Es ideal para creadores que quieran automatizar la producción de videos educativos o promocionales con un estilo único y reproducible.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dominoeffect/science-video-skill/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

Video animado de divulgación con código

Todos los fotogramas se dibujan con código puro en Remotion, y los efectos de sonido se sintetizan con Python. Primero se ofrecen tres propuestas con vista previa, el usuario elige, se escribe un brief.md y luego se produce escena por escena.

Reglas estrictas

  • Usa solo el flujo de este Skill. No sustituyas estos pasos con otros flujos de trabajo o proyectos.
  • La información debe ser real y tener enlaces. Cada fuente debe abrirse y verificarse personalmente. Si no se puede verificar, márcala como "no verificado". No inventes datos ni menciones sin origen.
  • Cada paso requiere confirmación del usuario: lista de fuentes → tres propuestas con vista previa → nivel de sonido → carátulas. Cuando el brief.md esté listo, dile al usuario dónde está.
  • Sin narración (a menos que el usuario lo pida). Toda la información se transmite mediante texto en pantalla. La música de fondo la proporciona el usuario (debe tener derechos de uso). Los efectos de sonido se sintetizan y sincronizan con el ritmo. El repositorio no incluye archivos de música.
  • Texto: sin superposiciones, legible, con el tiempo suficiente de permanencia, sin acumular párrafos grandes. Las escenas deben ser ricas visualmente; los personajes (personas, animales u objetos) deben dibujarse con detalle y cuidado.
  • Formato predeterminado: horizontal 1920×1080, 30fps; si el usuario solicita vertical/TikTok/cortos, usa 1080×1920 (en scenes.json, style se establece en "vflash"). La duración es igual a la de la música de fondo (si no hay música, se puede especificar duración y BPM).

Directorio de trabajo

<tema>/                     Ejemplo: ~/videos/<tema>
  demo.mp3 / demo.mp4      Música de fondo o video de referencia proporcionados por el usuario (opcional)
  source/                  sources.md (lista de fuentes), ref-notes.md (análisis del video de referencia), material original
  previews/                plan-a.png, plan-b.mp4, plan-c.png (vistas previas de las tres propuestas)
  brief.md                 Propuesta completa confirmada, también sirve como prompt reutilizable
  video/                   Proyecto Remotion (generado por new_project.py o new_project.ps1)
  qa/                      Fotogramas fijos por escena, fotogramas extraídos del video completo, review_log.md
  <nombre>.mp4             Video final
  carátulas/               Carátula_3_4_vertical.jpg, Carátula_4_3_horizontal.jpg

Paso 0: Crear el proyecto

python <skill>/scripts/new_project.py --project "<directorio_tema>"
# Sin música de fondo: ... --no-music --duration 60 --bpm 120

En Windows también se puede usar scripts/new_project.ps1. Este script hace lo siguiente en orden:

  1. Verifica el entorno (scripts/check_env.py). Si falta algo, lo muestra; antes de instalar, pide permiso al usuario.
  2. Crea el directorio de trabajo.
  3. Copia la plantilla.
  4. Copia las fuentes.
  5. Ejecuta npm install.
  6. Mide el tempo y escribe src/grid.json.
  7. Genera la primera versión de la mezcla.

Todo el proceso toma de 1 a 3 minutos. Si se ejecuta en un entorno que requiere comandos largos en segundo plano, inícialo en segundo plano y consulta la salida (consulta references/pitfalls.md).

La plantilla incluye un ejemplo de marcador de posición universal de unos 12 segundos para verificar que el proyecto se puede renderizar. Al cambiar el tema, se deben reescribir las escenas, los subtítulos y los efectos de sonido. Un ejemplo completo de varias escenas está en examples/bait-color/ (opcional, no es contenido predeterminado).

Paso 1: Preguntar qué se quiere hacer

El usuario puede proporcionar cualquiera de los siguientes materiales, incluso mezclados:

  • Idea: puede ser un tema de una sola frase.
  • Contenido original: artículo, guion hablado, URL del producto, repositorio de código, hoja de datos.
  • Video de referencia, música de fondo.

Haz un máximo de 3 preguntas aclaratorias, solo aquellas que cambien la propuesta: duración, relación de aspecto, si quiere narración, colores o fuentes específicos. Lo que el usuario no especifique se usa por defecto y se indica en la propuesta para que el usuario pueda cambiarlo.

Procesamiento del material:

  • Temas de divulgación o hechos: consulta references/research.md para buscar y verificar información; escríbela en source/sources.md y preséntala al usuario para confirmación.
  • Artículos, guiones hablados: extrae la información clave, la audiencia y los hechos que deben aparecer. Los hechos solo provienen del material original; no escribas nada incierto.
  • URL del producto: lee la página, anota el nombre del producto, funciones, eslogan y colores de marca. Si necesitas capturas de pantalla, pide permiso primero.
  • Repositorio de código: lee el README y los archivos clave, extrae las funcionalidades; no inventes funciones.
  • Video de referencia:
    • Pide permiso antes de descargar el enlace.
    • Mide las especificaciones con ffprobe.
    • Encuentra los puntos de cambio de escena con ffmpeg -vf "select='gt(scene,0.3)',showinfo".
    • Extrae 1 fotograma por segundo y crea una hoja de contacto.
    • Escribe la estructura de escenas, ritmo, paleta de colores, fuentes y técnicas en source/ref-notes.md.
    • Solo aprende la estructura y las técnicas; no copies materiales ni textos.
  • Música de fondo: el script de creación del proyecto ya mide el tempo, imprime BPM, límites de sección y desviación; la propuesta y el storyboard se ajustan a ella.

Paso 2: Ofrecer tres propuestas

Escribe según references/plans.md. Las tres propuestas tienen roles fijos:

PropuestaEstiloTécnicaEnfoque narrativo
AEstilo Flash animado (ilustración plana)Remotion + componentes SVG de ilustración planaSeguro: pregunta → experimento/datos → conclusión → recuerda tres cosas
BEstilo pixel retro (consola retro + TV CRT)Lienzo Canvas 2D de píxeles → Shader WebGL CRTGamificado: elegir cartucho es elegir nivel, HUD muestra datos, diálogos dan conclusiones, pantalla de resultados
CA sugerir en el momento: elige de la tabla de candidatos de plans.md la más adecuada al tema, o propón una nueva que se pueda hacer con RemotionDiferente de A y BCambia el enfoque narrativo: plano secuencia, personaje que recorre toda la pieza, flashback, una metáfora que lo explique todo

Cada propuesta debe detallar: nombre, resumen en una frase, estilo (valores de color y fuente), especificaciones, combinación técnica, resumen escena por escena (con marcas de tiempo), sonido, tiempo estimado de renderizado, dificultades y riesgos, y por qué es adecuada para el material.

Las tres propuestas deben diferenciarse claramente en estilo, técnica y enfoque narrativo; no basta con cambiar la paleta de colores.

Paso 3: Vista previa de cada propuesta

  1. En video/src/preview/PlanA.tsx, PlanB.tsx, PlanC.tsx, monta una escena que represente mejor la propuesta, comenzando en el tiempo 0, con una duración de 2–4 segundos. En la plantilla, estos tres archivos contienen ejemplos de marcador de posición universales; modifícalos según:
    • A usa componentes SVG de src/art/, src/ui/.
    • B usa el motor src/pixel/, dibuja dentro de PixelStage.
    • C escribe algo nuevo, siguiendo la estructura de PlanC.tsx: la imagen solo depende de t, se monta una escena.
  2. Ejecuta:
    node tools/preview.mjs --out ../previews --estimate A:2.4 B:2.5 C:3.9
    
    • Por defecto, cada propuesta genera un fotograma clave; los números después de los dos puntos indican los segundos en los que se toma el fotograma.
    • Si el atractivo visual está en el movimiento, escribe B:clip para generar un clip de 3 segundos.
    • El script imprime el tiempo por fotograma y la estimación de renderizado completo; ese número se incluye en la propuesta.
  3. Revisa tú mismo la vista previa: ¿el texto se desborda?, ¿los elementos están amontonados?, ¿la imagen está demasiado vacía?, ¿los tres estilos realmente se diferencian? Corrige antes de entregar al usuario.
  4. Entrega al usuario el texto de las tres propuestas junto con las vistas previas (incrusta las imágenes en la respuesta; cada asistente lo maneja de forma diferente). El usuario puede elegir una, pedir una combinación o modificaciones; si hay cambios, vuelve al paso 2 o 3 hasta que el usuario confirme.

Paso 4: Escribir brief.md

Tras la confirmación del usuario, escribe <tema>/brief.md siguiendo references/brief-template.md. Consta de siete bloques: <role>, <inputs>, <direction>, <structure>, <build>, <gotchas>, <start>. Todo lo confirmado se escribe con datos reales; los valores por defecto se indican como tales. Al terminar, dile al usuario la ubicación del archivo.

La producción posterior se ciñe estrictamente al brief. Si hay cambios durante el proceso, primero modifica el brief, luego el código. El usuario puede usar este brief directamente si cambia de tema o lo ejecuta en otra herramienta.

Paso 5: Producir escena por escena

  1. Primero escribe src/scenes.json:

    • style se escribe "flash" o "pixel"; el componente Root lo usa para seleccionar el conjunto visual.
    • La tabla de escenas se escribe con marcas de tiempo en pulsos; los cortes se colocan en los límites de las secciones.
  2. Cada escena debe escribirse:

    • Estilo Flash: escribe componentes en src/scenes/*.tsx y regístralos en src/scenes/index.ts.
    • Estilo Pixel: en src/pixel/scenes.ts, dentro de PIXEL_SCENES, escribe la función de dibujo (c, f) => void.
    • Estilo C: amplía el código de vista previa del paso 3, conéctalo en Film.tsx o escribe un componente completo siguiendo el modelo de PixelFilm.tsx.
    • Todo el texto se escribe en src/captions.json, y todos los efectos de sonido en src/sfx.json, usando las mismas marcas de tiempo en pulsos.
  3. Después de cada escena, ejecuta en orden:

    • npm run typecheck
    • npm run check (revisión de subtítulos, debe dar 0 problemas)
    • node tools/stills.mjs --out ../qa <segundo_de_entrada> <segundo_de_acción_principal> <segundo_de_salida>

    Luego revisa cada imagen: comprueba superposiciones, elementos fuera de cuadro, texto sobre rostros, texto superpuesto. Corrige antes de pasar a la siguiente escena.

  4. Si el video dura más de 30 segundos, una vez montadas todas las escenas, genera un borrador de baja resolución: node tools/render.mjs --scale 0.5 --out out/draft.mp4. Confirma el ritmo y las transiciones antes de refinar los detalles.

  5. Las reglas de estilo se encuentran en references/style-flash.md y references/style-pixel.md; las reglas generales en references/craft.md.

Paso 6: Sonido

Las reglas están en references/audio.md:

  • Los efectos de sonido y las acciones visuales se escriben en la misma marca de tiempo (pulso).
  • El estilo pixel usa el tono chip_* (sonido de chip).
  • El efecto de máquina de escribir usa el campo rep para repetir el sonido.
  • El nivel por defecto es el valor final de la mezcla.
  • Si el usuario dice que está demasiado alto, bajo o estridente, usa --music-db y --sfx-db para generar varios archivos de comparación y que el usuario elija. Solo se cambia la pista de audio, no se re-renderiza el video.

Paso 7: Renderizado y control de calidad

  1. Renderiza: npm run sfx, luego npm run render. El tiempo estimado está en el paso 3; para una pieza de 3200 fotogramas, el estilo Flash tarda aproximadamente 1.8 minutos, el pixel unos 6 minutos.
  2. Verifica la resolución, la tasa de fotogramas, el número de fotogramas y la duración con ffprobe; mide la sonoridad con ebur128.
  3. Genera fotogramas extraídos: python tools/qa_sheet.py out/film.mp4 ../qa/final (en Windows también se puede usar tools/qa_sheet.ps1). Se generan dos: una hoja de contacto completa y una versión para móvil de 360 píxeles de ancho por cuadro.
  4. Puntúa según la lista de autocontrol de references/craft.md; cada uno de los 7 elementos debe tener una puntuación de 8 o más:
    • Enumera los 3 problemas más graves y sus marcas de tiempo.
    • Re-renderiza solo la sección problemática (node tools/render.mjs --frames inicio-fin), luego compón el video completo.
    • Anota las puntuaciones y los problemas de cada ronda en qa/review_log.md.
  5. Copia el video final a <tema>/<nombre>.mp4.

Puntos clave para videos verticales cortos (style = vflash)

  • El componente de video completo está en src/vfilm/: VFilm, VOverlay, tarjetas y etiquetas universales, carátula minimalista. Las escenas se registran en vfilm/scenes.tsx en VSCENE_MAP.
  • Zona segura de subtítulos: x 40–1040, y 240–1640; el texto permanece al menos 3.5 segundos por defecto, las tarjetas cortas al menos 3 segundos.
  • No superpongas las fuentes en la imagen; las fuentes solo se escriben en source/sources.md. En la imagen, a lo sumo indica "ilustrativo".
  • Final sugerido: repaso/votación numerados + llamada a seguir. Las reglas de texto se encuentran en references/publish-copy.md (título ≤ 30 caracteres, descripción ≤ 100 caracteres incluyendo hashtags).
  • Sonoridad del video final: -16 LUFS, pico verdadero ≤ -2 dBTP: python tools/loudnorm.py out/film.mp4. La música de fondo debe oírse claramente.
  • Los cortes se sincronizan con el primer pulso del compás: python tools/sync_check.py. Las curvas de velocidad las escribe beat_grid.py en los segments de grid.json.
  • Carátulas verticales: npm run vcover34 / vcover43.

Paso 8: Carátulas

Cada estilo tiene dos versiones: 3:4 y 4:3; el vertical también tiene un juego minimalista:

  • Estilo Flash (composición horizontal): npm run cover34, npm run cover43
  • Estilo Pixel: npm run pixelcover34, npm run pixelcover43
  • Vertical minimalista: npm run vcover34, npm run vcover43

Todas se exportan al doble de resolución. Las reglas de maquetación están en la documentación del estilo correspondiente y en references/publish-copy.md. Para carátulas de videos cortos, evita la esquina inferior izquierda (zona de reproducción) y no uses bandas de color en la parte inferior para apilar listas.

Entrega

Informa al usuario:

  • Ruta del video final, ruta de brief.md, directorio del proyecto.
  • Las decisiones creativas clave de esta producción.
  • Las limitaciones conocidas.
  • El tiempo de renderizado.
  • Los hechos inciertos que requieren verificación por parte del usuario, listados por separado.

Modificar estilos, añadir nuevos estilos

  • Solo para este video: modifica solo los archivos dentro de video/ de este video; no toques la plantilla del Skill. La ubicación de cada parte en los archivos está en references/craft.md, sección "Distribución de estilos en los archivos". Primero genera 4–6 fotogramas representativos para que el usuario confirme el estilo, luego haz el video completo.
  • Para usar el estilo C en adelante:
    1. Recoge su código en assets/template/src/<nombre_estilo>/.
    2. Escribe references/style-<nombre_estilo>.md.
    3. En la tabla de candidatos de plans.md, márcalo como "incluido".
    4. Añade una fila en la tabla de propuestas de este archivo.
  • Estilos que no se pueden hacer: este flujo solo dibuja vectores y píxeles con código; no se pueden hacer tomas reales, 3D realista ni personajes realistas. Si se necesitan personajes realistas, el usuario puede generar primero clips de personajes sobre fondo verde con un modelo de video, y el código se encarga solo del escenario y el texto.

Archivos de referencia (léelos cuando sea necesario)

ArchivoContenido
references/plans.mdFormato de las tres propuestas, tabla de candidatos para C, reglas de vista previa, cómo presentarlas al usuario
references/brief-template.mdPlantilla de los siete bloques del brief.md
references/style-flash.mdEstilo Flash animado: normas de estilo, componentes, carátulas
references/style-pixel.mdEstilo pixel retro: puntos clave de la imagen, paleta de colores, dos resoluciones, tipografía de puntos, sprites, CRT, carátulas
references/craft.mdReglas de storyboard, reglas de subtítulos, autocontrol por escena, puntuación de autocontrol del video completo, lista de verificación, distribución de estilos en los archivos
references/remotion-kit.mdEstructura de la plantilla, sistema de pulsos, API de cada componente, comandos comunes
references/audio.mdTempo, tabla de sonidos (incluyendo sonidos de chip), nivel de mezcla final, proceso de ajuste de audio
references/research.mdMétodo de búsqueda y verificación de información
references/pitfalls.mdErrores comunes (léelo antes de empezar)
references/credits.mdFuentes de inspiración y licencias de fuentes
references/publish-copy.mdTexto de publicación vertical, final de votación, zona segura, sonoridad
scripts/new_project.py, new_project.ps1, check_env.py, beat_grid.py, music_rms.py, qa_sheet.pyCreación de proyecto, verificación de entorno, medición de tempo, medición de nivel, extracción de fotogramas
assets/template/Plantilla del proyecto Remotion (incluye todos los componentes universales de ambos estilos y ejemplos de marcador de posición)
assets/fonts/Fuente de puntos Fusion Pixel 12px (OFL)
examples/bait-color/Ejemplo completo de varias escenas (opcional, no es la plantilla predeterminada)

Skills relacionados