Communitygithub.com

heygen-com/hyperframes

Une chaîne de cuboïdes biseautés chevauche une onde progressive en forme de carrousel de contenu. Bloc HyperFrames, 1920×1080, 6,666666666666667 s, 40 variables.

Qu'est-ce que hyperframes ?

Cette compétence, conçue pour la plateforme HyperFrames, implémente un carrousel de contenu 3D composé de cuboïdes arrondis et biseautés. Les cuboïdes, portant des cartes de contenu, volent depuis la droite en groupe rigide, défilent avec une rotation décalée par cuboïde, décélèrent pour une mise en valeur héroïque, puis sortent par la gauche. L'espacement est automatiquement calculé pour éviter tout chevauchement, en fonction des dimensions des cuboïdes et de leur demi-extension X maximale. Quarante variables permettent de contrôler la géométrie, les matériaux, l'éclairage, les ombres, l'arrière-plan, la caméra ainsi que chaque segment de l'animation temporelle. Le bloc est accessible via le HTML de l'hôte, peut être rendu avec des valeurs personnalisées et s'intègre totalement avec le runtime HyperFrames pour une lecture fiable (seek-safe). Les dépendances incluent Three.js, GSAP et des fichiers d'actifs locaux. Idéal pour les présentations vidéo, les vitrines de produits ou les séquences de marque.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/main/registry/blocks/cuboid-carousel

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Carrousel de Cuboïdes

Des cuboïdes arrondis et biseautés, portant des cartes de contenu, volent depuis la droite en un groupe rigide, défilent avec une rotation décalée par cuboïde, décélèrent pour une mise en valeur héroïque, puis sortent par la gauche. L'espacement est calculé à partir des dimensions des cuboïdes et de la plus grande demi-extension X atteignable, garantissant qu'ils ne se chevauchent jamais. Quarante variables reprennent le schéma DialKit original : géométrie, matériaux, lumières, ombres, arrière-plan, caméra et chaque durée et courbe d'animation. Les cartes proviennent d'une liste intégrée ou d'une variable JSON.

Identifiant de composition : cuboid-carousel. Durée 6,666666666666667 s à 30 ips, 1920×1080.

Fichiers

  • cuboid-carousel.html (38 Ko)
  • assets/Three-LICENSE.txt (1 Ko)
  • assets/addons/environments/RoomEnvironment.js (5 Ko)
  • assets/addons/utils/BufferGeometryUtils.js (36 Ko)
  • assets/cuboid-motion.js (593 Ko)
  • assets/gsap-3.14.2.min.js (128 Ko)
  • assets/GSAP-NOTICE.txt (1 Ko)
  • assets/three.core.min.js (554 Ko)
  • assets/three.module.min.js (468 Ko)

Installation

Installez avec la commande npx hyperframes add cuboid-carousel ; par défaut, les fichiers ci-dessus se placent sous compositions/cuboid-carousel/. Montez ensuite le bloc depuis le fichier index.html hôte :

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

Rendez avec des valeurs personnalisées en ciblant directement le fichier de composition :

npx --yes [email protected] render 'compositions/cuboid-carousel/cuboid-carousel.html' --variables '{"cardsJson":"","heroCard":4}'

Variables

Lues à l'exécution via window.__hyperframes.getVariables() ; déclarées sur la racine de la composition via data-composition-variables (attribut entre guillemets simples, JSON simple).

