Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Todo el conocimiento de animación para HyperFrames: reglas atómicas de movimiento, planos de escenas multifásicas, transiciones entre escenas, técnicas más amplias de diseño de movimiento y los siete adaptadores de tiempo de ejecución. Úsalo para cualquier tarea de animación: elige de 2 a 4 reglas y compón, carga un plano o busca una API específica del runtime.

¿Qué es hyperframes-instruct?

HyperFrames Animation es un skill de agente de IA que centraliza todo el conocimiento de animación para el framework HyperFrames. Este skill permite a los agentes (como Claude Code, Cursor y similares) generar o inspeccionar animaciones web complejas de forma determinista, utilizando reglas atómicas, planos de escenas predefinidos y transiciones. Soporta siete adaptadores de tiempo de ejecución (GSAP, Lottie, Three.js, Anime.js, CSS Keyframes, Web Animations API y TypeGPU/WebGPU), lo que lo hace versátil para cualquier tipo de proyecto de animación, desde simples interfaces hasta efectos 3D con WebGL. El skill proporciona una tabla de referencia práctica para que el agente sepa exactamente qué archivo leer según la tarea: reglas, planos, transiciones, técnicas o adaptadores. También incluye un script para auditar coreografías de animación existentes y 24 efectos de animación de texto con nombre. HyperFrames es nativo en cuanto a determinismo y búsqueda segura: opera con una sola línea de tiempo pausada, sin valores aleatorios ni dependencias de tiempo de ejecución, lo que garantiza una reproducción consistente.

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

Preguntar en tu IA favorita

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

Documentación

Instalación de plugins: Antes de los 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.

Animación HyperFrames

Todo el conocimiento de movimiento en un skill: reglas (recetas atómicas), planos (plantillas de escenas multifásicas), transiciones (de escena a escena), técnicas (patrones más amplios de diseño de movimiento) y adaptadores (APIs por runtime).

Para el contrato de composición (atributos de datos, sub-composiciones, determinismo), consulta hyperframes-core.

Predeterminado: componer reglas atómicas

Elige de 2 a 4 reglas de rules-index.md, pégalas con una sola línea de tiempo de GSAP pausada, listo. Esto es más rápido y produce menos código que comenzar desde un plano.

Cargar un plano cuando

  • La escena coincide con una plantilla multifásica prediseñada existente (revelación de marca, prueba social, etc.) y reutilizar su pipeline de fases ahorra tiempo de autoría real.
  • Deseas código de verdad ejecutable para una coreografía compleja de 4 a 5 fases.

Los planos viven en blueprints-index.md. Cada entrada apunta a blueprints/<id>.md (receta). No lo leas especulativamente; cárgalo cuando ya hayas decidido que necesitas orquestación a nivel de escena.

Enrutamiento

Quieres…Lee
Elegir un patrón de movimiento atómico por disparador/etiquetarules-index.md
Leer la receta completa HTML/CSS/GSAP de una reglarules/<name>.md
Elegir una plantilla de escena multifásicablueprints-index.md
Leer la receta completa de un planoblueprints/<id>.md
Crear una transición de escena (controlada por CSS, entre dos clips)transitions/overview.md, transitions/catalog.md
Buscar una técnica más amplia de diseño de movimientotechniques.md
Desenfoque de movimiento: barrido de obturador en un elemento y cuándo no usarloreferences/motion-blur.md
Analizar el mapa de animación de una composición existentescripts/animation-map.mjs
API de GSAP: líneas de tiempo/tweens/parámetros de posiciónadapters/gsap.md
GSAP: recetas de efectos integrablesrules/gsap-effects.md
GSAP: transformaciones/rendimientoadapters/gsap-transforms-and-perf.md
GSAP: easing/staggeradapters/gsap-easing-and-stagger.md
GSAP: línea de tiempo/etiquetasadapters/gsap-timeline-and-labels.md
Lottie/dotLottie (exportaciones de After Effects, window.__hfLottie)adapters/lottie.md
Animación de personajes (ciclo de caminata, mascota, marioneta articulada, gestos)adapters/lottie.md → Personajes
Three.js/WebGL (escenas 3D, AnimationMixer, hf-seek)adapters/three.md
Anime.js (window.__hfAnime)adapters/animejs.md
Keyframes CSS (animation-delay/play-state/fill-mode)adapters/css-animations.md
API de Animaciones Web (element.animate(), búsqueda currentTime)adapters/waapi.md
TypeGPU/WebGPU (navigator.gpu, WGSL, pipelines de cómputo)adapters/typegpu.md
HTML como textura + post-efectos WebGL/GLSL (capturar DOM en vivo mediante drawElementImage)adapters/html-in-canvas-patterns.md
Efectos de animación de texto con nombre (24 IDs mediante el skill externo animate-text)adapters/animate-text.md

