Skip to content
cccskills
FreePublished on GitHub

hyperframes-animation

Build and review HyperFrames animations using motion recipes, scene templates, and transitions. Find guidance for seven animation runtimes, including GSAP and Three.js, and inspect existing scenes for timing gaps and inconsistent motion.

OriginalShow the original description

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.

See how to install

Good for

  • Combine motion recipes for text and shapes
  • Build scenes with several animation phases
  • Choose an animation runtime
  • Audit timing and choreography in existing scenes

Files included (122)

  • SKILL.md8.3 KB
  • adapters/animate-text.md4.5 KB
  • adapters/animejs.md6.1 KB
  • adapters/css-animations.md5.3 KB
  • adapters/gsap-easing-and-stagger.md13.0 KB
  • adapters/gsap-timeline-and-labels.md3.7 KB
  • adapters/gsap-transforms-and-perf.md8.4 KB
  • adapters/gsap.md7.5 KB
  • adapters/html-in-canvas-patterns.md16.8 KB
  • adapters/lottie.md6.0 KB
  • adapters/three.md9.2 KB
  • adapters/typegpu.md8.0 KB
  • adapters/waapi.md4.1 KB
  • blueprints-index.md25.9 KB
  • blueprints/agent-progress-theater.md15.7 KB
  • blueprints/camera-journey.md13.3 KB
  • blueprints/comparison-split.md3.2 KB
  • blueprints/constellation-hub.md7.0 KB
  • blueprints/cta-morph-press.md6.3 KB
  • blueprints/cursor-ui-demo.md19.8 KB
  • blueprints/dataviz-countup.md14.3 KB
  • blueprints/device-surface-showcase.md16.7 KB
  • blueprints/fixed-anchor-cycle.md8.9 KB
  • blueprints/grid-card-assemble.md15.2 KB
  • blueprints/kinetic-type-beats.md28.5 KB
  • blueprints/logo-assemble-lockup.md26.0 KB
  • blueprints/overwhelm-surround.md6.0 KB
  • blueprints/panel-edit-live-sync.md13.1 KB
  • blueprints/prompt-type-submit-generate.md18.2 KB
  • blueprints/spatial-pan-stations.md4.8 KB
  • blueprints/ticker-takeover.md3.0 KB
  • blueprints/titlecard-reveal.md7.3 KB
  • blueprints/transcript-scroll-artifact-reveal.md11.4 KB
  • blueprints/typewriter-reveal.md6.1 KB
  • blueprints/video-text-pivot.md3.2 KB
  • blueprints/zoom-out-workspace-reveal.md14.4 KB
  • examples/brand-reveal-assemble-zoom.html12.0 KB
  • examples/comparison-split-cards.html21.2 KB
  • examples/concept-demo-decode-pan.html18.0 KB
  • examples/cta-morph-press.html14.8 KB
  • examples/cta-orbit-collapse.html49.5 KB
  • examples/demo-page-scroll-spotlight.html24.4 KB
  • examples/hook-counter-burst.html22.5 KB
  • examples/messaging-multi-phrase.html11.9 KB
  • examples/metric-video-text-pivot.html25.0 KB
  • examples/problem-mockup-overwhelm.html43.4 KB
  • examples/proof-logo-chain.html28.2 KB
  • examples/takeover-ticker-displace.html10.7 KB
  • examples/workflow-approve-press.html20.2 KB
  • references/motion-blur.md13.8 KB
  • rules-index.md21.0 KB
  • rules/3d-camera-flight.md17.7 KB
  • rules/3d-page-scroll.md7.2 KB
  • rules/3d-text-depth-layers.md6.6 KB
  • rules/ai-tracking-box.md6.4 KB
  • rules/ambient-glow-bloom.md9.6 KB
  • rules/anchored-layout-expand.md10.1 KB
  • rules/asr-keyword-glow.md6.6 KB
  • rules/avatar-cloud-network.md6.4 KB
  • rules/camera-cursor-tracking.md7.7 KB
  • rules/card-morph-anchor.md7.2 KB
  • rules/center-outward-expansion.md4.2 KB
  • rules/chart-scrub-readout.md10.1 KB
  • rules/chromatic-glitch.md10.1 KB
  • rules/context-sensitive-cursor.md6.8 KB
  • rules/control-target-sync.md10.0 KB
  • rules/coordinate-target-zoom.md7.4 KB
  • rules/counting-dynamic-scale.md5.8 KB
  • rules/css-marker-patterns.md5.6 KB
  • rules/cursor-click-ripple.md6.2 KB
  • rules/cursor-drag.md10.0 KB
  • rules/depth-of-field-blur.md8.7 KB
  • rules/depth-scatter-assemble.md6.9 KB
  • rules/discrete-text-sequence.md6.3 KB
  • rules/dynamic-content-sequencing.md8.4 KB
  • rules/gradient-text-sweep.md8.5 KB
  • rules/gsap-effects.md6.8 KB
  • rules/hacker-flip-3d.md5.5 KB
  • rules/kinetic-beat-slam.md6.3 KB
  • rules/motion-blur-streak.md15.8 KB
  • rules/multi-cursor-choreography.md10.3 KB
  • rules/multi-phase-camera.md7.6 KB
  • rules/nudge-curve.md2.6 KB
  • rules/orbit-3d-entry.md6.5 KB
  • rules/particle-burst.md9.7 KB
  • rules/physics-press-reaction.md6.5 KB
  • rules/press-release-spring.md6.9 KB
  • rules/reactive-displacement.md6.4 KB
  • rules/scale-swap-transition.md5.4 KB
  • rules/sine-wave-loop.md6.0 KB
  • rules/split-tilt-cards.md5.5 KB
  • rules/spring-pop-entrance.md6.4 KB
  • rules/stat-bars-and-fills.md5.4 KB
  • rules/svg-icon-enrichment.md7.4 KB
  • rules/svg-path-draw.md5.5 KB
  • rules/theme-crossfade-morph.md9.2 KB
  • rules/vertical-spring-ticker.md5.4 KB
  • rules/viewport-change.md8.8 KB
  • rules/waterfall-entry.md4.5 KB
  • scripts/animation-map-sampling.mjs1.4 KB
  • scripts/animation-map-sampling.test.mjs1.6 KB
  • scripts/animation-map.mjs22.8 KB
  • scripts/animation-map.test.mjs18.9 KB
  • scripts/package-loader.mjs14.1 KB
  • scripts/package-loader.test.mjs4.2 KB
  • techniques.md17.0 KB
  • transitions/catalog.md6.5 KB
  • transitions/css-3d.md421 B
  • transitions/css-blur.md1.7 KB
  • transitions/css-cover.md1.4 KB
  • transitions/css-destruction.md4.4 KB
  • transitions/css-dissolve.md2.4 KB
  • transitions/css-distortion.md1.8 KB
  • transitions/css-grid.md370 B
  • transitions/css-light.md2.3 KB
  • transitions/css-mechanical.md1.6 KB
  • transitions/css-other.md838 B
  • transitions/css-push.md1.2 KB
  • transitions/css-radial.md1.0 KB
  • transitions/css-scale.md715 B
  • transitions/overview.md13.5 KB
  • transitions/TRANSITION-REGISTRY.md8.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Plugin installs: Before setup or freshness commands, follow plugin execution rules when this skill is inside a HyperFrames plugin. Standalone installs keep the update instructions below.

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/<id>.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 / tagrules-index.md
Read one rule's full HTML / CSS / GSAP reciperules/<name>.md
Pick a multi-phase scene templateblueprints-index.md
Read one blueprint's full recipeblueprints/<id>.md
Author a scene transition (CSS-driven, between two clips)transitions/overview.md, transitions/catalog.md
Look up a broader motion-design techniquetechniques.md
Motion blur — shutter smear on an element, and when not to use itreferences/motion-blur.md
Analyze an existing composition's animation mapscripts/animation-map.mjs
GSAP API — timeline / tweens / position parametersadapters/gsap.md
GSAP — drop-in effect recipesrules/gsap-effects.md
GSAP — transforms / perfadapters/gsap-transforms-and-perf.md
GSAP — eases / staggeradapters/gsap-easing-and-stagger.md
GSAP — timeline / labelsadapters/gsap-timeline-and-labels.md
Lottie / dotLottie (After Effects exports, window.__hfLottie)adapters/lottie.md
Character animation (walk cycle, mascot, jointed puppet, gestures)adapters/lottie.md → Characters
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), including characters that walk, gesture or react.
  • 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 → One paused timeline + Non-negotiable rules (single paused timeline, data-duration governs length, no Math.random / Date.now / performance.now, no repeat: -1 without a finite root data-duration, no page-load gsap.set on later-scene clips, no display or raw visibility tweens, and register the timeline only after it is fully built, including when the build runs inside an async callback such as document.fonts.ready). 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

