hyperframes-animation

Compose deterministic GSAP animations for HyperFrames video compositions using atomic motion rules and scene blueprints.

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/firstsun-dev/skills --skill hyperframes-animation-firstsun-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperframes-animation
Source: https://github.com/firstsun-dev/skills/tree/main/plugins/visual-content/skills/hyperframes-animation
Command: npx skills add https://github.com/firstsun-dev/skills --skill hyperframes-animation-firstsun-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gsap, lottie-web, three, animejs, and includes scripts (resource) components.

What problem does it solve? Authoring motion for HyperFrames video compositions requires knowing which animation pattern fits a scene, which runtime API to call, and how to keep everything seek-safe and deterministic. This Skill consolidates all animation knowledge — atomic motion rules, multi-phase scene blueprints, scene transitions, motion-design techniques, and seven runtime adapters — into one routable reference so agents pick the right recipe instead of inventing choreography from scratch. ## Core Features & Use Cases - Atomic motion rules: 25+ composable GSAP recipes (kinetic typography, counters, camera moves, 3D transforms, SVG drawing, springs, ripples) indexed by tag and trigger in rules-index.md. - Scene blueprints: 15 time-coded shot templates (kinetic-type-beats, cursor-ui-demo, logo-assemble-lockup, etc.) mapped to storyboard roles like Hook, Problem, Key_Feature, and CTA. - Runtime adapters: API references for GSAP (default), Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, and TypeGPU/WebGPU, all registered for deterministic frame-by-frame seeking. - Transition registry: Machine-readable JSON of Tier-B scene transitions (crossfade, blur-crossfade, push-slide, zoom-through, squeeze) stamped by a deterministic injector. - Use Case: When building a product-launch video scene, read the blueprint for the frame's role, compose 2-4 atomic rules on a single paused GSAP timeline, then audit the result with the animation-map script. ## Quick Start Ask the agent to animate a HyperFrames scene by picking rules from rules-index.md and composing them on a single paused GSAP timeline registered under the scene's data-composition-id.

Frequently Asked Questions about hyperframes-animation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add animation to a HyperFrames composition?▼

Pick 2-4 atomic rules from rules-index.md and compose them on a single paused GSAP timeline registered as window.__timelines keyed by the scene's data-composition-id. Load a blueprint from blueprints-index.md only when the scene matches a pre-designed multi-phase template.

Which animation library should I use for HyperFrames scenes?▼

GSAP is the default for about 95% of motion work, covering timelines, transforms, easing, and stagger. Use Lottie for pre-baked After Effects assets, Three.js for 3D scenes, Anime.js for lightweight tweening, CSS for simple decoration, WAAPI for native keyframes, and TypeGPU for GPU-rendered canvases.

Can I use Lottie or Three.js animations with GSAP in one composition?▼

Yes, multiple runtimes can coexist in one composition. Each runtime registers its instances on its own global (window.__hfLottie, window.__hfAnime, etc.) so HyperFrames can seek all of them in one pass alongside the GSAP timelines.

Why is my HyperFrames animation not rendering deterministically?▼

Common causes are using Math.random, Date.now, or performance.now, infinite repeats, timeline construction inside async callbacks, or deriving positions from getBoundingClientRect at tween time. Compute layout constants once at composition setup and keep the timeline paused for frame-by-frame seeking.

What CSS properties can I animate in HyperFrames scenes?▼

Spatial motion must use GSAP transform aliases x, y, scale, and rotation. Non-spatial tweens may use opacity, color, backgroundColor, and borderRadius. Never tween width, height, top, left, display, or visibility for layout changes.

How do I audit an existing composition's animation choreography?▼

Run the animation-map.mjs script against the composition directory. It reads every GSAP timeline on window.__timelines, enumerates tweens, samples bounding boxes, and outputs animation-map.json flagging dead zones, stagger inconsistencies, and lifecycle warnings.