# Hyperframes Animation > 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. Source: https://skillsagentes.com/skills/heygen-com/hyperframes/hyperframes-animation Repository: https://github.com/heygen-com/hyperframes Author: heygen-com License: Apache-2.0 Updated: hace 14 días Context cost: 156 tok installed, 1.9k tok once triggered, 299.5k tok with every bundled file Bundle: 121 files, 1.1 MB Permissions requested: none declared ## Install ```bash npx -y skills add heygen-com/hyperframes --skill hyperframes-animation --agent claude-code ``` ## What it does - Selecciona y compone 2-4 reglas atómicas de movimiento con una única timeline de GSAP pausada - Carga blueprints multi-fase para escenas complejas de 4-5 fases - Provee APIs de referencia para siete adaptadores de runtime (GSAP, Lottie, Three.js, Anime.js, CSS, WAAPI, TypeGPU) - Ayuda a autorar transiciones entre escenas y técnicas de motion-design más amplias - Audita el mapa de animación de una composición existente con scripts/animation-map.mjs ## Use it when - Necesitas cualquier tarea de movimiento o animación en HyperFrames - La escena coincide con un template multi-fase existente (brand-reveal, social-proof, etc.) - Necesitas buscar la API específica de un runtime (eases de GSAP, player de Lottie, mixer de Three.js) - Quieres auditar la coreografía de una composición ya existente ## Don't bother when - No cargues un blueprint especulativamente; hazlo solo cuando ya decidiste que necesitas orquestación a nivel de escena ## What triggers it - "Crea una animación de entrada combinando 2-3 reglas atómicas con GSAP" - "Necesito un blueprint de brand-reveal con 4 fases" - "¿Cómo controlo el mixer de Three.js en esta composición?" - "Audita la coreografía de esta composición y dame el mapa de animación" - "Busca la API de eases y stagger de GSAP" ## Before you install - Requiere hyperframes-core para el contrato de composición (single paused timeline, data-duration, reglas no negociables). - Needs on PATH: node - Environment: BOOTSTRAP_CONFIRM_ENV, HYPERFRAMES_SKILL_BOOTSTRAP_DEPS, JSON, VERSION_OVERRIDE_ENV ## Files - SKILL.md — 8 KB - adapters/animate-text.md — 4 KB - adapters/animejs.md — 3 KB - adapters/css-animations.md — 5 KB - adapters/gsap-easing-and-stagger.md — 13 KB - adapters/gsap-timeline-and-labels.md — 4 KB - adapters/gsap-transforms-and-perf.md — 8 KB - adapters/gsap.md — 7 KB - adapters/html-in-canvas-patterns.md — 17 KB - adapters/lottie.md — 4 KB - adapters/three.md — 5 KB - adapters/typegpu.md — 8 KB - adapters/waapi.md — 4 KB - blueprints-index.md — 26 KB - blueprints/agent-progress-theater.md — 16 KB - blueprints/camera-journey.md — 13 KB - blueprints/comparison-split.md — 3 KB - blueprints/constellation-hub.md — 7 KB - blueprints/cta-morph-press.md — 6 KB - blueprints/cursor-ui-demo.md — 20 KB - blueprints/dataviz-countup.md — 14 KB - blueprints/device-surface-showcase.md — 17 KB - blueprints/fixed-anchor-cycle.md — 9 KB - blueprints/grid-card-assemble.md — 15 KB - blueprints/kinetic-type-beats.md — 28 KB - blueprints/logo-assemble-lockup.md — 26 KB - blueprints/overwhelm-surround.md — 6 KB - blueprints/panel-edit-live-sync.md — 13 KB - blueprints/prompt-type-submit-generate.md — 18 KB - blueprints/spatial-pan-stations.md — 5 KB - blueprints/ticker-takeover.md — 3 KB - blueprints/titlecard-reveal.md — 7 KB - blueprints/transcript-scroll-artifact-reveal.md — 11 KB - blueprints/typewriter-reveal.md — 6 KB - blueprints/video-text-pivot.md — 3 KB - blueprints/zoom-out-workspace-reveal.md — 14 KB - examples/brand-reveal-assemble-zoom.html — 12 KB - examples/comparison-split-cards.html — 21 KB - examples/concept-demo-decode-pan.html — 18 KB - examples/cta-morph-press.html — 15 KB - examples/cta-orbit-collapse.html — 49 KB - examples/demo-page-scroll-spotlight.html — 24 KB - examples/hook-counter-burst.html — 22 KB - examples/messaging-multi-phrase.html — 12 KB - examples/metric-video-text-pivot.html — 25 KB - examples/problem-mockup-overwhelm.html — 43 KB - examples/proof-logo-chain.html — 28 KB - examples/takeover-ticker-displace.html — 11 KB - examples/workflow-approve-press.html — 20 KB - rules-index.md — 21 KB - rules/3d-camera-flight.md — 18 KB - rules/3d-page-scroll.md — 7 KB - rules/3d-text-depth-layers.md — 7 KB - rules/ai-tracking-box.md — 6 KB - rules/ambient-glow-bloom.md — 10 KB - rules/anchored-layout-expand.md — 10 KB - rules/asr-keyword-glow.md — 7 KB - rules/avatar-cloud-network.md — 6 KB - rules/camera-cursor-tracking.md — 8 KB - rules/card-morph-anchor.md — 7 KB - rules/center-outward-expansion.md — 4 KB - rules/chart-scrub-readout.md — 10 KB - rules/chromatic-glitch.md — 10 KB - rules/context-sensitive-cursor.md — 7 KB - rules/control-target-sync.md — 10 KB - rules/coordinate-target-zoom.md — 7 KB - rules/counting-dynamic-scale.md — 6 KB - rules/css-marker-patterns.md — 6 KB - rules/cursor-click-ripple.md — 6 KB - rules/cursor-drag.md — 10 KB - rules/depth-of-field-blur.md — 9 KB - rules/depth-scatter-assemble.md — 7 KB - rules/discrete-text-sequence.md — 6 KB - rules/dynamic-content-sequencing.md — 8 KB - rules/gradient-text-sweep.md — 9 KB - rules/gsap-effects.md — 7 KB - rules/hacker-flip-3d.md — 5 KB - rules/kinetic-beat-slam.md — 6 KB - rules/motion-blur-streak.md — 10 KB - rules/multi-cursor-choreography.md — 10 KB - rules/multi-phase-camera.md — 8 KB - rules/nudge-curve.md — 3 KB - rules/orbit-3d-entry.md — 6 KB - rules/particle-burst.md — 10 KB - rules/physics-press-reaction.md — 7 KB - rules/press-release-spring.md — 7 KB - rules/reactive-displacement.md — 6 KB - rules/scale-swap-transition.md — 5 KB - rules/sine-wave-loop.md — 6 KB - rules/split-tilt-cards.md — 6 KB - rules/spring-pop-entrance.md — 6 KB - rules/stat-bars-and-fills.md — 5 KB - rules/svg-icon-enrichment.md — 7 KB - rules/svg-path-draw.md — 5 KB - rules/theme-crossfade-morph.md — 9 KB - rules/vertical-spring-ticker.md — 5 KB - rules/viewport-change.md — 9 KB - rules/waterfall-entry.md — 4 KB - scripts/animation-map-sampling.mjs — 1 KB - scripts/animation-map-sampling.test.mjs — 2 KB - scripts/animation-map.mjs — 20 KB - scripts/animation-map.test.mjs — 12 KB - scripts/package-loader.mjs — 13 KB - scripts/package-loader.test.mjs — 3 KB - techniques.md — 15 KB - transitions/TRANSITION-REGISTRY.md — 8 KB - transitions/catalog.md — 7 KB - transitions/css-3d.md — 421 B - transitions/css-blur.md — 2 KB - transitions/css-cover.md — 1 KB - transitions/css-destruction.md — 4 KB - transitions/css-dissolve.md — 2 KB - transitions/css-distortion.md — 2 KB - transitions/css-grid.md — 370 B - transitions/css-light.md — 2 KB - transitions/css-mechanical.md — 2 KB - transitions/css-other.md — 838 B - transitions/css-push.md — 1 KB - transitions/css-radial.md — 1 KB - transitions/css-scale.md — 715 B - transitions/overview.md — 14 KB ## SKILL.md Reproduced verbatim from heygen-com/hyperframes under Apache-2.0. This section is the upstream document and is in English. # HyperFrames Animation All motion knowledge in one skill: **rules** (atomic recipes), **blueprints** (multi-phase scene templates), **transitions** (scene-to-scene), **techniques** (broader motion-design patterns), and **adapters** (per-runtime APIs). For the composition contract (data attributes, sub-compositions, determinism) see `hyperframes-core`. ## Default: compose atomic rules Pick 2-4 rules from `rules-index.md`, glue them together with a single paused GSAP timeline, done. This is faster and produces less code than starting from a blueprint. ## Load a blueprint when - The scene matches an existing pre-designed multi-phase template (brand-reveal, social-proof, etc.) and reusing its phase pipeline saves real authoring time - You want runnable ground-truth code for a complex 4-5 phase choreography Blueprints live in `blueprints-index.md`. Each entry points to `blueprints/.md` (recipe). Do not read it speculatively; load it when you've already decided you need scene-level orchestration. ## Routing | Want to… | Read | | ------------------------------------------------------------------------------ | --------------------------------------------------- | | Pick an atomic motion pattern by trigger / tag | `rules-index.md` | | Read one rule's full HTML / CSS / GSAP recipe | `rules/.md` | | Pick a multi-phase scene template | `blueprints-index.md` | | Read one blueprint's full recipe | `blueprints/.md` | | Author a scene transition (CSS-driven, between two clips) | `transitions/overview.md`, `transitions/catalog.md` | | Look up a broader motion-design technique | `techniques.md` | | Analyze an existing composition's animation map | `scripts/animation-map.mjs` | | GSAP API — timeline / tweens / position parameters | `adapters/gsap.md` | | GSAP — drop-in effect recipes | `rules/gsap-effects.md` | | GSAP — transforms / perf | `adapters/gsap-transforms-and-perf.md` | | GSAP — eases / stagger | `adapters/gsap-easing-and-stagger.md` | | GSAP — timeline / labels | `adapters/gsap-timeline-and-labels.md` | | Lottie / dotLottie (After Effects exports, `window.__hfLottie`) | `adapters/lottie.md` | | Three.js / WebGL (3D scenes, `AnimationMixer`, `hf-seek`) | `adapters/three.md` | | Anime.js (`window.__hfAnime`) | `adapters/animejs.md` | | CSS keyframes (`animation-delay` / `play-state` / `fill-mode`) | `adapters/css-animations.md` | | Web Animations API (`element.animate()`, `currentTime` seek) | `adapters/waapi.md` | | TypeGPU / WebGPU (`navigator.gpu`, WGSL, compute pipelines) | `adapters/typegpu.md` | | HTML-as-texture + WebGL/GLSL post-fx (capture live DOM via `drawElementImage`) | `adapters/html-in-canvas-patterns.md` | | Named text-animation effects (24 IDs via external `animate-text` skill) | `adapters/animate-text.md` | ## Picking a runtime - **GSAP** is the default for 95% of motion work — covers timeline orchestration, transforms, easing, stagger. All atomic rules in this skill are GSAP-based. - **Lottie** when an asset has its own pre-baked timeline (typically After Effects exports). - **Three.js** for 3D scenes, camera motion, shader-driven visuals. - **Anime.js** for lightweight tweening when GSAP is overkill. - **CSS** for simple repeated motifs, decoration, shimmer — no JavaScript animation cost. - **WAAPI** for native browser keyframes without a GSAP dependency. - **TypeGPU / WebGPU** for GPU-rendered canvases (particles, liquid glass, custom shaders). Multiple runtimes can coexist in one composition. Each registers its instances on the runtime-specific global so HyperFrames can seek all of them in one pass. ## Critical Constraints **Prerequisite: `hyperframes-core` → Non-Negotiable Rules** (single paused timeline, `data-duration` governs length, no `Math.random` / `Date.now` / `performance.now`, no `repeat: -1`, no page-load `gsap.set` on later-scene clips, no `display` or raw `visibility` tweens, and no timeline construction inside `async` / `setTimeout` / `Promise`). GSAP `autoAlpha` and zero-duration visibility sets at explicit timeline boundaries remain allowed by core. Use those exceptions only on non-clip elements or wrappers inside a clip; the framework owns `.clip` lifecycle. Don't restate the full contract here. Animation-craft additions on top of core's contract: - **Pre-calculated layout constants** — never derive positions from `getBoundingClientRect()` at tween time. Tween-time DOM measurements desync because the renderer samples in parallel; compute coordinates once at composition setup and reuse. - **Spatial motion uses GSAP transform aliases only** (`x`, `y`, `scale`, `rotation`). Core's allowlist also permits `opacity` / `color` / `backgroundColor` / `borderRadius` for non-spatial property tweens — but never `width` / `height` / `top` / `left` for layout changes. ## Scripts ```bash node skills/hyperframes-animation/scripts/animation-map.mjs \ --out /.hyperframes/anim-map ``` Reads every GSAP timeline registered on `window.__timelines`, enumerates tweens, samples bboxes, computes flags, outputs `animation-map.json`. Use it to audit choreography (dead zones, stagger consistency, lifecycle warnings) after authoring. `animation-map.mjs` resolves helper packages from the current project first, then can bootstrap the bundled HyperFrames package version. Set `HYPERFRAMES_SKILL_PKG_VERSION=` only when running the skill outside the bundled CLI/skill install and you need to pin that bootstrap version explicitly. ## See Also - `hyperframes-core` — composition structure, data attributes, sub-compositions, deterministic render contract - `hyperframes-creative` — palettes, typography, narration, beat planning (non-animation creative direction) - `hyperframes-cli` — `npx hyperframes lint / check / snapshot / preview / render` --- Skills Agentes — https://skillsagentes.com/skills/heygen-com/hyperframes/hyperframes-animation