Communitygithub.com

C4KEBX/motionexplainers

Úsalo cuando el usuario pida crear, guionizar o producir un video explicativo animado vertical de 60 segundos sobre finanzas, inversiones o historia en este repositorio ("haz un video sobre X", "/make-explainer <tema>"). Realiza investigación, datos verificados, un storyboard validado, una revisión humana y el render final narrado.

¿Qué es motionexplainers?

Este skill convierte un tema en un video explicativo animado de 60 segundos (1080 × 1920) completamente producido, utilizando un pipeline reproducible basado en Node.js. Está diseñado para repositorios que contienen herramientas de generación de video, validadores de datos y síntesis de voz (Edget TTS). El proceso consta de siete pasos: definición del briefing, investigación con WebSearch y WebFetch, verificación de datos con `npm run verify-facts`, creación del guion y storyboard según esquemas JSON, revisión de coherencia con `npm run check`, una puerta de revisión humana (el usuario debe aprobar una hoja de revisión HTML antes de continuar) y finalmente la producción con `npm run produce`. El skill impone reglas estrictas: cada cifra debe provenir de una fuente abierta, está prohibido inventar o recordar datos de memoria, y el usuario debe aprobar explícitamente antes de renderizar el video final. Está pensado para creadores de contenido educativo, documentalistas o desarrolladores que deseen automatizar la creación de videos explicativos cortos sin costo de API, confiando en la precisión de las fuentes y la revisión humana.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/C4KEBX/motionexplainers/tree/HEAD/.claude/skills/make-explainer

Preguntar en tu IA favorita

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

Documentación

Haz un video explicativo de 60 segundos

Convierte un tema en un video terminado de 1080 × 1920 con el pipeline de este repositorio. No cuesta nada: tú haces la investigación, la escritura y las reparaciones; los scripts verifican y renderizan. Trabaja desde la raíz del repositorio. Lee .claude/skills/make-explainer/rules.md antes de escribir un storyboard.

Reglas estrictas

  • Cada número, fecha, nombre y cita que aparezca en pantalla proviene de un hecho en facts.json cuya fuente realmente abriste con WebFetch. Nunca escribas una cifra de memoria. Si no puedes respaldar una afirmación, elimínala. La narración solo dice lo que una página que abriste indica; no añadas afirmaciones de fondo que no hayas leído.
  • Nunca edites src/, tests/, los validadores ni este skill para que un storyboard pase la validación. Arregla el storyboard o los hechos. Nunca cambies los datos de un hecho para que coincidan con un storyboard, o viceversa, sin volver a leer la fuente.
  • DETENTE en la puerta de revisión (paso 6). No ejecutes npm run produce hasta que el usuario apruebe la hoja de revisión.
  • Finanzas e inversiones son educativas e históricas: sin consejos, sin predicciones, sin "deberías". Indica el período y la fuente de cada cifra.

Flujo de trabajo

Todo lo de un video vive en videos/<slug>/ (letras minúsculas, dígitos, guiones): facts.json, storyboard.json, review/.

  1. Brief. Acuerda el tema, una oración que el video demuestre, y la audiencia. Haz solo una pregunta si la afirmación no es clara. Voz por defecto en-US-AndrewNeural, música null.
  2. Investigación. WebSearch, luego WebFetch fuentes primarias (BLS, Reserva Federal, SEC, informes de empresas; Wikipedia o páginas de museos y bibliotecas para fechas históricas). Copia los números de la página. Escribe de 5 a 8 hechos: id, claim (una oración completa con unidades y período, tal como lo dice la fuente), value para un número o dataset para los datos exactos que mostrará un gráfico o lista, y source con nombre y url. Nunca dejes redacción de "datos demo" en una afirmación.
  3. Verificar. npm run verify-facts -- --facts videos/<slug>/facts.json --out videos/<slug>/verify.json. Por cada not-found, partial o unreachable: vuelve a abrir la fuente, corrige o elimina el hecho. La herramienta es orientativa; tú eres responsable de la precisión. Un número entero pequeño (8, 9, 27) aparece en casi cualquier página, así que supported dice poco sobre él: lee tú mismo la línea de la fuente. Después de editar facts.json por cualquier motivo, ejecuta verify-facts nuevamente; la hoja de revisión marca un resultado desactualizado.
  4. Guion y storyboard. Aproximadamente 155 palabras de narración en total (55 a 60 segundos), de 6 a 10 escenas, un gancho en la escena 1, una idea por escena, tipos de escena variados (nunca tres iguales consecutivos). Usa storyboard.schema.json para conocer los campos exactos y límites, y copia la forma de fixtures/finance.storyboard.json, fixtures/history.storyboard.json y fixtures/ancient.storyboard.json. Escribe videos/<slug>/storyboard.json.
  5. Revisar y reparar. npm run check -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json. Corrige cada problema (cada mensaje nombra la escena y la solución) y vuelve a ejecutar, como máximo 6 rondas; si algo aún bloquea, informa exactamente qué. Trata las advertencias (longitud, redacción de consejos, texto no rastreado) como cosas que debes corregir o justificar. La estimación de longitud es buena dentro de aproximadamente el 10% (las palabras reales por segundo oscilaron entre 2.5 y 3.2), así que apunta a 55–60 s; produce es la autoridad y una longitud rechazada solo significa ajustar la narración y volver a ejecutar.
  6. Puerta de revisión. npm run sheet -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --verify videos/<slug>/verify.json --out videos/<slug>/review. Dile al usuario que abra videos/<slug>/review/review.html. Resume: la afirmación, lista de escenas, recuento de palabras y duración estimada, cada hecho con su verificación de fuente, y cada advertencia. Pide aprobación o ediciones. DETENTE y espera.
  7. Producir. Después de la aprobación: npm run produce -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --out out/<slug>. Tarda unos dos minutos. Si rechaza la duración o una escena es demasiado corta, cambia la narración, vuelve a ejecutar check, produce de nuevo (el audio de voz se almacena en caché por texto). Informa la ruta del archivo, duración y volumen. Di claramente lo que no has juzgado: calidad de voz, pronunciación, ritmo y gusto. Pide al usuario que lo vea.

Cuando algo sale mal

  • Un mensaje de verificación que no entiendes: nombra un id de escena; abre esa escena en rules.md para conocer sus límites. No adivines la solución.
  • El hecho y la escena no coinciden: vuelve a abrir la fuente. Corrige el que esté mal según la fuente, nunca copiando uno sobre el otro.
  • No se encuentra una región del mapa: usa la ortografía del atlas que sugiere el mensaje ("Estados Unidos de América"); las regiones deben superponerse al cuadro de focus.
  • Problemas de voz (red): npm run produce necesita internet para Edge TTS; --voice standin proporciona un audio de marcador de posición casi silencioso solo para una ejecución de prueba.
  • Configuración faltante: ejecuta npm install y npm run setup:tts una vez.

Salida para el usuario

Mantén la brevedad: la ruta del archivo, lo que afirma el video, duración, volumen, los hechos y fuentes utilizados, y cualquier advertencia que hayas aceptado y por qué.

Skills relacionados