idtypedefaultlabel / plage
cardsJsonstring""Contenu · JSON des cartes (optionnel, voir CARTES dans la source)
heroCardnumber4Contenu · Carte héroïque (base 1) 1–12 pas 1
countnumber8Contenu · Nombre de cartes répétées 1–12 pas 1
gapnumber0,01Disposition · Espace supplémentaire entre cuboïdes 0–1,5 pas 0,005
cuboidWidthnumber1,7Cuboïde · Largeur 0,3–5 pas 0,01
cuboidHeightnumber2,4Cuboïde · Hauteur 0,3–6 pas 0,01
cuboidDepthnumber0,14Cuboïde · Épaisseur (profondeur) 0,02–2 pas 0,01
cornerRadiusnumber0,105Cuboïde · Rayon de coin 0–0,6 pas 0,005
bevelSizenumber0,03Cuboïde · Taille du biseau (chanfrein) 0–0,3 pas 0,001
bevelThicknessnumber0,04Cuboïde · Épaisseur du biseau 0–0,3 pas 0,001
smoothnessnumber32Cuboïde · Lissage (segments) 1–32 pas 1
bodyColorcolor"#242424"Cuboïde · Couleur du corps
roughnessnumber0,6Cuboïde · Rugosité 0–1 pas 0,01
metalnessnumber0,4Cuboïde · Métallisé 0–1 pas 0,01
heroScalenumber1Héroïque · Échelle isolée 1–1,6 pas 0,01
heroFillIntensitynumber0,55Héroïque · Intensité de la lumière faciale 0–2 pas 0,05
heroExitXnumber288Héroïque · Rotation X de sortie en degrés -720–720 pas 1
heroExitYnumber-234Héroïque · Rotation Y de sortie en degrés -720–720 pas 1
heroExitZnumber198Héroïque · Rotation Z de sortie en degrés -720–720 pas 1
ambientIntensitynumber0,35Lumières · Intensité ambiante 0–4 pas 0,01
ambientColorcolor"#ffffff"Lumières · Couleur ambiante
topIntensitynumber3,1Lumières · Intensité du montage supérieur 0–12 pas 0,05
topColorcolor"#ffffff"Lumières · Couleur du montage supérieur
bottomIntensitynumber2,15Lumières · Intensité du montage inférieur 0–12 pas 0,05
bottomColorcolor"#ffcaad"Lumières · Couleur du montage inférieur
keyIntensitynumber5Lumières · Intensité du montage clé 0–12 pas 0,05
keyColorcolor"#ffe9d6"Lumières · Couleur du montage clé
shadowRadiusnumber44,5Ombres · Douceur à la taille de la carte 2048 0–50 pas 0,5
shadowMapSizenumber2048Ombres · Taille de la carte 512–4096 pas 256
backdropcolor"#0b0d13"Arrière-plan · Couleur
cameraFovnumber11Caméra · Champ de vision initial 10–90 pas 0,5
cameraXnumber-1,65Caméra · Position X initiale -20–20 pas 0,05
cameraYnumber8,5Caméra · Position Y initiale -20–20 pas 0,05
cameraZnumber-8,508708Caméra · Position Z (distance) initiale -20–50 pas 0,1
cameraSettleFramenumber70Caméra · Image de stabilisation (30 ips) 20–90 pas 1
handheldStrengthnumber1Caméra · Force du maintien à main levée 0–1 pas 0,05
cameraTargetFovnumber34Cible caméra · Champ de vision 10–90 pas 0,5
cameraTargetXnumber-7,25Cible caméra · Position X -20–20 pas 0,05
cameraTargetYnumber1,15Cible caméra · Position Y -20–20 pas 0,05
cameraTargetZnumber6,2Cible caméra · Position Z 2–50 pas 0,1

Contrat d'exécution

  • Une timeline GSAP en pause, enregistrée sous window.__timelines["cuboid-carousel"].
  • Se resynchronise sur l'événement CustomEvent hf-seek ; chaque image est une fonction en temps fermé (PRNG ensemencé uniquement, pas de boucles rAF, pas de Date.now).
  • Rendu : WebGL, GSAP, Canvas 2D, PMREM, cartes d'ombres. Budget approximatif 350 Mo par instance active ; exécutez une instance à la fois.
  • Dépendances d'exécution externes : ./assets/three.module.min.js, ./assets/addons/.
  • Polices Web de Google Fonts : Inter.

Règles d'édition (du projet source)

  1. Gardez data-composition-variables en tant qu'attribut entre guillemets simples avec du JSON en ". Ne l'enregistrez jamais via le panneau de conception de Studio.
  2. Ne placez pas <canvas> dans le balisage statique ; créez-le à l'exécution.
  3. Gardez chaque état visuel fonction de t ; la sécurité de recherche est ce qui rend le bloc rendable.

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

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 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.

Skills associés