Communitygithub.com

MrRoam/explicador-video-skill

Crea videos explicativos en chino, videos de divulgación científica, animaciones de principios o videos estilo 3Blue1Brown. Usa Codex para escribir guiones y storyboards, reutilizando Manim local, Kokoro para doblaje y FFmpeg para exportar MP4 y subtítulos. Ideal para 'hacer un video explicando X'; no se activa para explicaciones solo de texto, imágenes estáticas o edición de video normal.

¿Qué es explicador-video-skill?

Esta habilidad (skill) permite a un agente de IA, como Codex, generar videos explicativos completos y personalizados en chino mandarín. Combina la capacidad de Codex para redactar guiones y generar código de animación con herramientas locales del usuario (Manim, Kokoro, FFmpeg) para la producción final. Es particularmente útil para crear contenido educativo, videos de divulgación científica o animaciones que explican conceptos complejos de manera visual e intuitiva, siguiendo el estilo pedagógico de 3Blue1Brown (fondo oscuro, colores de énfasis, transiciones suaves, relación entre gráficos y fórmulas). El flujo de trabajo comienza con la definición de un proyecto a través de un script, luego la edición simultánea de un archivo de lección (`lesson.json`) y el código de animación (`scene.py`). El agente se encarga de sincronizar la narración con los cambios visuales, y finalmente produce un video MP4 con subtítulos SRT, junto con el código fuente reutilizable. La habilidad está diseñada para ser eficiente, reutilizando el entorno local del usuario y evitando llamadas a APIs externas de voz o modelos de lenguaje adicionales para el doblaje, que se realiza localmente con Kokoro.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add MrRoam/explainer-video-skill

Preguntar en tu IA favorita

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

Documentación

Video Explicativo en Chino

Entrega videos personalizados listos para reproducir. Codex se encarga del contenido y el código de animación; las herramientas locales se encargan del doblaje, la renderización y la composición. Por defecto: chino, orientado a principiantes, duración aproximada de un minuto, resolución 720p, 30 fps; las solicitudes del usuario en la sesión actual tienen prioridad.

Por defecto, se adopta el método de razonamiento gráfico de 3Blue1Brown: fondo oscuro, pocos colores de énfasis con significado fijo, cambios gráficos continuos, zooms locales y transformaciones de correspondencia entre fórmulas y gráficos. Primero se construye la intuición, luego se presenta la fórmula. Se escribe un guion original y las imágenes correspondientes para el tema actual.

Herramientas Reutilizadas

La configuración local se encuentra en runtime.local.json en la raíz del skill, también se puede especificar mediante EXPLAINER_RUNTIME o --runtime. Primero verifica Python, FFmpeg, el modelo de doblaje y las fuentes chinas disponibles en la configuración. Si falta configuración, sigue README.md para configurar el entorno existente o instalar las dependencias faltantes. No configures servicios permanentes para pruebas ni reinstales entornos reutilizables.

En Windows, para la primera instalación, ejecuta scripts/setup.ps1. Este script instala automáticamente las dependencias de CPU necesarias, descarga el modelo de chino y guarda la configuración local. Si ya hay una configuración válida, solo verifica las rutas; el script no instala Python, TeX ni CUDA. Si las herramientas existentes están en otros directorios, pasa las rutas del entorno y del modelo correspondientes para reutilizarlas.

python "SKILL_DIR\scripts\init_project.py" --workspace "WORKSPACE" --name concept-video

SKILL_DIR es el directorio actual del skill, WORKSPACE es la ruta absoluta del espacio de trabajo actual. El script solo copia plantillas pequeñas, no descarga dependencias. El código fuente está en outputs/concept-video-project, el caché en work/explainer/concept-video. Usa diferentes name para múltiples videos; si las herramientas se mueven, reconfigura las rutas.

Escritura y Producción

Modifica simultáneamente lesson.json y scene.py en el proyecto. La plantilla es un ejemplo de derivada; solo cambiar el título no lo convierte en un tema nuevo. Los campos, la sincronización de storyboard y los comandos de ejecución se detallan en references/pipeline.md.

Elige un problema específico, ve del ejemplo al principio. Cada segmento de narración debe corresponder a un cambio observable, como el movimiento de un punto, el cambio de una curva, la actualización de una variable o la aparición gradual de una relación. Las conclusiones matemáticas deben indicar claramente las condiciones de validez. Los subtítulos, las fórmulas y los números deben ser coherentes con el guion. Las fuentes se toman de la configuración local; MathTex en la plantilla requiere TeX. Si falta TeX, se puede usar Text y objetos geométricos en su lugar.

Por defecto, se usa la versión china de Kokoro local, CPU y timbres ya descargados, sin necesidad de modelos grandes adicionales ni API de voz. Los símbolos matemáticos, LaTeX y términos en inglés en la narración deben reescribirse en la pronunciación china. Primero haz una prueba corta de audio, luego genera el video completo; no descargues todos los timbres automáticamente ni cambies el backend de doblaje sin previo aviso. Otros formatos de audio se pueden integrar según references/pipeline.md.

Revisión y Entrega

Primero genera una vista previa de baja resolución, verifica el chino, las fórmulas, las superposiciones y los bordes, luego exporta el video final. Verifica que la narración no esté en silencio, que cada segmento esté completo y que el final no se corte. El script de renderizado verifica el tamaño y la sincronización de tiempo, pero la calidad visual y de audio aún debe verificarse manualmente.

Entrega MP4, SRT, el guion en chino y el código fuente reutilizable. Coloca los archivos de entrega en el directorio outputs del espacio de trabajo y los archivos intermedios en work. Indica el backend de doblaje real utilizado y las limitaciones no resueltas; no describas el éxito del script como si el usuario ya estuviera satisfecho con la calidad del audio.

Skills relacionados