Communitygithub.com

MotionCraft

Construye videos animados tipo explainer y Shorts cinematográficos basados en código (9:16 Shorts y 16:9 Video, duración de 15 segundos a 10 minutos) en 16 categorías visuales de nivel estudio: 3D, Isométrico, Despiece de Casa, Stickman 3D, Astronomía (GLSL Black Hole), Mundo Animal, Océano 3D, Ciencia y Naturaleza, Historia, Mapas (Natural Earth d3-geo), Islámico, Geografía, Anatomía, Folclore, Dibujos Animados y Animación 2D. Genera recomendaciones visuales, guión por escenas (Hook -> Escena 1..N), archivo HTML independiente que se reproduce directamente en el navegador, paquete ZIP del código fuente y renderizado de video MP4 determinista. Usa esta skill cada vez que el usuario solicite un video animado, Short educativo, explainer, simulación 3D, mapa histórico/geográfico, stickman 3D, anatomía o storyboard de video.

¿Qué es MotionCraft?

MotionCraft es una skill universal para agentes de IA (como Claude Code, Cursor, Codex) que transforma una simple frase con una idea de historia en un video animado completo, listo para usar. Soporta 16 categorías visuales de alta calidad, que incluyen 3D, isométrico, astronomía, mapas, anatomía y más, todas con un nivel de detalle comparable al de un estudio profesional. La skill produce un guión estructurado (Hook + Escenas), un archivo HTML autónomo que se reproduce al instante en cualquier navegador (con cambio de relación de aspecto y efectos de sonido), un archivo ZIP con todo el código fuente y, opcionalmente, un video MP4 renderizado. Su arquitectura determinista garantiza que no haya elementos aleatorios, lo que permite resultados predecibles y reproducibles. Esta skill es ideal para creadores de contenido educativo, desarrolladores que buscan automatizar la producción de videos y cualquier persona que necesite un video animado profesional sin depender de software de edición complejo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

Preguntar en tu IA favorita

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

Documentación

MotionCraft — Skill Universal para Videos Explainer y Shorts (16 Categorías)

Skill independiente (sin dependencia de aplicaciones) que convierte una frase con una idea en recomendaciones visuales, guión por escenas (HOOK → ESCENA 1 → ESCENA 2 → hasta 10 minutos), archivo independiente <slug>.html (haz doble clic y se reproduce en el navegador, con botón para cambiar relación 9:16 ↔ 16:9 y WebAudio SFX), paquete de código fuente <slug>-source.zip y renderizado de video .mp4.


Flujo de Trabajo Obligatorio (5 Pasos)

Paso 1 — Recomendación Visual y Plan de Guión (HOOK → ESCENA 1..N)

Cuando el usuario proporcione una idea (si no se especifica la relación o duración, usa por defecto 9:16 Shorts 30–45 s para datos breves, o 16:9 Video 60–600 s para temas más profundos):

  1. Elige 1 categoría de las 16 Categorías Oficiales: 3D · Isométrico · Despiece de Casa · Stickman 3D · Astronomía · Mundo Animal · Océano · Ciencia y Naturaleza · Historia · Mapas · Islámico · Geografía · Anatomía · Folclore · Dibujos Animados · Animación 2D.
  2. Formula una recomendación visual específica:
    • Objetos y accesorios (objetos): sujeto principal texturizado/articulado + al menos 3 accesorios para comparación de escala/evidencia.
    • Cámara y transiciones (cámara): patrón multi-toma (general → primer plano detalle → órbita / whipTo / alejamiento).
    • Ambiente e iluminación (ambiente): atmósfera de cielo/espacio, niebla/luz volumétrica, paleta de colores y tono narrativo.
  3. Redacta el guión por escenas (0 a DUR segundos sin espacios vacíos):
    • La primera parte DEBE ser un HOOK (3–10 segundos de apertura que despierte curiosidad).
    • Continúa con ESCENA 1, ESCENA 2, etc., y finaliza con una conclusión factual sólida (~2,2 palabras/segundo).
    • Para duraciones largas (> 60 s hasta 600 s / 10 min), consulta Guía de Duración Larga de 10 Minutos.

Paso 2 — Lee la Receta de Categoría y el Código de Ejemplo de Oro (¡OBLIGATORIO!)

