Communitygithub.com

MattiaIppoliti/tia-skills

所有關於 HyperFrames 動畫的知識 — 原子級運動規則、多階段場景藍圖、場景轉場、更廣泛的動態設計技術,以及七個運行時期適配器(預設 GSAP,加上 Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API、TypeGPU)。可應用於任何動畫任務:選取 2-4 個規則進行組合、載入藍圖,或查詢特定運行時期的 API。

tia-skills 是什麼?

此技能為 HyperFrames 動畫系統的完整知識庫,涵蓋從原子級運動規則、多階段場景藍圖、場景轉場到高階動態設計技術。它支援七種運行時期適配器,包括預設的 GSAP,以及 Lottie(After Effects 匯出)、Three.js(3D 場景與 WebGL)、Anime.js(輕量補間)、CSS 關鍵影格、Web Animations API(WAAPI)和 TypeGPU(WebGPU 渲染)。技能提供了一個以規則為基礎的作曲方法,可快速組合 2-4 個原子規則,或載入預先設計的藍圖以實現複雜的多階段編排。此外,還包含一個動畫地圖腳本,用於審查現有作品的編排(死區、重複一致性、生命週期警告)。此技能專為 HyperFrames 設計,其特點是單一暫停的時間軸、可尋址且確定性強,但其文件已明確指出與最新的 Remotion+React 輸出框架存在程式碼不相容性,需要使用者相應地轉換範例。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/hyperframes-animation

在你喜歡的 AI 中提問

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

說明文件

⚠ 合約狀態:工藝是現行的,程式碼不是

此技術堆疊的輸出框架是 Remotion + React (/hyperframes-core)。 這裡的運動工藝仍然適用:時間、緩動選擇、動作的形狀、命名的規則和藍圖。 程式碼則不適用:範例和適配器是針對已淘汰的 HTML + 暫停 GSAP 時間軸運行時期編寫的。

閱讀時請自行轉換:

此處在 Remotion 中
gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})
ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), 透過肉眼調校
位於 window.__timelines[id] 的暫停時間軸沒有;每個值都是 useCurrentFrame() 的函數
片段上的 data-start / data-duration<Sequence from> / durationInFrames,以影格為單位
CSS 關鍵影格或轉場基於影格的內聯 style(CSS 動畫無法渲染)

切勿將此技能中的任何範例未經修改地貼到 Remotion 專案中。

HyperFrames 動畫

所有動畫知識濃縮於此技能中:規則(原子級配方)、藍圖(多階段場景模板)、轉場(場景到場景)、技術(更廣泛的動態設計模式)以及適配器(各運行時期的 API)。

關於合成合約(資料屬性、子合成、確定性),請參閱 hyperframes-core。

預設:組合原子級規則

從 rules-index.md 中挑選 2-4 個規則,用一個單一的暫停 GSAP 時間軸將它們組合在一起,即可完成。這比從藍圖開始更快,且產生的程式碼更少。

何時載入藍圖

  • 場景符合現有的預先設計多階段模板(品牌揭露、社會證明等),並且重複使用其階段管線能節省實際創作時間
  • 你需要可運行的真實程式碼來實現一個複雜的 4-5 階段編排

藍圖位於 blueprints-index.md。每個條目指向 blueprints/<id>.md(配方)。請勿投機性地閱讀它;只有在你已決定需要場景層級的編排時才載入它。

路由

