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.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- hyperframes-animation
- 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.
02 资源文件 101
- 参考文档adapters/animate-text.md4.0 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.6 KB
- 参考文档adapters/gsap-transforms-and-perf.md8.4 KB
- 参考文档adapters/gsap.md7.4 KB
- 参考文档adapters/html-in-canvas-patterns.md16.8 KB
- 参考文档adapters/lottie.md4.0 KB
- 参考文档adapters/three.md5.1 KB
- 参考文档adapters/typegpu.md7.9 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
- 参考文档rules-index.md20.7 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.3 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.md10.4 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
- 参考文档techniques.md15.4 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.md7.9 KB
03 SKILL.md 正文
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 / tag | rules-index.md |
| Read one rule's full HTML / CSS / GSAP recipe | rules/<name>.md |
| Pick a multi-phase scene template | blueprints-index.md |
| Read one blueprint's full recipe | blueprints/<id>.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 permitsopacity/color/backgroundColor/borderRadiusfor non-spatial property tweens — but neverwidth/height/top/leftfor layout changes.
Scripts
node skills/hyperframes-animation/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 contracthyperframes-creative— palettes, typography, narration, beat planning (non-animation creative direction)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.