Instalación de plugins: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando esta habilidad se encuentre dentro de un plugin de HyperFrames. Las instalaciones independientes mantienen las instrucciones de actualización a continuación.
Primero, mantén esta habilidad actualizada — confirma con el usuario antes de ejecutar:
npx hyperframes skills update motion-graphics. Es una operación rápida sin cambios si todo está actualizado; de lo contrario, actualiza esta habilidad junto con las habilidades del dominio central de las que depende, antes de utilizarlas.
fuente figma: Si el logotipo/recurso/animación a construir proviene de una URL de figma.com, ejecuta
/figmaprimero — exportación de recursos, tokens de marca y traducción Motion→GSAP si el gráfico es una importación de Figma Motion — luego construye a partir de su salida. No manejes Figma directamente con herramientas MCP sin procesar: eso omite la sanitización SVG, la procedencia.media/manifest.jsonly la vinculaciónvar()de tokens de marca, por lo que un cambio posterior de marca no puede propagarse sin una reimportación completa.
motion-graphics — punto de entrada de envío
La puerta principal es
/hyperframes. Esta habilidad crea un gráfico animado breve, 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, con narración o de varias escenas — o cualquier incertidumbre → lee/hyperframesprimero: la capa de intención posee cada decisión de ruta.
Este flujo de trabajo es autónomo por diseño — como máximo una pregunta aclaratoria (agents/director.md), luego construir hasta la verificación sin revisión intermedia. La capa de intención (/hyperframes → references/intent-interview.md) enruta aquí directamente sin preguntas sobre la forma; un storyboard y una sesión complementaria añaden poco a una pieza tan corta. El renderizado sigue siendo controlado por el usuario: después de que las comprobaciones y las capturas de prueba pasen, abre la vista previa del Studio y haz la pregunta canónica "¿renderizar ahora o qué cambios?" de ../hyperframes/references/brief-contract.md. Cuando exista un BRIEF.md, léelo antes de la pregunta del director.
Un gráfico animado breve y centrado en el diseño. Primero los recursos: decide la estrategia de recursos y obtén material real antes de diseñar la toma, luego diseña la toma en torno a lo que tienes, y finalmente compón reutilizando capacidades del catálogo. Todos los artefactos van a PROJECT_DIR = videos/<project-name>/ (creado en el Paso 0); todas las rutas a continuación son relativas a él.
| Fase | Ejecución | Artefacto principal | Flujo detallado |
|---|---|---|---|
| init | Bash | hyperframes.json | Paso 0 |
| plan | subagente — ¿decidir búsqueda? + clasificar + estrategia de recursos | shot-plan.json (borrador: categoría, consultas 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 de la toma en torno a los recursos resueltos | shot-plan.json (final: bloque(s) + diseño + movimiento + posiciones) | agents/director.md (Parte 2) |
| build | subagente — composición priorizando la reutilización | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, capturas de prueba; reparar en caso de error | snapshots/contact-sheet.jpg | Paso 5 |
| approve | Abrir la vista previa; preguntar renderizar o cambios; esperar la respuesta | aprobación explícita del 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 recursos. Las categorías de solo código/texto (ej. kinetic-type, la mayoría de charts/stat) tienen asset_needs: [] y saltan directamente del plan al diseño.
Categorías — divididas por la decisión de búsqueda
La primera decisión de plan es: ¿esto necesita una búsqueda? Esa bifurcación divide las categorías en dos grupos; luego se elige la categoría específica — para las impulsadas por búsqueda, por el tipo de contenido que devuelve la búsqueda. Cada categoría es un categories/<id>/module.md (sus reglas de planificación y 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 contundente, texto con movimiento como protagonista | bloques caption-* + reglas de animación |
stat | número héroe único / contador + anillo | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | gráfico de barras / líneas / circular / de carrera / % a partir de datos | bloque data-chart |
logo-reveal | animación de logotipo / bloque de marca (logotipo del usuario) | logo-outro / rules/svg-path-draw |
lower-thirds | barras de nombre / título, llamadas, superposiciones para redes sociales | caption-* + bloques de superposición del 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 según el 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, llamadas) |
| artículo de noticias | news | revelación de titular + tarjeta de fuente + llamadas de datos clave |
| tuit | tweet | tarjeta de tuit animada |
| imagen / entidad | asset-fusion | la geometría del recurso se convierte en el gráfico (fusión diegética RWA) |
Orden de construcción: uno a la vez, priorizando la cobertura (lo 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 en macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.
Claves opcionales (alternativas locales si no están configuradas) — solo necesarias para categorías que obtienen/generan recursos a través del uso de medios:
| Clave | Usada para | Alternativa |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | generación de imágenes (resolución de uso de medios) | omitir generar / solo búsqueda |
| (proveedores de asset_scout / búsqueda) | búsqueda de recursos reales webpage/news/tweet + asset-fusion | la categoría se degrada a sin recursos |
Flujo
Paso 0 — Inicializar
El directorio de trabajo actual es la raíz del espacio de trabajo del agente; escribe todos los artefactos bajo PROJECT_DIR = videos/<project-name>/. <project-name>: usa el directorio que dio el usuario, o si no, un nombre corto en kebab-case derivado de la intención (<subject>-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/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics
init verifica las habilidades instaladas contra las últimas en GitHub y actualiza el conjunto global si alguna está desactualizada.
Restricciones: nunca ejecutar 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 subshell (cd "$PROJECT_DIR" && ...) — nunca cd simple.
Paso 1 — Planificar (subagente: Director Parte 1)
Envía un subagente. prompt = agents/director.md completo + ## Contexto de envío (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 / maps); el contenido lo proporciona el usuario;
asset_needs: []. - Sí → emitir un plan de búsqueda dentro de
asset_needs[](noticias / web / tuit / imagen; consultas bipolares). 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 / maps); 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 breve resumen de la toma 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: uso de medios, condicional)
Si shot-plan.json.asset_needs no está vacío, resolver recursos (buscar / generar / obtener → rutas locales congeladas del proyecto + registro). Consultar phases/source/guide.md (envuelve media-use resolve; las categorías impulsadas por búsqueda utilizan la búsqueda de noticias/web/tuit/imagen). Si asset_needs está vacío, saltar al Paso 3.
Degradar con elegancia: si un proveedor de búsqueda no está disponible, la categoría retrocede a sin recursos (anotarlo en context.log).
Paso 3 — Diseñar (subagente: Director Parte 2)
Envía un subagente (prompt = agents/director.md Parte 2 + contexto de envío incluyendo el assets/index.md resuelto si se ejecutó el Paso 2 + catalog-map.md). Diseña la toma en torno a los recursos disponibles: elegir 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 de cuentagotas. Finaliza shot-plan.json (content.block + content.customize + contenido por categoría).
Paso 4 — Construir (subagente: Builder, priorizar reutilización)
Incluir los principios de movimiento compartidos en el contexto de envío del Builder. Para charts y stat, incluir también datos en movimiento. El Builder lee estas guías antes de escribir la línea de tiempo.
Envía un subagente. prompt = agents/builder.md completo + contexto de envío (shot-plan.json, catalog-map.md, el module.md de la categoría, references/motion-vocabulary.md, references/builder-contract.md). Priorizar reutilización: npx hyperframes add <block> + personalizar en el lugar; escribir a mano solo las brechas + la capacidad de fusión de recursos. Salida compositions/index.html respetando el contrato HF (línea de tiempo GSAP en pausa en window.__timelines, class="clip" + ids estables, tl.seek(0), determinista).
Paso 5 — Verificar (Bash → subagente de reparación en caso de error)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)
Elegir tiempos de prueba que muestren el estado inicial, el movimiento característico y la pausa final. Inspeccionar la hoja de contactos o capturas generada antes de continuar. En caso de error de lint, check o captura, enviar el subagente de reparación (agents/finalize.md) para un pase de corrección en el lugar, luego volver a ejecutar la puerta fallida. Nunca cambiar una duración fija solo para ocultar un defecto.
Paso 6 — Aprobar y renderizar (Bash)
Abrir Studio, luego hacer una pregunta: "¿renderizar ahora o qué cambios?" Después de las revisiones, volver a la misma puerta:
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
Renderizar 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)
Verificar que la salida existe, no está vacía y tiene la duración prevista. La entrega final nombra el artefacto, la duración real, el ID de la composición o fotograma, los tiempos de prueba y la hoja de contactos o capturas inspeccionada. Las banderas están en /hyperframes-cli → references/preview-render.md.
Tabla de reanudación
| Estado | Continuar desde |
|---|---|
no hay shot-plan.json | Paso 1 (planificar) |
shot-plan.json tiene asset_needs, no hay assets/ | Paso 2 (obtener) |
shot-plan.json final, no hay compositions/index.html | Paso 3/4 (diseñar+construir) |
compositions/index.html existe, faltan capturas de prueba | Paso 5 (verificar) |
| comprobaciones y capturas de prueba pasan, no hay renderizado aprobado | Paso 6 (aprobación) |
| el renderizado aprobado existe | verificar salida, luego informar |
Notas de diseño (mantenedores — la ejecución no lee esto)
- Prioridad de recursos
...