motion-graphics — entrada de despacho
Confirme la ruta antes del Paso 0. Esta 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 locución). Un tratamiento más largo, de varias escenas o narrado →
/general-video; un video narrado de un sitio web →/website-to-video; un explicador de temas →/faceless-explainer; una promoción de producto →/product-launch-video; subtítulos en material existente →/embedded-captions. Fuera del alcance: datos en vivo / al momento del renderizado, o material que no se pueda capturar. ¿No está seguro si es centrado en movimiento o narrado? Lea/hyperframesprimero.
Un motion graphic corto centrado en el diseño. Primero los activos: decida la estrategia de activos y obtenga material real antes de diseñar la toma, luego diseñe la toma en torno a lo que tiene y, finalmente, componga reutilizando las 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 este.
| Fase | Ejecución | Artefacto principal | Flujo detallado |
|---|---|---|---|
| init | Bash | hyperframes.json | Paso 0 |
| plan | subagente — ¿decidir búsqueda? + clasificar + estrategia de activos | shot-plan.json (borrador: categoría, consultas asset_needs, resumen) | agents/director.md (Parte 1) |
| fuente ◇ | Bash — resolución de uso multimedia (omitir si asset_needs está vacío) | assets/ + assets/index.md | phases/source/guide.md |
| diseño | subagente — diseño de toma en torno a activos resueltos | shot-plan.json (final: bloque(s) + diseño + movimiento + posiciones) | agents/director.md (Parte 2) |
| construir | subagente — composición priorizando reutilización | compositions/index.html | agents/builder.md |
| renderizar | Bash — hyperframes render (MP4, o --format webm/mov para superposición) | renders/video.mp4 | Paso 5 |
| verificar | Bash — lint / inspect -> subagente de reparación en caso de fallo | (correcciones en el lugar) | agents/finalize.md |
◇ fuente se ejecuta solo cuando la categoría elegida declara activos. Las categorías puramente de código/texto (p. ej., kinetic-type, la mayoría de charts/stat) tienen asset_needs: [] y saltan directamente de planificación a diseño.
Categorías — divididas por la decisión de búsqueda
La primera decisión de plan es: ¿necesita esto una búsqueda? Ese bifurcador 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 + construcción); el vocabulario de movimiento compartido reside en references/motion-vocabulary.md (→ reglas/planos hyperframes-animation + bloques de registro).
Categorías formales — 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 movimiento | bloques caption-* + reglas de animación |
stat | número / conteo heroico único + anillo | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | gráfico de barras / líneas / circular / 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 sociales | caption-* + bloques de superposición del registro |
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 / IU (desplazamiento, revelación, cursor, llamadas) |
| artículo de noticias | news | revelación de titular + tarjeta de fuente + llamadas de datos clave |
| tweet | tweet | tarjeta de tweet 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 (lo básico está bien). kinetic-type portado del prototipo; el resto sigue.
Requisitos previos
macOS Apple Silicon o Linux x64. Herramientas del sistema: brew install node ffmpeg. Ejecutar npx hyperframes doctor una vez. Renderizado con GPU en macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.
Claves opcionales (alternativas locales si no están configuradas) — solo las necesitan las categorías que obtienen/generan activos mediante uso multimedia:
| Clave | Se usa para | Alternativa |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | generación de imágenes (resolución de uso multimedia) | omitir generación / solo búsqueda |
| (proveedores de asset_scout / búsqueda) | búsqueda de activos reales webpage/news/tweet + asset-fusion | la categoría se degrada a sin activos |
Flujo
Paso 0 — Inicializar
El directorio de trabajo actual es la raíz del espacio de trabajo del agente; escriba todos los artefactos bajo PROJECT_DIR = videos/<nombre-del-proyecto>/. <nombre-del-proyecto>: use el directorio que dio el usuario, si no, un nombre corto en kebab-case derivado de la intención (<asunto>-motion). No use 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
init verifica las skills instaladas con 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 sub-shell (cd "$PROJECT_DIR" && ...) — nunca un cd simple.
Paso 1 — Planificar (subagente: Director Parte 1)
Despache 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: ¿necesita esto una búsqueda? (el primer bifurcador)
- No → elegir una categoría formal (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 / tweet / 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 formal (kinetic-type / stat / charts / logo-reveal / lower-thirds); el contenido lo proporciona el usuario;
- Escribir un borrador de
shot-plan.json(envoltura + categoría formal elegida o intención de búsqueda +asset_needs+ un resumen de 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 — Fuente ◇ (Bash: uso multimedia, condicional)
Si shot-plan.json.asset_needs no está vacío, resolver activos (búsqueda / generación / obtención → rutas locales de proyecto congeladas + registro). Consulte phases/source/guide.md (envuelve media-use resolve; las categorías impulsadas por búsqueda usan la búsqueda de noticias/web/tweet/imagen). Si asset_needs está vacío, saltar al Paso 3.
# ilustrativo — consulte phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Degradar con elegancia: si un proveedor de búsqueda no está disponible, la categoría vuelve a una sin activos (anótelo en context.log).
Paso 3 — Diseñar (subagente: Director Parte 2)
Despache un subagente (prompt = agents/director.md Parte 2 + contexto de despacho incluyendo el assets/index.md resuelto si se ejecutó el Paso 2 + catalog-map.md). Diseña la toma en torno a los activos disponibles: elija 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: Constructor, priorizando reutilización)
Despache un subagente. prompt = agents/builder.md completo + contexto de despacho (shot-plan.json, catalog-map.md, 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 los huecos + la capacidad 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 — Renderizar (Bash)
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# variante de superposición transparente: --format webm (o mov)
Paso 6 — Verificar (Bash → subagente de reparación en caso de fallo)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
código de salida 0 → listo. En caso de errores de lint/inspect, despache el subagente de reparación (agents/finalize.md: instantánea de QA + una pasada de corrección en el lugar + re-renderizado). Nunca cambiar una duración fija durante la reparación.
Informe + vista previa opcional
Informar la salida final (renders/video.mp4, o la variante de superposición .webm / .mov) + duración. No abrir una vista previa durante la ejecución. Ofrecerla solo a solicitud, iniciada después del renderizado para que sirva el archivo final:
(cd "$PROJECT_DIR" && npx hyperframes preview) # IU de Studio; o `npx hyperframes play` para un enlace compartible
Las banderas están en la skill 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 (fuente) |
shot-plan.json final, sin compositions/index.html | Pasos 3/4 (diseñar+construir) |
compositions/index.html existe, sin renders/video.mp4 | Paso 5 (renderizar) + Paso 6 |
renders/video.mp4 existe | Informar + detener |
Notas de diseño (mantenedores — la ejecución no lee esto)
- Razón de ser de 'primero los activos': la obtención de activos se realiza al principio e informa el diseño de la toma (el flujo RWA: analizar → buscar → revisar → componer). Las categorías impulsadas por búsqueda (
webpage/news/tweet) yasset-fusionse apoyan en la búsqueda de uso multimedia (noticias/web/tweet/imagen), que es el linaje RWA documentado de media-use. - Prioridad de reutilización: el análogo dentro del ecosistema de las plantillas generadas por LLM es "componer bloques del catálogo + reglas de
hyperframes-animation". La línea de tiempo GSAP pausada de HF es equivalente auseCurrentFramede Remotion. - Contrato del módulo de categoría: un
categories/<id>/module.md(planificación + construcción), compartiendoreferences/motion-vocabulary.md(+ evaluación opcional). Agregar una categoría = soltar la carpeta + registrar su línea de clasificador enagents/director.md+ su fila encatalog-map.md; el pipeline de fases no se modifica. - Estructura de directorios:
videos/<nombre-del-proyecto>/ hyperframes.json context.log shot-plan.json # el IR (salida del Director) assets/ assets/index.md # salida de media-use (si se obtuvo) compositions/index.html # salida del Constructor renders/video.mp4 - Registro: en el enrutador de
hyperframes— agregar la intención "motion graphic corto centrado en el diseño" + descripción del flujo de trabajo; separar los disparadores de motion-graphics de/general-video; agregar bordes inversos de NO-UTILIZAR. Consultemotion-graphics-genre.md§5-7.