Communitygithub.com

explainer-video

Crea videos explicativos técnicos de 2 a 3 minutos en formato vertical (9:16) para espectadores no técnicos, presentados por el personaje arquitecto caricaturesco "Hellboy", al estilo de los videos de referencia.

¿Qué es explainer-video?

Esta habilidad permite generar videos explicativos técnicos completos a partir de un solo tema. Está diseñada para desarrolladores y creadores de contenido que quieran producir videos cortos y atractivos para audiencias no técnicas, sin necesidad de edición manual. Soporta flujos de trabajo automatizados en entornos de línea de comandos (Python) y plataformas como Claude Code, Cursor o Codex. El proceso se basa en la redacción de un guion (7 latidos) y un storyboard estructurado en JSON, que luego son validados, previsualizados y renderizados mediante un motor interno. El resultado es un video MP4 de 1080×1920 con locución fija, animaciones sincronizadas y el personaje "Hellboy" en estilo de caricatura. La habilidad incluye guías detalladas para mantener la consistencia visual (biblias de estilo, plantillas) y un modo para modelos pequeños que permite generar escenas una por una.

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

Preguntar en tu IA favorita

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

Documentación

Habilidad de Video Explicativo (Hellboy)

Conviertes un tema técnico en un MP4 terminado de 2 a 3 minutos a 1080×1920 que una persona no técnica entiende a la primera. El estilo visual, el ritmo y la estructura del guion están clonados de un canal de referencia (analizado en docs/01-style-bible.md). Dos cosas son deliberadamente nuestras: el personaje (Hellboy) y la voz.

Solo escribes archivos de texto (un guion y un storyboard.json). El motor en engine/ se encarga de la voz, los subtítulos, la animación, el personaje, la música y la renderización.


Cuando el usuario solo da un tema

Haz todo el trabajo sin hacer más preguntas:

  1. Crea un slug a partir del tema (como-funciona-dns) y ejecuta python engine/make_video.py new videos/<slug>.
  2. Escribe videos/<slug>/script.md (docs/02), luego videos/<slug>/storyboard.json (docs/03 + docs/04). Copia patrones de examples/upi-explained/.
  3. Ejecuta python engine/validate_storyboard.py videos/<slug>. Corrige cada ERROR y repite hasta que imprima 0 error(s).
  4. Ejecuta python engine/make_video.py preview videos/<slug>. Si puedes ver imágenes, revisa build/preview.png contra docs/06 sección B y corrige.
  5. Ejecuta python engine/make_video.py render videos/<slug>. Responde con la ruta output/<slug>.mp4, la duración y un resumen de 2 líneas.

Los puntos no negociables

  1. Hellboy nunca se redibuja. Proviene únicamente de character/hellboy/hellboy.js. Solo puedes establecer show, arm (down/point/explain) y expression, nada más. Lee character/hellboy/CHARACTER_BIBLE.md una vez.
  2. La voz es fija en engine/config.json. No la cambies por video.
  3. Duración: 360–470 palabras de narración, 2:00–2:50. Oraciones ≤ 20 palabras.
  4. Cada oración cambia algo en pantalla. Los elementos aparecen en su palabra clave hablada ("at").
  5. Correcto supera a simple. Simplifica omitiendo cosas, nunca diciendo algo falso.
  6. El validador debe pasar (0 errores) antes de renderizar.

Flujo de trabajo (hazlos en orden)

#PasoLeeSalida
1Andamio–python engine/make_video.py new videos/<slug>
2Planifica + escribe el guiondocs/02-script-writing.mdvideos/<slug>/script.md (360–470 palabras, 7 latidos)
3Planifica los visualesdocs/03-visual-planning.mdlista de escenas: narración → tipo, titular, personaje
4Escribe el storyboarddocs/04-storyboard-reference.mdvideos/<slug>/storyboard.json (o meta.json + scenes.jsonl → assemble)
5Valida–python engine/validate_storyboard.py videos/<slug> → corrige hasta 0 errores
6Vista previa + QAdocs/06-qa-checklist.mdmake_video.py preview videos/<slug> → inspecciona build/preview.png, corrige
7Renderizadocs/05-production.mdmake_video.py render videos/<slug> → output/<slug>.mp4
8QA finaldocs/06-qa-checklist.mdpuntuación ≥ 85, todos los elementos OBLIGATORIOS pasan

¿Modelo pequeño/local? Sigue docs/07-small-model-playbook.md en lugar de los pasos 2–5. Divide el trabajo en instrucciones de una escena a la vez.

El guion de 7 latidos (memoriza)

Enganche (≤ 22 palabras: "X explicado." / "¿Cómo funciona realmente X?" / afirmación sorprendente / acción relatable) → Tensión (el misterio) → Hoja de ruta ("Sigamos…") → Cuerpo (3–6 capítulos: concepto → significado simple → ejemplo cotidiano → consecuencia; UN ejemplo continuo con una persona nombrada) → Giro ("Pero aquí está la parte interesante…") → Resumen ("Así que recuérdalo así." una línea por capítulo) → Remate (fragmentos que repiten el enganche: "Un escaneo. Cuatro jugadores. Dos segundos.").

Receta de escena (memoriza)

  • 1 escena = 1–3 oraciones (8–28 palabras, 3–8 s); 20–32 escenas por video.
  • Elige visual.type de la tabla de decisión en docs/03-visual-planning.md. Usa 7–12 tipos diferentes por video.
  • Muestra a Hellboy en el 40–70 % de las escenas (siempre: primera escena, giro, resumen, última escena). Ocúltalo para sequence, hub, diagram, compare.
  • Construye diagramas grandes en 2–4 escenas con elementos "continue": true + "shown": true y el mismo titular.
  • Titulares de 2–6 palabras con una palabra de acento. Etiquetas en pantalla de 1–4 palabras.

Comandos (desde la raíz del repositorio)

# activa primero:  source .venv/bin/activate   |   Windows: .\.venv\Scripts\Activate.ps1
python engine/make_video.py new       videos/<slug>   # plantillas
python engine/make_video.py assemble  videos/<slug>   # meta.json + scenes.jsonl -> storyboard.json
python engine/validate_storyboard.py  videos/<slug>   # debe ser 0 errores
python engine/make_video.py preview   videos/<slug>   # build/preview.png (1 fotograma por escena)
python engine/make_video.py render    videos/<slug> [--fast]

Primera vez en una máquina: ./setup.sh (Linux/macOS) o setup.ps1 (Windows). Los videos terminados se guardan en output/<slug>.mp4.

Material de referencia

  • examples/upi-explained/ (papel cálido) y examples/load-balancer-explained/ (plano) — ejemplos completos ya resueltos. Copia sus patrones.
  • templates/ — script.template.md, storyboard.template.json.
  • docs/01-style-bible.md — lo que hace la referencia, medido (por qué existen las reglas).
  • engine/icon_names.txt — todos los 2359 nombres de iconos permitidos (Lucide).

Skills relacionados