想要…閱讀
根據觸發條件/標籤挑選原子級運動模式rules-index.md
閱讀一個規則的完整 HTML / CSS / GSAP 配方rules/<name>.md
挑選一個多階段場景模板blueprints-index.md
閱讀一個藍圖的完整配方blueprints/<id>.md
編寫一個場景轉場(CSS 驅動,在兩個片段之間)transitions/overview.md, transitions/catalog.md
查詢更廣泛的動態設計技術techniques.md
分析現有合成的動畫地圖scripts/animation-map.mjs
GSAP API — 時間軸 / 補間 / 位置參數adapters/gsap.md
GSAP — 即插即用的效果配方rules/gsap-effects.md
GSAP — 變換 / 效能adapters/gsap-transforms-and-perf.md
GSAP — 緩動 / 交錯adapters/gsap-easing-and-stagger.md
GSAP — 時間軸 / 標籤adapters/gsap-timeline-and-labels.md
Lottie / dotLottie(After Effects 匯出,window.__hfLottie)adapters/lottie.md
Three.js / WebGL(3D 場景,AnimationMixer,hf-seek)adapters/three.md
Anime.js(window.__hfAnime)adapters/animejs.md
CSS 關鍵影格(animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API(element.animate(),currentTime 搜尋)adapters/waapi.md
TypeGPU / WebGPU(navigator.gpu,WGSL,計算管線)adapters/typegpu.md
HTML 作為紋理 + WebGL/GLSL 後期特效(透過 drawElementImage 捕捉即時 DOM)adapters/html-in-canvas-patterns.md
命名的文字動畫效果(透過外部 animate-text 技能的 24 個 ID)adapters/animate-text.md

選擇運行時期

  • GSAP 是 95% 動畫工作的預設選項 — 涵蓋時間軸編排、變換、緩動、交錯。此技能中所有原子級規則都基於 GSAP。
  • Lottie 當素材具有其預先烘焙的時間軸時使用(通常是 After Effects 匯出)。
  • Three.js 用於 3D 場景、攝影機運動、著色器驅動的視覺效果。
  • Anime.js 用於在 GSAP 過於強大的情況下進行輕量補間。
  • CSS 用於簡單的重複主題、裝飾、微光 — 無 JavaScript 動畫成本。
  • WAAPI 用於在沒有 GSAP 依賴的情況下使用原生瀏覽器關鍵影格。
  • TypeGPU / WebGPU 用於 GPU 渲染的畫布(粒子、液體玻璃、自訂著色器)。

多個運行時期可以在一個合成中並存。每個運行時期會將其實例註冊在運行時期特定的全域變數上,以便 HyperFrames 可以在一次遍歷中搜尋所有實例。

關鍵限制

先決條件:hyperframes-core → 不可協商的規則(單一暫停時間軸,data-duration 控制長度,禁止 Math.random / Date.now / performance.now,禁止 repeat: -1,禁止在後續場景的片段上執行頁面載入時的 gsap.set,禁止 display 或原始 visibility 補間,禁止在 async / setTimeout / Promise 內部建立時間軸)。在明確的時間軸邊界使用 GSAP 的 autoAlpha 和零持續時間的可見性設定仍然是核心所允許的。僅在非片段元素或片段內部的包裝器上使用這些例外情況;框架擁有 .clip 的生命週期。請勿在此處重述完整的合約。

在核心合約基礎上新增的動畫工藝限制:

  • 預先計算的佈局常數 — 絕不在補間時從 getBoundingClientRect() 推導位置。補間時的 DOM 測量會因渲染器並行取樣而不同步;在合成設定時一次性計算座標並重複使用。
  • 空間運動僅使用 GSAP 變換別名(x, y, scale, rotation)。核心允許清單也允許對非空間屬性補間使用 opacity / color / backgroundColor / borderRadius — 但絕不允許使用 width / height / top / left 進行佈局變更。

腳本

node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

讀取所有註冊在 window.__timelines 上的 GSAP 時間軸,列舉補間,取樣邊界框,計算標誌,輸出 animation-map.json。用它來在創作後審查編排(死區、交錯一致性、生命週期警告)。

animation-map.mjs 會先從目前專案解析輔助套件,然後可以引導捆綁的 HyperFrames 套件版本。僅在捆綁的 CLI/技能安裝之外執行此技能,且需要明確固定該引導版本時,才設定 HYPERFRAMES_SKILL_PKG_VERSION=<version>。

參閱

  • hyperframes-core — 合成結構、資料屬性、子合成、確定性渲染合約
  • hyperframes-creative — 調色盤、字體排印、敘事、節拍規劃(非動畫的創意指導)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

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

MattiaIppoliti/tia-skills

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]

MattiaIppoliti/tia-skills

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.

MattiaIppoliti/tia-skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

相關技能