Communitygithub.com

heygen-com/hyperframes

一個特徵卡片環繞點狀球體,使用經核准的 Blender 攝影機動態。HyperFrames 區塊,1920×1080,10 秒,4 個變數。

hyperframes 是什麼?

這個 HyperFrames 技能建立了一個名為「orbit-card」的合成動畫,其中一個特徵卡片會從右側入場,繞著一個點狀球體旋轉一圈,然後從左側離場。整個動畫時長 10 秒,解析度為 1920×1080,以 30 fps 運作。它使用由 Blender 匯出的攝影機路徑與曲線,並搭配 GSAP 動畫庫來確保精確的逐格控制。技能支援 4 個可調整的變數:卡片標題、描述、強調色及軌道旋轉角度(範圍 -36000° 至 36000°)。安裝方式非常簡單,只需透過 `npx hyperframes add orbit-card` 命令即可,之後可在 HTML 中以 `data-composition-id` 屬性嵌入。它主要用於 HyperFrames 平台,透過 `hf-seek` 自訂事件實現時間同步,並保證所有視覺狀態皆為時間的閉合函數,確保「尋軌安全」(seek-safety),因此適用於精確的渲染與預覽工作流程。

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

在你喜歡的 AI 中提問

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

說明文件

軌道卡片

一張置中的特徵卡片,中央有圓形鏤空,框架一個點狀球體。卡片從右側入場(0.25–1.80 秒),停留時帶有微弱的擺動與深度漂移,繞球體中心完成一整圈軌道(在 4.97 到 5.97 秒之間使用平滑步進),然後從左側離場(7.35–8.55 秒)。攝影機路徑與卡片 F 曲線是從經核准的 Blender 骨架以 30 fps 匯出並插值;球體保留自身的平移與恆定旋轉。標題、描述、強調色與軌道角度皆為變數;180° 與 720° 無需觸碰關鍵影格即可運作。

合成 ID:orbit-card。時長 10 秒,30 fps,1920×1080。

檔案

  • orbit-card.html(3 KB)
  • assets/Archivo-LICENSE.txt(4 KB)
  • assets/Three-LICENSE.txt(1 KB)
  • assets/archivo-regular.ttf(108 KB)
  • assets/archivo-semibold.ttf(109 KB)
  • assets/gsap-3.14.2.min.js(128 KB)
  • assets/GSAP-NOTICE.txt(1 KB)
  • assets/orbit-motion.js(59 KB)
  • assets/orbit-scene.js(8 KB)
  • assets/three.core.min.js(554 KB)
  • assets/three.module.min.js(468 KB)

安裝

使用 npx hyperframes add orbit-card 安裝;預設情況下上述檔案會放到 compositions/orbit-card/ 目錄下。接著從主機 index.html 中掛載區塊:

<div
  data-composition-id="orbit-card"
  data-composition-src="compositions/orbit-card/orbit-card.html"
  data-start="0"
  data-duration="10"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

若要使用自訂值進行渲染,可直接指定合成檔案:

npx --yes [email protected] render 'compositions/orbit-card/orbit-card.html' --variables '{"feature1Title":"Always in sync","feature1Desc":"Changes reach every screen the moment they happen."}'

變數

在執行時期透過 window.__hyperframes.getVariables() 讀取;在合成根元素上以 data-composition-variables 屬性宣告(單引號屬性,純 JSON)。

id類型預設值標籤 / 範圍
feature1Title字串"Always in sync"卡片標題最多 28 個字元
feature1Desc字串"Changes reach every screen the moment they happen."卡片描述最多 110 個字元
feature1Accent顏色"#4cc9ff"卡片強調色
cardOrbitDegrees數字360卡片軌道度數 -36000–36000 步進 1

執行時期契約

  • 一條已暫停的 GSAP 時間軸,註冊為 window.__timelines["orbit-card"]。
  • 在 hf-seek 自訂事件觸發時重新同步;每個影格皆是時間的閉合函數(僅使用種子偽亂數,無 rAF 迴圈,無 Date.now)。
  • 渲染器:GSAP。
  • 外部執行時期依賴:無(本地提供)。
  • 本機字型:assets/archivo-regular.ttf、assets/archivo-semibold.ttf。

編輯規則(來自原始專案)

  1. 保持 data-composition-variables 為單引號屬性,內含純 " JSON。切勿透過 Studio 的設計面板儲存。
  2. 不要在靜態標記中放置 <canvas>;應在執行時期建立。
  3. 保持所有視覺狀態為 t 的函數;尋軌安全性是讓區塊可渲染的關鍵。

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/gsap

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

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

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

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

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

name: embedded-captions

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

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

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

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.

相關技能