Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Un breve gráfico animado centrado en el diseño donde el movimiento es el mensaje: tipografía cinética, contadores, gráficos de datos, logos animados, mapas interactivos y más. Sin narración ni acción real. Renderiza en MP4 o superposición transparente.

¿Qué es hyperframes-instruct?

Este skill de HyperFrames permite a agentes de IA generar gráficos animados cortos y basados en diseño, sin narración, a partir de una descripción textual. Soporta categorías como tipografía cinética, contadores numéricos, gráficos de datos (barras, líneas, pastel, competencias), logos animados, barras de título, mapas geográficos animados, animaciones de páginas web/UI (scroll, cursor, llamadas), noticias, tuits animados y fusión de imágenes con gráficos. El flujo de trabajo es completamente autónomo: planifica, busca activos si es necesario, diseña, construye, verifica y renderiza con una sola pregunta de confirmación al usuario. Está diseñado para plataformas como Claude Code, Cursor y Codex, y utiliza herramientas como `npx hyperframes` para la gestión de dependencias, renderizado con GPU y verificación mediante capturas de prueba. La salida final es un archivo MP4 o un video con superposición transparente (WebM/MOV).

Compatible con~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/motion-graphics

Preguntar en tu IA favorita

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

Documentación

Instalación de plugins: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes mantienen las instrucciones de actualización a continuación.

Primero, mantén este skill actualizado — confirma con el usuario antes de ejecutar: npx hyperframes skills update motion-graphics. Es una operación rápida y sin cambios si todo está al día; de lo contrario, actualiza este skill junto con los skills de dominio central de los que depende, antes de usarlos.

fuente figma: Si el logo/activo/animación a construir proviene de una URL de figma.com, ejecuta /figma primero — 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 con herramientas MCP sin procesar: eso omite la sanitización SVG, la procedencia de .media/manifest.jsonl y la vinculación de var() 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 despacho

La puerta principal es /hyperframes. Este skill crea un gráfico animado corto, centrado en el diseño y sin narración (el movimiento es el mensaje; ~menos de 10s, sin voz en off). Cualquier cosa más larga, narrada o de varias escenas — o cualquier incertidumbre → lee /hyperframes primero: 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 construye hasta la verificación sin revisiones intermedias. La capa de intención (/hyperframes → references/intent-interview.md) te dirige aquí directamente sin preguntas sobre la forma de la ejecución; un storyboard y una sesión complementaria aportan 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 corto y centrado en el diseño. Primero los activos: decide la estrategia de activos y obtén material real antes de diseñar la toma, luego diseña la toma alrededor de 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.

FaseEjecuciónArtefacto principalFlujo detallado
initBashhyperframes.jsonPaso 0
plansubagente — ¿decidir búsqueda? + clasificar + estrategia de activosshot-plan.json (borrador: categoría, consultas asset_needs, brief)agents/director.md (Parte 1)
source ◇Bash — resolver uso de medios (saltar si asset_needs está vacío)assets/ + assets/index.mdphases/source/guide.md
designsubagente — diseño de toma alrededor de activos resueltosshot-plan.json (final: bloque(s) + diseño + movimiento + posiciones)agents/director.md (Parte 2)
buildsubagente — composición con reutilización primerocompositions/index.htmlagents/builder.md
verifyBash — lint, check, capturas de prueba; reparar en caso de fallosnapshots/contact-sheet.jpgPaso 5
approveAbrir la vista previa; preguntar renderizar o cambios; esperar respuestaaprobación explícita del renderPaso 6
renderBash — hyperframes render (MP4, o --format webm/mov para superposición)renders/video.mp4 o superposición transparentePaso 6

