Communitygithub.com

heygen-com/hyperframes

树叶扫过画面并分开,露出标题。HyperFrames 区块,1920×1080,12秒,11个变量。

hyperframes 是什么?

Canopy Part Title 是一个 HyperFrames 区块,设计用于在视频或动画中创建引人注目的开场效果。它通过一层纹理树叶扫过画面(浅景深),然后分开露出第一个标题;接着,第二批深度提升的树叶将第二个标题带过镜头。少量树叶会留在标题上,保持微风吹动效果。该技能支持 1920×1080 分辨率、12 秒时长,并提供 11 个可配置变量,包括字体、字重、字号、字间距、树叶数量、扫描速度以及留在标题上的树叶数量。它基于 three.js 和 GSAP 构建,采用封闭形式的时间函数实现实时渲染,确保帧级精确和seek安全性。适用于 HeyGen HyperFrames 生态、Claude Code 或 Cursor 等 AI 代理工具,通过简单的 HTML 标签或命令行工具进行安装和渲染。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/main/registry/blocks/canopy-part-title

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

树冠标题

一个由纹理树叶组成的浓密树冠,以浅景深扫过画面,然后分开露出第一个标题;第二批深度提升的树叶将第二个标题带过镜头。少量树叶留在文字上,保持微风吹动效果。字体、字重、字号、字间距、树叶数量、扫描速度以及留在上面的树叶数量均为变量。

组成 ID:canopy-part-title。时长 12 秒,30 fps,1920×1080。

文件

  • canopy-part-title.html(57 KB)
  • assets/leaf-surface-color.webp(64 KB)
  • assets/leaf-surface-normal.webp(136 KB)

安装

使用 npx hyperframes add canopy-part-title 安装;默认情况下,上述文件会放在 compositions/canopy-part-title/ 目录下。然后在宿主 index.html 中挂载该区块:

<div
  data-composition-id="canopy-part-title"
  data-composition-src="compositions/canopy-part-title/canopy-part-title.html"
  data-start="0"
  data-duration="12"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

通过直接指定组成文件进行渲染并使用自定义值:

npx --yes [email protected] render 'compositions/canopy-part-title/canopy-part-title.html' --variables '{"headline1":"Understory","headline2":"Move slowly"}'

变量

运行时通过 window.__hyperframes.getVariables() 读取;在组成根元素上声明为 data-composition-variables(单引号属性,纯 JSON)。

id类型默认值标签 / 范围
headline1string"Understory"标题 1
headline2string"Move slowly"标题 2
fontstring"Helvetica"标题字体
fontWeightnumber900字重 100–900 步长 100
fontSizenumber1字号(1 = 自适应)0.3–2 步长 0.01
letterSpacingnumber0.01字间距(em)-0.2–1 步长 0.01
backgroundcolor"#020805"背景色
leafCountnumber170每轮扫过的树叶数量 40–320 步长 1
stayCountnumber5留在上面的树叶数量 0–20 步长 1
sweepSpeednumber1扫描速度 0.3–3 步长 0.05
retainedBreezenumber1留在上面的树叶微风效果 0–2 步长 0.05

运行时约定

  • 一个暂停的 GSAP 时间线注册为 window.__timelines["canopy-part-title"]。
  • 通过 hf-seek 自定义事件重新同步;每一帧都是时间的封闭形式函数(仅使用种子 PRNG,无 rAF 循环,无 Date.now)。
  • 渲染器:three.js 0.170.0,GSAP 3.14.2,Canvas 2D,后期处理,种子 PRNG,阴影映射。每个实时实例预算约 350 MB;建议一次只运行一个。
  • 外部运行时依赖:https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js,https://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js,https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/EffectComposer.js,https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/RenderPass.js,https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/BokehPass.js。
  • 来自 Google Fonts 的 Web 字体:Gelasio。

编辑规则(来自源项目)

  1. 保持 data-composition-variables 为单引号属性,使用纯 " JSON。切勿通过 Studio 的设计面板保存它。
  2. 不要在静态标记中放入 <canvas>;在运行时创建它。
  3. 保持每个视觉状态为时间 t 的函数;seek 安全性是区块可渲染的关键。

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

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

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

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

Glass shards fly in through fog and tile themselves into the headline. HyperFrames block, 1920×1080, 12.16s, 19 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

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

name: embedded-captions

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

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.

相关技能