Video explicativo
Un video explicativo terminado es un MP4 cuyas imágenes se mueven al compás de las palabras: cada animación comienza cuando el narrador alcanza la frase que ilustra, y los subtítulos se sincronizan a partir de las marcas de tiempo de la propia voz. El trabajo es un proceso en una carpeta de proyecto: narration.py (el guion), scenes.py (escenas de Manim), video.json (título, voz), screens/ (capturas de pantalla) y kit/ (el kit incluido, que se ejecuta como python -m kit <comando> desde la raíz del proyecto).
Cada corte (una nueva versión, una edición acortada, una nueva voz) es una nueva carpeta de proyecto creada con scripts/new_project.py DEST --from OLD. Los cortes anteriores se mantienen reproducibles e intactos; las oraciones sintetizadas se almacenan en caché por contenido fuera del proyecto, por lo que un corte solo paga por las oraciones que cambiaron.
La clave proviene de ELEVENLABS_API_KEY en el entorno. Ejecuta los comandos de voz a través del gestor de secretos que tenga el usuario (op run --, av inject +ELEVENLABS_API_KEY --, un simple export); nunca imprimas, registres ni escribas la clave.
Pasos
1. Hoja de hechos
Recopila lo que el video pueda afirmar, a partir del resumen del usuario, sus repositorios y configuraciones, y preguntas hacia él. Escribe cada afirmación como verificada (vista en la configuración, una pantalla o las palabras del usuario) o ilustrativa (un marcador de posición, un ejemplo, un diseño conceptual). Define la audiencia, la duración objetivo y lo que debe eliminarse.
Listo cuando cada afirmación en pantalla o hablada que planees hacer se remonte a una línea verificada, y las ilustrativas estén enumeradas para las notas del resultado. Lee references/script.md para conocer las afirmaciones que más a menudo salen mal.
2. Proyecto
python3 <skill>/scripts/new_project.py DEST para un nuevo video, o --from OLD para un nuevo corte. Instala template/requirements.txt en un venv (Manim necesita Cairo, Pango y ffmpeg en el sistema). Establece name, title y voice en video.json.
Listo cuando python -m kit draft && python -m kit build --low compile el ejemplo incluido (o el corte copiado) en out/.
3. Guion
Escribe narration.py: escenas en orden de reproducción, cada una es una lista de segmentos (id, caption, spoken), de una a tres oraciones cada uno. Presupuesta alrededor de 150 palabras habladas por minuto de video; deja que el audio real decida la longitud final en lugar de acelerar la voz. Coloca las pronunciaciones de los nombres en pronunciations.json.
Muestra al usuario el guion como una tabla (escena, narración, qué hay en pantalla) y haz las preguntas que solo ellos pueden responder. Listo cuando el usuario haya aprobado el texto: la síntesis cuesta créditos, las ediciones del guion antes de ella son gratuitas.
4. Animar con audio de borrador
python -m kit draft crea una narración de marcador de posición gratuita con tiempos de caracteres uniformes, para que puedas diseñar las escenas antes de pagar por la voz. Escribe una clase Narrated (diagramas) o ScreenScene (capturas de pantalla) por escena en scenes.py, impulsando cada cambio con say / until / done. Itera con python -m kit build --low y revisa los fotogramas.
Listo cuando cada segmento tenga una imagen que cambie con sus palabras, python -m kit timing no informe espacios en silencio, y ningún fotograma en la vista previa de baja resolución tenga texto superpuesto o un escenario vacío. Lee references/animation.md antes de escribir escenas; lee references/screens.md antes de capturar cualquier aplicación en vivo.
5. Voz
Si no se ha elegido una voz, haz una audición: python -m kit voices, luego python -m kit audition ID1 ID2 ID3 en una oración llena de los nombres difíciles, y deja que el usuario elija de oído. Luego python -m kit narrate --dry-run para ver el costo en caracteres, y python -m kit narrate.
Listo cuando narrate informe 0 segmentos restantes por sintetizar. Lee references/narration.md para conocer las configuraciones de voz, voces clonadas, créditos y permisos de clave.
6. Compilar y verificar
python -m kit build (resolución completa), luego python -m kit verify --speech. Revisa la hoja de contactos en out/ y los fotogramas de resolución completa de cada escena, y corrige lo que encuentres. Una nueva voz cambia el ritmo, por lo que un cambio de voz siempre implica una nueva renderización completa, nunca un reemplazo de banda sonora.
Listo cuando cada verificación en references/verify.md pase o su excepción esté explicada.
7. Entregar
Informa las rutas absolutas del MP4, SRT, guion y hoja de contactos; duración; voz y modelo; los números de verificación; la lista ilustrativa o no verificada del paso 1; y los comandos de recompilación. Nunca llames narración terminada al audio de borrador: assemble rechaza una compilación final mientras cualquier segmento siga siendo un borrador.