node <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.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=<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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Create a 12-second title animation in HyperFrames, where sweeping leaves reveal two headlines. Customize typography, leaf counts, sweep speed, background color, and the breeze moving the leaves that remain on the text.

  • Create a nature-themed video opening
  • Reveal two headlines in sequence
  • Adjust leaf movement to suit a title
heygen-com/hyperframes66.7KUpdated Oct 18, 2026

captions-overlay

FreeSummary

Plan subtitles as layers over a video, deciding which spoken phrases to omit, show normally, or emphasize behind the subject. The guidance preserves full-frame composition and limits large embedded words to occasional key moments.

  • Planning subtitles for a talking-head video
  • Choosing words to emphasize behind the subject
  • Centering a scene that carries subtitles
heygen-com/hyperframes66.7KUpdated Oct 18, 2026

changelog-video

FreeSummary

Turn a weekly Markdown changelog into a branded video project with animated interface examples, Annie narration, captions, and background music. The workflow selects key updates and builds a 45–60 second square video, with rendering performed on request.

  • Turn weekly release notes into a short video
  • Demonstrate product updates with animated interface examples
  • Prepare a branded update video with narration and captions
heygen-com/hyperframes66.7KUpdated Oct 18, 2026

code-slice-hero

FreeSummary

Add an eight-second HyperFrames headline animation where square tiles lift, tilt, and flip to reveal a second message. Customize both headlines and 18 settings covering tile size, sweep direction, timing, depth, bounce, and shadows.

  • Reveal a second headline through flipping tiles
  • Create an animated opening for a promotional video
  • Adjust tile depth and shadows to suit a design
heygen-com/hyperframes66.7KUpdated Oct 18, 2026

cuboid-carousel

FreeSummary

Add a 3D card carousel to a HyperFrames video. Rounded cuboids enter from the right, rotate in sequence, pause on a featured card, and exit left, with 40 variables for content, geometry, lighting, and camera settings.

  • Presenting multiple cards in a 3D carousel
  • Pausing on a featured card
  • Replacing card content with JSON
heygen-com/hyperframes66.7KUpdated Oct 18, 2026

cut-the-curve

FreeSummary

Design scene transitions and animated text using matched movement direction and speed across cuts. The catalog provides concrete settings for zooms, blur, word-by-word transitions, staggered entrances, and repositioning groups of elements.

  • Connect scenes with matching motion
  • Transition between headlines word by word
  • Bring title elements in with staggered timing
heygen-com/hyperframes66.7KUpdated Oct 18, 2026

See all skills by heygen-com

Report a problem with this skill