◇ source se ejecuta solo cuando la categoría elegida declara activos. Las categorías de código/texto puro (ej. 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? Esa bifurcación divide las categorías en dos grupos; luego se selecciona 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 formulario — sin búsqueda; el usuario proporciona el contenido:

CategoríaIntenciónSe apoya en
kinetic-typelínea/ cita / título impactante, texto con movimiento como protagonistabloques caption-* + reglas de animación
statnúmero heroico único / contador + anilloapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsgráfico de barras / líneas / circular / competencia / % a partir de datosbloque data-chart
logo-revealpresentación de logo / bloque de marca (logo del usuario)logo-outro / rules/svg-path-draw
lower-thirdsbarras de nombre / título, llamadas, superposiciones socialescaption-* + bloques de superposición del registro
mapsmovimiento geográfico — resaltar regiones, conectar lugares, acercar a una ubicación (carril vectorial o 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 devueltoCategoríaAnimación
página web / enlacewebpageanimación de página web / UI (scroll, revelar, cursor, llamadas)
artículo de noticiasnewsrevelación de titular + tarjeta de fuente + llamadas de datos clave
tuittweettarjeta de tuit animada
imagen / entidadasset-fusionla geometría del activo se convierte en el gráfico (fusión diegética RWA)

Orden de construcción: uno a la vez, priorizando la 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 con GPU en macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.

Claves opcionales (fallbacks locales si no están configuradas) — solo las necesitan las categorías que obtienen/generan activos mediante media-use:

ClaveUsada paraFallback
GEMINI_API_KEY / GOOGLE_API_KEYgeneración de imágenes (resolución media-use)saltar generar / solo búsqueda
(asset_scout / proveedores de búsqueda)búsqueda de activos reales para webpage/news/tweet + asset-fusionla categoría se degrada a sin activos

Flujo

Paso 0 — Inicializar

El directorio de trabajo actual es la raíz del workspace del agente; escribe todos los artefactos en PROJECT_DIR = videos/<project-name>/. <project-name>: usa el directorio que dio el usuario, si no, un nombre corto en kebab-case a partir de la intención (<subject>-motion). No uses el nombre base del workspace 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 los skills instalados contra los últimos en GitHub y actualiza el conjunto global si alguno está desactualizado.

Restricciones: nunca ejecutes hyperframes init en la raíz del workspace; nunca anides 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)

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:

  1. Decidir: ¿esto necesita una búsqueda? (la primera bifurcación)
    • No → elegir una categoría de formulario (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); el contenido lo proporciona el usuario; asset_needs: [].
    • Sí → emitir un plan de búsqueda en asset_needs[] (news / web / tweet / image; 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.
  2. Escribir un borrador de shot-plan.json (envoltorio + categoría de formulario elegida o intención de búsqueda + asset_needs + un brief 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 — Obtener ◇ (Bash: media-use, condicional)

Si shot-plan.json.asset_needs no está vacío, resolver activos (búsqueda / generar / obtener → rutas locales congeladas del proyecto + libro de registro). Consulta phases/source/guide.md (envuelve media-use resolve; las categorías impulsadas por búsqueda usan la búsqueda de news/web/tweet/image). Si asset_needs está vacío, saltar al Paso 3.

Degradar con gracia: si una búsqueda/proveedor no está disponible, la categoría vuelve a la versión 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 el assets/index.md resuelto si se ejecutó el Paso 2 + catalog-map.md). Diseña la toma 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 beats, y (para asset-fusion) las element_positions + paleta de cuentagotas. Finaliza shot-plan.json (content.block + content.customize + contenido por categoría).

Paso 4 — Construir (subagente: Builder, reutilización primero)

Incluye los principios de movimiento compartidos en el contexto de despacho del Builder. Para charts y stat, incluye también datos en movimiento. El Builder lee estas guías antes de escribir la línea de tiempo.

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). Reutilización primero: npx hyperframes add <block> + personalizar in situ; escribir a mano solo las lagunas + la funcionalidad de fusión de activos. Salida compositions/index.html respetando el contrato HF (línea de tiempo de 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 fallo)

(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

Elige tiempos de prueba que muestren el estado de apertura, el movimiento característico y la pausa final. Inspecciona la hoja de contactos o la hoja de captura generada antes de continuar. En caso de 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 de control fallida. Nunca cambies 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 de control:

(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, la composición o ID de fotograma, los tiempos de prueba y la hoja de contactos o captura inspeccionada. Las banderas viven en /hyperframes-cli → references/preview-render.md.

Tabla de reanudación

EstadoContinuar desde
sin shot-plan.jsonPaso 1 (planificar)
shot-plan.json tiene asset_needs, no assets/Paso 2 (obtener)
shot-plan.json final, sin compositions/index.htmlPaso 3/4 (diseñar+construir)
compositions/index.html existe, capturas de prueba ausentesPaso 5 (verificar)
comprobaciones y capturas de prueba pasan, sin render aprobadoPaso 6 (aprobación)
render aprobado existeverificar salida, luego informar

Notas de diseño (mantenedores — la ejecución no lee esto)

  • Racionamiento primero de activos

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

sandeshrajbhandari/hyperframes-instruct

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

sandeshrajbhandari/hyperframes-instruct

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

sandeshrajbhandari/hyperframes-instruct

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

sandeshrajbhandari/hyperframes-instruct

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

Skills relacionados