Elegir un runtime

  • GSAP es el predeterminado para el 95% del trabajo de movimiento: cubre orquestación de líneas de tiempo, transformaciones, easing, stagger. Todas las reglas atómicas de este skill están basadas en GSAP.
  • Lottie cuando un activo tiene su propia línea de tiempo predefinida (típicamente exportaciones de After Effects), incluidos personajes que caminan, gesticulan o reaccionan.
  • Three.js para escenas 3D, movimiento de cámara, visuales basados en shaders.
  • Anime.js para interpolación ligera cuando GSAP es excesivo.
  • CSS para motivos simples repetidos, decoración, brillo: sin costo de animación JavaScript.
  • WAAPI para keyframes nativos del navegador sin dependencia de GSAP.
  • TypeGPU/WebGPU para lienzos renderizados por GPU (partículas, vidrio líquido, shaders personalizados).

Múltiples runtimes pueden coexistir en una misma composición. Cada uno registra sus instancias en el global específico del runtime para que HyperFrames pueda buscar en todos ellos en un solo paso.

Restricciones críticas

Requisito previo: hyperframes-core → Una línea de tiempo pausada + Reglas no negociables (una sola línea de tiempo pausada, data-duration gobierna la duración, sin Math.random/Date.now/performance.now, sin repeat: -1 sin un data-duration raíz finito, sin gsap.set en la carga de página para clips de escenas posteriores, sin tweens de display o visibility sin procesar, y registrar la línea de tiempo solo después de que esté completamente construida, incluso cuando la construcción se ejecute dentro de un callback asíncrono como document.fonts.ready). GSAP autoAlpha y configuraciones de visibilidad de duración cero en límites explícitos de la línea de tiempo siguen permitidos por el núcleo. Usa esas excepciones solo en elementos que no sean clips o envoltorios dentro de un clip; el framework posee el ciclo de vida de .clip. No repitas el contrato completo aquí.

Adiciones de artesanía de animación además del contrato del núcleo:

  • Constantes de diseño precalculadas: nunca derives posiciones de getBoundingClientRect() en el momento del tween. Las mediciones del DOM en el momento del tween se desincronizan porque el renderizador muestrea en paralelo; calcula las coordenadas una vez en la configuración de la composición y reutilízalas.
  • El movimiento espacial usa solo alias de transformación de GSAP (x, y, scale, rotation). La lista permitida del núcleo también permite opacity/color/backgroundColor/borderRadius para tweens de propiedades no espaciales, pero nunca width/height/top/left para cambios de diseño.

Scripts

node <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

Lee cada línea de tiempo de GSAP registrada en window.__timelines, enumera los tweens, muestrea los bboxes, calcula banderas y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia de stagger, advertencias del ciclo de vida) después de la autoría.

animation-map.mjs resuelve los paquetes auxiliares del proyecto actual primero, luego puede iniciar la versión empaquetada del paquete HyperFrames. Establece HYPERFRAMES_SKILL_PKG_VERSION=<version> solo cuando ejecutes el skill fuera de la CLI/instalación del skill empaquetada y necesites fijar explícitamente esa versión de inicio.

Ver también

  • hyperframes-core — estructura de composición, atributos de datos, sub-composiciones, contrato de renderizado determinista
  • hyperframes-creative — paletas, tipografía, narración, planificación de ritmos (dirección creativa no animada)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

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

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.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Skills relacionados