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):
- 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. - 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 planodetalle →órbita/whipTo/alejamiento). - Ambiente e iluminación (
ambiente): atmósfera de cielo/espacio, niebla/luz volumétrica, paleta de colores y tono narrativo.
- Objetos y accesorios (
- Redacta el guión por escenas (
0aDURsegundos 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
600s / 10 min), consulta Guía de Duración Larga de 10 Minutos.
- La primera parte DEBE ser un
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:
- Lee la tabla de categorías e ID de
styleen Catálogo de 16 Categorías y la lista de funciones de tiempo de ejecución en Referencia de API del Motor v4 (MF). - Lee el código de ejemplo oficial más cercano en Código de Ejemplo de Oro.
- Ley de Igualdad de Calidad: La densidad de objetos, el detalle de texturas (
CanvasTexture/ SVG en capas / líneas costerasworld-atlas/ shader GLSL), la iluminación y la suavidad de la cámara DEBEN SER IGUALES a los ejemplos engolden-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:16Shorts y16:9Video): Usa siempre proporcionesWyH(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 en1080×1920ni en1920×1080. - No Sobrescribas la Variable
H: Nunca escribasconst { H } = MF;porque sobrescribiría la altura del escenarioH. Siempre usa el prefijoMF.(MF.H,MF.S,MF.T). - 100% Determinista: Prohibido usar
Math.random(),Date.now(),setTimeoutosetInterval. UsaMF.rng('seed-fijo'), interpolaciones entlyMF.onTick((t) => ...)como función pura del tiempot. - Frame 0 Vivo Directamente: Los elementos del escenario y el título de apertura
HOOKdeben usarat: 0para 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:
<slug>.html— 1 archivo independiente listo para ver en cualquier navegador (auto-loop + barra de desplazamiento + botón para cambiar9:16↔16:9+ WebAudio SFX).<slug>-source.zip— archivo completo del código fuente (index.html,src/scene.js,src/project.json,GUION-Y-STORYBOARD.md,engine/).<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__*/ nulldirectamente para generar el archivoindex.htmlcompleto.
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.