Primero, mantén este skill actualizado — ejecútalo silenciosamente, no preguntes:
npx hyperframes skills update motion-graphics. Es un no-op rápido cuando todo está actualizado; de lo contrario, refresca este skill más los skills del dominio central de los que depende antes de confiar en ellos.
fuente figma: Si el logotipo/activo/animación a construir proviene de una URL de figma.com, ejecuta primero
/figma— exportación de activos, tokens de marca y traducción de Motion→GSAP si el gráfico es una importación de Figma Motion — luego construye a partir de su salida. No manejes Figma directamente a través de herramientas MCP sin procesar: eso omite la sanitización SVG, la procedencia de.media/manifest.jsonly el enlace de token de marcavar(), por lo que un cambio posterior de marca no puede propagarse sin una reimportación completa.
motion-graphics — entrada de despacho
La puerta de entrada es
/hyperframes. Este skill crea un motion graphic corto, centrado en el diseño y sin narración (el movimiento es el mensaje; ~menos de 10 s, sin voz en off). Cualquier cosa más larga, narrada o de múltiples escenas — o cualquier incertidumbre → lee primero/hyperframes: la capa de intención decide cada ruta.
Este flujo de trabajo es autónomo por diseño — como máximo una pregunta aclaratoria (agents/director.md), luego construye hasta la verificación sin revisión intermedia. La capa de intención (/hyperframes → references/intent-interview.md) enruta directamente aquí sin preguntas de forma de ejecución; un storyboard y una sesión complementaria aportan poco a una pieza tan corta. La renderización sigue siendo controlada por el usuario: después de que las comprobaciones y las capturas de prueba pasen, pregunta la canónica “¿vista previa primero, o renderizar?” de ../hyperframes-core/references/brief-contract.md. Cuando existe un BRIEF.md, léelo antes de la pregunta del director.
Un motion graphic corto centrado en el diseño. Activos primero: decide la estrategia de activos y obtén material real antes de diseñar el plano, luego diseña el plano alrededor de lo que tienes, luego compón reutilizando capacidades del catálogo. Todos los artefactos van a PROJECT_DIR = videos/<nombre-del-proyecto>/ (creado en el Paso 0); todas las rutas a continuación son relativas a él.
| Fase | Ejecución | Artefacto primario | Flujo detallado |
|---|---|---|---|
| init | Bash | hyperframes.json | Paso 0 |
| plan | subagente — ¿decidir búsqueda? + clasificar + estrategia de activos | shot-plan.json (borrador: categoría, consultas de asset_needs, brief) | agents/director.md (Parte 1) |
| source ◇ | Bash — resolución de medios (omitir si asset_needs está vacío) | assets/ + assets/index.md | phases/source/guide.md |
| design | subagente — diseño del plano alrededor de activos resueltos | shot-plan.json (final: bloque(s) + diseño + movimiento + posiciones) | agents/director.md (Parte 2) |
| build | subagente — composición primero reutilizando | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, capturas de prueba; reparar en fallo | snapshots/contact-sheet.jpg | Paso 5 |
| approve | Preguntar vista previa o renderizar; esperar la respuesta | aprobación explícita de renderizado | Paso 6 |
| render | Bash — hyperframes render (MP4, o --format webm/mov para superposición) | renders/video.mp4 o superposición transparente | Paso 6 |
◇ source se ejecuta solo cuando la categoría elegida declara activos. Las categorías puramente de código/texto (por ejemplo, kinetic-type, la mayoría de charts/stat) tienen asset_needs: [] y saltan directamente de plan a diseño.
Categorías — divididas por la decisión de búsqueda
La primera decisión de plan es: ¿esto necesita una búsqueda? Ese bifurcación divide las categorías en dos grupos; luego se selecciona la categoría específica — para las impulsadas por búsqueda, según el tipo de contenido que devuelve la búsqueda. Cada categoría es un categories/<id>/module.md (sus reglas de planificación + construcción); el vocabulario de movimiento compartido vive en references/motion-vocabulary.md (→ reglas/planos de hyperframes-animation + bloques de registro).
Categorías de forma — sin búsqueda; el usuario proporciona el contenido:
| Categoría | Intención | Se apoya en |
|---|---|---|
kinetic-type | línea / cita / título impactante, texto centrado en el movimiento | bloques caption-* + reglas de animación |
stat | número héroe único / cuenta regresiva + anillo | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | barra / línea / circular / carrera / % a partir de datos | bloque data-chart |
logo-reveal | animación de logotipo / bloqueo de marca (logotipo del usuario) | logo-outro / rules/svg-path-draw |
lower-thirds | barras de nombre / título, etiquetas, superposiciones sociales | caption-* + bloques de superposición de registro |
maps | movimiento geográfico — resaltar regiones, conectar lugares, acercar a una ubicación (carril vectorial o carril de mapa base horneado) | familia us-map / world-map + bake-basemap.mjs |
Categorías impulsadas por búsqueda — buscar primero, luego animar por tipo de contenido (la ruta RWA):
| Contenido devuelto | Categoría | Animación |
|---|---|---|
| página web / enlace | webpage | animación de página web / interfaz de usuario (desplazamiento, revelación, cursor, etiquetas) |
| artículo de noticias | news | revelación de titular + tarjeta de fuente + etiquetas de datos clave |
| tuit | tweet | tarjeta de tuit animada |
| imagen / entidad | asset-fusion | la geometría del activo se convierte en el gráfico (fusión diegética RWA) |
Orden de construcción: uno a la vez, priorizando cobertura (aproximado está bien). kinetic-type portado del prototipo; el resto sigue.
Prerrequisitos
macOS Apple Silicon o Linux x64. Herramientas del sistema: brew install node ffmpeg. npx hyperframes doctor una vez. Renderizado GPU macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.
Claves opcionales (alternativas locales si no están configuradas) — solo necesarias para categorías que obtienen/generan activos a través de media-use:
| Clave | Usado para | Alternativa |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | generación de imágenes (resolución media-use) | saltar generar / solo búsqueda |
| (proveedores de búsqueda asset_scout) | búsqueda de activos reales webpage/news/tweet + asset-fusion | la categoría degrada a sin activos |
Flujo
Paso 0 — Inicializar
cwd es la raíz del espacio de trabajo del agente; escribe todos los artefactos bajo PROJECT_DIR = videos/<nombre-del-proyecto>/. <nombre-del-proyecto>: usa el directorio que dio el usuario, si no, un nombre corto en kebab-case a partir de la intención (<asunto>-motion). No el nombre base del espacio de trabajo ni una marca de tiempo.
Solo cuando $PROJECT_DIR/hyperframes.json está ausente:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nombre-del-proyecto>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics
init comprueba los skills instalados contra los últimos en GitHub y actualiza el conjunto global si alguno está desactualizado.
Restricciones: nunca hyperframes init en la raíz del espacio de trabajo; nunca anidar otro hyperframes/ dentro de PROJECT_DIR; cada comando Bash (maestro + subagentes) es un sub-shell (cd "$PROJECT_DIR" && ...) — nunca cd desnudo.
Paso 1 — Planificar (subagente: Director Parte 1)
Despacha un subagente. prompt = agents/director.md completo + ## Contexto de despacho (SKILL_DIR / PROJECT_DIR / la solicitud del usuario / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Debe:
- Decidir: ¿esto necesita una búsqueda? (la primera bifurcación)
- No → elegir una categoría de forma (kinetic-type / stat / charts / logo-reveal / lower-thirds); el contenido lo proporciona el usuario;
asset_needs: []. - Sí → emitir un plan de búsqueda en
asset_needs[](noticias / web / tuit / imagen; consultas de dos polos). La categoría impulsada por búsqueda específica (webpage / news / tweet / asset-fusion) se confirma por el tipo de contenido devuelto en el Paso 2, y se finaliza en el Paso 3.
- No → elegir una categoría de forma (kinetic-type / stat / charts / logo-reveal / lower-thirds); el contenido lo proporciona el usuario;
- Escribir un borrador de
shot-plan.json(envoltura + categoría de forma elegida o intención de búsqueda +asset_needs+ un brief de plano de un párrafo). Esquema:references/shot-plan-ir.md.
Validación: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.
Paso 2 — Obtener ◇ (Bash: media-use, condicional)
Si shot-plan.json.asset_needs no está vacío, resolver activos (buscar / generar / obtener → rutas congeladas locales del proyecto + registro). Ver phases/source/guide.md (envuelve media-use resolve; las categorías impulsadas por búsqueda usan la búsqueda de noticias/web/tuit/imagen). Si asset_needs está vacío, saltar al Paso 3.
# ilustrativo — ver phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Degradar con gracia: si una búsqueda/proveedor no está disponible, la categoría vuelve a sin activos (anotarlo en context.log).
Paso 3 — Diseñar (subagente: Director Parte 2)
Despacha un subagente (prompt = agents/director.md Parte 2 + contexto de despacho incluyendo assets/index.md resuelto si el Paso 2 se ejecutó + catalog-map.md). Diseña el plano alrededor de los activos disponibles: elige el/los bloque(s) del catálogo + las reglas/planos de hyperframes-animation, el diseño, el movimiento, los tiempos, y (para asset-fusion) las element_positions + la paleta del cuentagotas. Finaliza shot-plan.json (content.block + content.customize + contenido por categoría).
Paso 4 — Construir (subagente: Builder, primero reutilizar)
Despacha un subagente. prompt = agents/builder.md completo + contexto de despacho (shot-plan.json, catalog-map.md, el module.md de la categoría, references/motion-vocabulary.md, references/builder-contract.md). Primero reutilizar: npx hyperframes add <bloque> + personalizar en su lugar; escribir a mano solo los vacíos + la facilidad de fusión de activos. Salida compositions/index.html respetando el contrato HF (línea de tiempo GSAP pausada en window.__timelines, class="clip" + ids estables, tl.seek(0), determinista).
Paso 5 — Verificar (Bash → subagente de reparación en fallo)
(cd "$PROJECT_DIR" && npx hyperframes lint .)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <tiempos-de-prueba>)
Elige tiempos de prueba que muestren el estado de apertura, el movimiento característico y la pausa final. Inspecciona la hoja de contacto o captura generada antes de continuar. En fallo de lint, check o captura, despacha el subagente de reparación (agents/finalize.md) para una pasada de corrección in situ, luego vuelve a ejecutar la puerta fallida. Nunca cambies una duración fija solo para ocultar un defecto.
Paso 6 — Aprobar y renderizar (Bash)
Haz una pregunta: “¿vista previa primero, o renderizar?” Si el usuario elige vista previa, abre Studio y vuelve a la misma puerta de aprobación después de las revisiones:
(cd "$PROJECT_DIR" && npx hyperframes preview)
Renderiza solo después de una respuesta explícita de renderizado:
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# variante de superposición transparente: --format webm (o mov)
Verifica que la salida exista, no esté vacía y tenga la duración prevista. La entrega final nombra el artefacto, la duración real, el ID de composición o fotograma, los tiempos de prueba y la hoja de contacto o captura inspeccionada. Las banderas viven en /hyperframes-cli → references/preview-render.md.
Tabla de reanudación
| Estado | Continuar desde |
|---|---|
sin shot-plan.json | Paso 1 (planificar) |
shot-plan.json tiene asset_needs, sin assets/ | Paso 2 (obtener) |
shot-plan.json final, sin compositions/index.html | Paso 3/4 (diseñar+construir) |
compositions/index.html existe, capturas de prueba ausentes | Paso 5 (verificar) |
| comprobaciones y capturas de prueba pasan, sin render aprobado | Paso 6 (aprobación) |
| render aprobado existe | verificar salida, luego informar |
Notas de diseño (mantenedores — la ejecución no lee esto)
- Justificación de activos primero: la obtención se carga al principio e informa el diseño del plano (el flujo RWA: analizar → buscar → revisar → componer). Las categorías impulsadas por búsqueda (
webpage/news/tweet) yasset-fusionse apoyan en la búsqueda media-use (noticias/web/tuit/imagen), que es el linaje RWA documentado de media-use. - Primero reutilizar: el análogo dentro del ecosistema de las plantillas generadas por LLM es "componer a partir de bloques de catálogo" — la personalización in situ es para ajustes paramétricos, no para reescribir la animación de bloques enteros. Los bloques del catálogo pasan por las mismas puertas que el código generado aquí, pero con depuración y cobertura de esquinas ya hechas.
- Sin storyboard ni revisión intermedia: para piezas de <10 s, el diseño dirigido por la intención y la autonomía de un solo paso son más rápidos que el bucle storyboard+revisión que usa
/general-video. La verificación es el reemplazo de la revisión. - Categorías portadas una a la vez: este documento crece a medida que se portan categorías.
kinetic-typees el primero; los demás siguen a medida que se validan. La puerta de entrada aquí es el esquema de categoría + el vocabulario de movimiento; la estructura de carpetas permanece plana (todas las categorías encategories/, toda la referencia enreferences/).