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.mdesté 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,stylese 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:
- Verifica el entorno (
scripts/check_env.py). Si falta algo, lo muestra; antes de instalar, pide permiso al usuario. - Crea el directorio de trabajo.
- Copia la plantilla.
- Copia las fuentes.
- Ejecuta npm install.
- Mide el tempo y escribe
src/grid.json. - 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.mdpara buscar y verificar información; escríbela ensource/sources.mdy 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:
| Propuesta | Estilo | Técnica | Enfoque narrativo |
|---|---|---|---|
| A | Estilo Flash animado (ilustración plana) | Remotion + componentes SVG de ilustración plana | Seguro: pregunta → experimento/datos → conclusión → recuerda tres cosas |
| B | Estilo pixel retro (consola retro + TV CRT) | Lienzo Canvas 2D de píxeles → Shader WebGL CRT | Gamificado: elegir cartucho es elegir nivel, HUD muestra datos, diálogos dan conclusiones, pantalla de resultados |
| C | A 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 Remotion | Diferente de A y B | Cambia 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
- 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 dePixelStage. - C escribe algo nuevo, siguiendo la estructura de
PlanC.tsx: la imagen solo depende det, se monta una escena.
- A usa componentes SVG de
- 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:clippara 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.
- 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.
- 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
-
Primero escribe
src/scenes.json:stylese 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.
-
Cada escena debe escribirse:
- Estilo Flash: escribe componentes en
src/scenes/*.tsxy regístralos ensrc/scenes/index.ts. - Estilo Pixel: en
src/pixel/scenes.ts, dentro dePIXEL_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.tsxo escribe un componente completo siguiendo el modelo dePixelFilm.tsx. - Todo el texto se escribe en
src/captions.json, y todos los efectos de sonido ensrc/sfx.json, usando las mismas marcas de tiempo en pulsos.
- Estilo Flash: escribe componentes en
-
Después de cada escena, ejecuta en orden:
npm run typechecknpm 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.
-
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. -
Las reglas de estilo se encuentran en
references/style-flash.mdyreferences/style-pixel.md; las reglas generales enreferences/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
reppara 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-dby--sfx-dbpara 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
- Renderiza:
npm run sfx, luegonpm 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. - Verifica la resolución, la tasa de fotogramas, el número de fotogramas y la duración con
ffprobe; mide la sonoridad conebur128. - Genera fotogramas extraídos:
python tools/qa_sheet.py out/film.mp4 ../qa/final(en Windows también se puede usartools/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. - 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.
- 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 envfilm/scenes.tsxenVSCENE_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 escribebeat_grid.pyen lossegmentsdegrid.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á enreferences/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:
- Recoge su código en
assets/template/src/<nombre_estilo>/. - Escribe
references/style-<nombre_estilo>.md. - En la tabla de candidatos de
plans.md, márcalo como "incluido". - Añade una fila en la tabla de propuestas de este archivo.
- Recoge su código en
- 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)
| Archivo | Contenido |
|---|---|
references/plans.md | Formato de las tres propuestas, tabla de candidatos para C, reglas de vista previa, cómo presentarlas al usuario |
references/brief-template.md | Plantilla de los siete bloques del brief.md |
references/style-flash.md | Estilo Flash animado: normas de estilo, componentes, carátulas |
references/style-pixel.md | Estilo pixel retro: puntos clave de la imagen, paleta de colores, dos resoluciones, tipografía de puntos, sprites, CRT, carátulas |
references/craft.md | Reglas 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.md | Estructura de la plantilla, sistema de pulsos, API de cada componente, comandos comunes |
references/audio.md | Tempo, tabla de sonidos (incluyendo sonidos de chip), nivel de mezcla final, proceso de ajuste de audio |
references/research.md | Método de búsqueda y verificación de información |
references/pitfalls.md | Errores comunes (léelo antes de empezar) |
references/credits.md | Fuentes de inspiración y licencias de fuentes |
references/publish-copy.md | Texto 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.py | Creació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) |