NO escribas sceneCode basado en suposiciones vacías. Antes de escribir código de animación:

  1. Lee la tabla de categorías e ID de style en Catálogo de 16 Categorías y la lista de funciones de tiempo de ejecución en Referencia de API del Motor v4 (MF).
  2. Lee el código de ejemplo oficial más cercano en Código de Ejemplo de Oro.
  3. Ley de Igualdad de Calidad: La densidad de objetos, el detalle de texturas (CanvasTexture / SVG en capas / líneas costeras world-atlas / shader GLSL), la iluminación y la suavidad de la cámara DEBEN SER IGUALES a los ejemplos en golden-showcases.md. ¡Prohibido dibujar cuadrados/círculos lisos sin texturas o accesorios!

Paso 3 — Reglas de Oro para Escribir sceneCode

sceneCode se ejecuta como el contenido de la función (MF, stage, tl, W, H, DUR):

  • Doble Responsividad (9:16 Shorts y 16:9 Video): Usa siempre proporciones W y H (W * 0.5, H * 0.45, size: W < H ? 50 : 56, labelX: W < H ? W * 0.08 : W * 0.54) para que la animación se muestre completa sin recortarse en 1080×1920 ni en 1920×1080.
  • No Sobrescribas la Variable H: Nunca escribas const { H } = MF; porque sobrescribiría la altura del escenario H. Siempre usa el prefijo MF. (MF.H, MF.S, MF.T).
  • 100% Determinista: Prohibido usar Math.random(), Date.now(), setTimeout o setInterval. Usa MF.rng('seed-fijo'), interpolaciones en tl y MF.onTick((t) => ...) como función pura del tiempo t.
  • Frame 0 Vivo Directamente: Los elementos del escenario y el título de apertura HOOK deben usar at: 0 para que el primer frame no esté vacío/oscuro.
  • Anti-PPT: Máximo 1 titular (MF.highlightHeadline) + 1 llamada/número (MF.leaderCallout / MF.bigStat) a la vez. La historia debe ser transmitida por cambios en la acción del mundo/objetos y movimientos de cámara, ¡no por una sucesión de tarjetas de texto!

Paso 4 — Ensambla el Archivo Independiente (.html, -source.zip, -guion.md)

Crea un archivo de especificaciones JSON (ej. spec.json):

{
  "title": "Título del Video",
  "idea": "Idea original del usuario",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objetos": "...",
    "cámara": "...",
    "ambiente": "..."
  },
  "scenes": [
    { "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
    { "label": "ESCENA 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}

Luego ejecuta el script de construcción independiente (Node.js nativo, ¡0 dependencias npm!):

node "<ruta-hacia-la-skill>/scripts/build.mjs" --spec ruta/a/spec.json --out-dir ruta/destino

Este script valida la sintaxis y el determinismo de sceneCode, incrusta ./assets/motion-engine.js, ./assets/sfx-synth.mjs y ./assets/land-110m.json (si se usan mapas), y genera:

  1. <slug>.html — 1 archivo independiente listo para ver en cualquier navegador (auto-loop + barra de desplazamiento + botón para cambiar 9:16 ↔ 16:9 + WebAudio SFX).
  2. <slug>-source.zip — archivo completo del código fuente (index.html, src/scene.js, src/project.json, GUION-Y-STORYBOARD.md, engine/).
  3. <slug>-guion.md — documento de guión y recomendaciones visuales bien formateado.

Alternativa sin Terminal / Chat Web: Si el entorno del agente no tiene acceso a la terminal de Node.js, copia el contenido de ./assets/starter-template.html, reemplaza los marcadores de posición /*__MOTION_ENGINE__*/, /*__SFX_SYNTH__*/ y /*__PROJECT_JSON__*/ null directamente para generar el archivo index.html completo.

Paso 5 — Verificación de Fotogramas y Exportación de Video MP4 (Opcional / Si hay Navegador Headless)

Si el entorno tiene Chrome/Edge + puppeteer-core (o puppeteer), ejecuta la verificación automática para asegurar 0 errores en tiempo de ejecución y comprobar las capturas de pantalla:

# Verificación rápida (comprueba 0 errores + guarda captura de HOOK y punto medio):
node "<ruta-hacia-la-skill>/scripts/export-mp4.mjs" --html ruta/destino/<slug>.html --verify-only

# Renderizado completo a video MP4 (H.264 + AAC SFX automático, opcional + --vo narracion.mp3):
node "<ruta-hacia-la-skill>/scripts/export-mp4.mjs" --html ruta/destino/<slug>.html --fps 30 --scale 1

Si se encuentran errores o texto superpuesto en las capturas de verificación, corrige sceneCode, reconstruye con scripts/build.mjs y entrega el resultado al usuario.

Skills relacionados