Communitygithub.com

heygen-com/gsap

GSAP 動畫參考指南,專為 HyperFrames 設計。涵蓋 gsap.to()、from()、fromTo()、緩動、交錯、預設值、時間軸(gsap.timeline()、位置參數、標籤、嵌套、播放控制)及效能優化(轉換、will-change、quickTo)。適用於在 HyperFrames 合成中撰寫 GSAP 動畫。

gsap 是什麼?

此技能提供完整的 GSAP 動畫參考,專為 HyperFrames 環境優化。它詳細介紹了 GSAP 的核心功能,包括基礎補間方法(gsap.to()、from()、fromTo())、緩動函數、交錯效果以及全局預設值的設定。此外,還深入探討時間軸的進階用法,如 gsap.timeline() 的位置參數、標籤、嵌套時間軸與播放控制。最後,技能也涵蓋效能最佳化技巧,例如推薦使用 transform 屬性、will-change 提示以及 quickTo 幫助函式。無論是動畫新手還是進階使用者,都能透過此參考快速找到符合 HyperFrames 語法的實作範例。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/main/skills/gsap

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

gsap 是做什麼的?

適用於 HyperFrames 的 GSAP 動畫參考指南。涵蓋 gsap.to()、from()、fromTo()、緩動、交錯、預設值、時間軸(gsap.timeline()、位置參數、標籤、嵌套、播放控制)及效能優化(轉換、will-change、quickTo)。在撰寫 HyperFrames 合成中的 GSAP 動畫時,請使用此指南。

基礎補間方法

  • gsap.to():從當前狀態動畫到目標值。
  • gsap.from():從起始值動畫到當前狀態。
  • gsap.fromTo():同時定義起始與結束值。

緩動函數

支援的緩動類型包含 power1、power2、power3、power4、back、elastic 等。可搭配 ease 屬性使用。

交錯與預設值

  • 交錯:透過 stagger 屬性為多個元素建立時間差動畫。
  • 預設值:使用 gsap.defaults() 設定全域預設屬性。

時間軸

  • gsap.timeline():建立依序播放的動畫序列。
  • 位置參數:在 to() 等方法中使用 "<"、"+=0.5" 等參數控制相對時間。
  • 標籤:透過 addLabel() 在時間軸上設定標記點。
  • 嵌套時間軸:可將子時間軸加入主時間軸。
  • 播放控制:提供 play()、pause()、reverse()、seek() 等方法。

效能優化

  • 轉換:優先使用 x、y、scale、rotation 等 transform 屬性,以觸發 GPU 加速。
  • will-change:對即將動畫的元素設定 will-change: transform。
  • quickTo:使用 gsap.quickTo() 建立高效能的函式,反覆觸發動畫。

使用範例

// 基本 to 動畫
gsap.to(".box", { duration: 1, x: 100, ease: "power2.out" });

// 時間軸
gsap.timeline()
  .to(".box", { duration: 1, x: 100 })
  .to(".box", { duration: 1, y: 100 }, "+=0.5");

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

general-video

>

heygen-com/animejs

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

heygen-com/claude-design-hyperframes

Use when running inside Claude Design specifically. Produces a valid, brand-accurate HyperFrames video draft using pre-valid skeletons. For Claude Code / Cursor / Codex, use the `hyperframes` skill instead.

heygen-com/contribute-catalog

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

heygen-com/css-animations

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

heygen-com/hyperframes

Leaves sweep through the frame and part to reveal the headline. HyperFrames block, 1920×1080, 12s, 11 variables.

heygen-com/hyperframes

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

heygen-com/hyperframes

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

heygen-com/hyperframes

Glass shards fly in through fog and tile themselves into the headline. HyperFrames block, 1920×1080, 12.16s, 19 variables.

heygen-com/hyperframes

An orbiting camera follows an ice logo as it breaks apart, reforms into two text moments, and fades. HyperFrames block, 1920×1080, 22.5s, 216 variables.

heygen-com/hyperframes

A single feature card orbits a dot sphere on approved Blender camera motion. HyperFrames block, 1920×1080, 10s, 4 variables.

heygen-com/hyperframes

A wireframe portal bursts open, the title comes through, then its letters swap into a second phrase. HyperFrames block, 1920×1080, 8s, 9 variables.

heygen-com/hyperframes

House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.

heygen-com/hyperframes

A chain of bevelled cuboids rides a travelling wave as a content carousel. HyperFrames block, 1920×1080, 6.666666666666667s, 40 variables.

heygen-com/hyperframes

A tiled headline surface flips cell by cell under a sweeping depth field to reveal the rear headline. HyperFrames block, 1920×1080, 8s, 18 variables.

heygen-com/hyperframes

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

heygen-com/hyperframes

name: embedded-captions

heygen-com/hyperframes

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

heygen-com/hyperframes

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

heygen-com/hyperframes

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

相關技能