yanjigb/article-to-motion-graphics

De artículo a motion graphics

Crea videos verticales tipo explicador a partir de un artículo, priorizando información clara, tipografía legible y voz en off a velocidad natural. No uses footage real a menos que el usuario lo solicite explícitamente.

Proceso obligatorio

1. Definir el brief. Registrar la URL o el texto fuente, el idioma de la voz, la relación de aspecto, la plataforma, la duración deseada y si se necesita voz en off/música. Por defecto: 9:16, 1080×1920, motion graphics a pantalla completa, voz en off en el idioma del artículo, música instrumental suave.
2. Leer la fuente. Si hay URL, leer el contenido del artículo mediante el proceso de research/fetch adecuado. Extraer cifras, argumentos y conclusiones; no inferir datos. Usar la fuente del artículo como cita en el storyboard o en la tarjeta final si corresponde.
3. Escribir un storyboard breve. Dividir en 6 a 10 estados de información. Cada estado debe incluir: duración estimada, un mensaje principal, texto en pantalla, tipo de movimiento y la frase de voz en off correspondiente. Mantener un punto focal en cada momento; evitar acumular varias frases en una sola pantalla.
4. Elegir la duración según la voz en off. Redactar un guion de habla natural, no un ensayo. Estimar entre 135 y 165 palabras por minuto; si el guion es más largo que el video, priorizar alargar el video o acortar el guion, no acelerar más de 1.1× a menos que el usuario lo solicite. La voz en off debe incluir la frase final completa, sin cortes abruptos.
5. Crear los motion graphics. Generar fondos, cuadrículas, formas, contadores, barras, embudos, diagramas de red o maquetas de interfaz mediante código autónomo. Usar fuentes fallback locales con soporte Unicode. Mantener el texto dentro del área segura, con tamaño de letra legible en pantallas de móvil, y colocar la cita/tarjeta final al final.
6. Generar la voz en off. Antes de llamar a la herramienta de síntesis de voz, leer tts-prompter. Usar una voz coherente, language_code correcto y turns[].text solo con el texto que se debe leer. Colocar las instrucciones de estilo de voz en turns[].style; no incluir acotaciones ni etiquetas de hablante en el texto.
7. Crear la música de fondo. Antes de llamar a la herramienta de música, leer music-prompter. Para videos con narración, solicitar "Instrumental only, no vocals", arreglo ligero, sin melodía principal que opaque la voz. Generar una pista lo suficientemente larga para hacer loop o truncar; no dividir en partes si el video dura menos de 180 segundos.
8. Mezclar el audio. Usar FFmpeg para cortar/hacer loop de la música hasta la duración exacta del video, mantener la voz en off a velocidad natural, bajar el volumen de la música entre un 12 y 20 % respecto a la voz, y luego usar amix y alimiter. Si la voz es más larga que el video, re-renderizar el video con la duración de la voz o ajustar el storyboard; no cortar silenciosamente parte de la narración.
9. Verificar. Usar ffprobe para confirmar dimensiones, duración, fotogramas por segundo, códec y flujo de audio. Extraer al menos el primer fotograma, un fotograma intermedio de cada grupo de escenas y el último fotograma; comprobar que el texto no esté cortado, que la animación tenga una pausa para leer, que la voz termine la frase completa y que la música no tape la letra.
10. Entregar. Enviar primero el archivo MP4 completo. Si se ha creado un código fuente reutilizable, enviar también el script fuente. Indicar la resolución, relación de aspecto, duración, fotogramas por segundo, idioma de la voz en off y estado del audio.

Valores creativos por defecto

• Estilo: fondo azul marino/gris oscuro, cuadrícula sutil, acentos cian/azul/naranja, tipografía en negrita, movimiento limpio y con propósito.
• Estructura para redes sociales: hook en los primeros 1-2 segundos; luego cifras o proceso; cierre con conclusión y fuente.
• Cada escena tiene entrada, pausa de lectura y salida/transición. No permitir que múltiples animaciones sin relación ocurran simultáneamente.
• Priorizar inglés si la fuente está en inglés; mantener términos técnicos como DR, dofollow, SaaS cuando sea necesario.
• No inventar logotipos, marcas, cifras o citas. Si se necesita un asset de marca exacto, solicitarlo o usar los assets proporcionados.

Ejemplo de storyboard

Escena 1 — Hook (0:00–0:05)
Visual: número grande y flecha de conversión.
Texto en pantalla: "463 probados → 22 dignos de enviar"
VO: una frase corta que plantee la contradicción principal.

Escena 2 — Método (0:05–0:12)
Visual: embudo/contadores.
Texto en pantalla: hitos de entrada y después de deduplicación.
VO: explicar cómo se creó la lista.

Escena 3 — Filtro (0:12–0:22)
Visual: gráfico de barras o tarjetas para los grupos descartados.
VO: mencionar solo los grupos más importantes.

Final — Conclusión (final del video)
Visual: frase final grande, cita de fuente pequeña debajo.
VO: conclusión y acción recomendada.

Recursos incluidos

• Usar templates/storyboard_prompt_template.md para generar un storyboard y un prompt estandarizado en inglés para herramientas de IA de imagen/video. La plantilla requiere código de tiempo, texto exacto en pantalla, voz en off, movimiento, continuidad y control de calidad.
• Consultar examples/saas-demand-generation-flywheel.md como referencia de un storyboard/prompt completo basado en un caso de estudio SaaS con cifras, advertencias y citas.
• Usar scripts/mix_video_audio.sh para hacer loop/cortar música, bajar su volumen, mezclarla con la narración y verificar la salida. Ejecutar bash scripts/mix_video_audio.sh --help antes de usarlo.