Agent Skills
› heygen-com/hyperframes
› cuboid-carousel
cuboid-carousel
GitHub提供基于Three.js和GSAP的3D圆角长方体轮播动画组件，支持自定义卡片内容、几何参数及缓动效果，适用于前端视觉展示。
Trigger Scenarios
需要3D轮播或滑块效果
前端可视化展示需求
集成HyperFrames动画组件
Install
npx skills add heygen-com/hyperframes --skill cuboid-carousel -g -y
SKILL.md
Frontmatter
{
"name": "cuboid-carousel",
"description": "A chain of bevelled cuboids rides a travelling wave as a content carousel. HyperFrames block, 1920×1080, 6.666666666666667s, 40 variables."
}
Cuboid Carousel
Rounded, bevelled cuboids carrying card content fly in from the right as one rigid group, cruise with a per-cuboid rotation stagger, decelerate to a hero hold, then exit left. Spacing is derived from the cuboid dimensions and the largest reachable X half-extent, so cuboids can never overlap. Forty variables carry the original DialKit schema: geometry, materials, lights, shadows, backdrop, camera and every segment duration and easing. Cards come from the built-in list or a JSON variable.
Composition id: cuboid-carousel. Duration 6.666666666666667 s at 30 fps, 1920×1080.
Files
cuboid-carousel.html(38 KB)assets/Three-LICENSE.txt(1 KB)assets/addons/environments/RoomEnvironment.js(5 KB)assets/addons/utils/BufferGeometryUtils.js(36 KB)assets/cuboid-motion.js(593 KB)assets/gsap-3.14.2.min.js(128 KB)assets/GSAP-NOTICE.txt(1 KB)assets/three.core.min.js(554 KB)assets/three.module.min.js(468 KB)
Install
Install with npx hyperframes add cuboid-carousel; by default the files above land under compositions/cuboid-carousel/. Then mount the block from the host index.html:
<div
data-composition-id="cuboid-carousel"
data-composition-src="compositions/cuboid-carousel/cuboid-carousel.html"
data-start="0"
data-duration="6.666666666666667"
data-track-index="1"
data-width="1920"
data-height="1080"
></div>
Render with custom values by targeting the composition file directly:
npx --yes hyperframes@0.8.12 render 'compositions/cuboid-carousel/cuboid-carousel.html' --variables '{"cardsJson":"","heroCard":4}'
Variables
Read at runtime via window.__hyperframes.getVariables(); declared on the composition root as data-composition-variables (single-quoted attribute, plain JSON).
| id | type | default | label / range |
|---|---|---|---|
cardsJson |
string | "" |
Content · Cards JSON (optional, see CARDS in source) |
heroCard |
number | 4 |
Content · Hero card (1-based) 1–12 step 1 |
count |
number | 8 |
Content · Repeating card count 1–12 step 1 |
gap |
number | 0.01 |
Layout · Extra gap between cuboids 0–1.5 step 0.005 |
cuboidWidth |
number | 1.7 |
Cuboid · Width 0.3–5 step 0.01 |
cuboidHeight |
number | 2.4 |
Cuboid · Height 0.3–6 step 0.01 |
cuboidDepth |
number | 0.14 |
Cuboid · Thickness (depth) 0.02–2 step 0.01 |
cornerRadius |
number | 0.105 |
Cuboid · Corner radius 0–0.6 step 0.005 |
bevelSize |
number | 0.03 |
Cuboid · Bevel size (edge chamfer) 0–0.3 step 0.001 |
bevelThickness |
number | 0.04 |
Cuboid · Bevel thickness 0–0.3 step 0.001 |
smoothness |
number | 32 |
Cuboid · Smoothness (segments) 1–32 step 1 |
bodyColor |
color | "#242424" |
Cuboid · Body colour |
roughness |
number | 0.6 |
Cuboid · Roughness 0–1 step 0.01 |
metalness |
number | 0.4 |
Cuboid · Metalness 0–1 step 0.01 |
heroScale |
number | 1 |
Hero · Isolated scale 1–1.6 step 0.01 |
heroFillIntensity |
number | 0.55 |
Hero · Face light intensity 0–2 step 0.05 |
heroExitX |
number | 288 |
Hero · Exit X rotation degrees -720–720 step 1 |
heroExitY |
number | -234 |
Hero · Exit Y rotation degrees -720–720 step 1 |
heroExitZ |
number | 198 |
Hero · Exit Z rotation degrees -720–720 step 1 |
ambientIntensity |
number | 0.35 |
Lights · Ambient intensity 0–4 step 0.01 |
ambientColor |
color | "#ffffff" |
Lights · Ambient colour |
topIntensity |
number | 3.1 |
Lights · Top rig intensity 0–12 step 0.05 |
topColor |
color | "#ffffff" |
Lights · Top rig colour |
bottomIntensity |
number | 2.15 |
Lights · Bottom rig intensity 0–12 step 0.05 |
bottomColor |
color | "#ffcaad" |
Lights · Bottom rig colour |
keyIntensity |
number | 5 |
Lights · Key rig intensity 0–12 step 0.05 |
keyColor |
color | "#ffe9d6" |
Lights · Key rig colour |
shadowRadius |
number | 44.5 |
Shadows · Softness at map size 2048 0–50 step 0.5 |
shadowMapSize |
number | 2048 |
Shadows · Map size 512–4096 step 256 |
backdrop |
color | "#0b0d13" |
Background · Colour |
cameraFov |
number | 11 |
Camera · Initial Field of view 10–90 step 0.5 |
cameraX |
number | -1.65 |
Camera · Initial X -20–20 step 0.05 |
cameraY |
number | 8.5 |
Camera · Initial Y -20–20 step 0.05 |
cameraZ |
number | -8.508708 |
Camera · Initial Z (distance) -20–50 step 0.1 |
cameraSettleFrame |
number | 70 |
Camera · Settle frame (30 fps) 20–90 step 1 |
handheldStrength |
number | 1 |
Camera · Handheld hold strength 0–1 step 0.05 |
cameraTargetFov |
number | 34 |
Camera target · Field of view 10–90 step 0.5 |
cameraTargetX |
number | -7.25 |
Camera target · X -20–20 step 0.05 |
cameraTargetY |
number | 1.15 |
Camera target · Y -20–20 step 0.05 |
cameraTargetZ |
number | 6.2 |
Camera target · Z 2–50 step 0.1 |
Runtime contract
- One paused GSAP timeline registered as
window.__timelines["cuboid-carousel"]. - Re-syncs on the
hf-seekCustomEvent; every frame is a closed-form function of time (seeded PRNG only, no rAF loops, no Date.now). - Renderer: WebGL, GSAP, Canvas 2D, PMREM, Shadow maps. Budget roughly 350 MB per live instance; run one at a time.
- External runtime dependencies:
./assets/three.module.min.js,./assets/addons/. - Web fonts from Google Fonts: Inter.
Editing rules (from the source project)
- Keep
data-composition-variablesa single-quoted attribute with plain"JSON. Never save it through Studio's Design panel. - Do not put
<canvas>in static markup; create it at runtime. - Keep every visual state a function of t; seek-safety is what makes the block renderable.
Version History
- a80d733 Current 2026-09-22 11:11
