Communitygithub.com

heygen-com/hyperframes

Hausinterne Technik für übergroße macOS-Cursor in HyperFrames-Launchvideos. Wird geladen, wenn Szenen Cursor oder zeigergeführte Aktionen enthalten, UI-Szenen starten, Morphs/Übergänge/Tippvorgänge per Klick auslösen oder Szenen statisch, tot oder veraltet wirken und eine günstige, ergiebige Bewegungsquelle benötigen, um das Auge des Betrachters zu führen und aus dem trägen Zustand zu befreien. Deckt Cursorgröße und -aussehen (inkl. Marken-Motiv-Cursor), das Gesetz des Bildschirmeintritts, Zielspitzenausrichtung und Klick-Tap, den Klick als Zünder für den nächsten Beat sowie Exit/Canvas-Übergabe ab.

Was ist hyperframes?

Das Skill 'heygen-com/hyperframes' implementiert eine spezielle Technik für Launch-Videos: einen übergroßen macOS-artigen Cursor, der als sichtbarer Protagonist agiert. Er betritt die Szene von außerhalb des Bildschirms, führt das Auge des Betrachters zum nächsten Punkt, löst durch einen Klick die nächste Aktion aus und verlässt die Szene wieder. Die Motivation dahinter: Große Cursorbewegungen sind eine der günstigsten und effektivsten Bewegungsquellen in einem Launch-Video. Ein einzelnes Element mit Transformations-Tweens sorgt dafür, dass (1) das Auge über sonst leblose Szenen geführt wird, (2) Morphs und Übergänge einen kausalen Auslöser erhalten („Der Klick hat das bewirkt“) und (3) der Betrachter aus einem statischen Zustand herausgeführt wird, wenn eine neue Szene oder komplexe Animation startet. Größer ist besser – ein Cursor in Originalgröße verschwindet im Video-Maßstab. Das Skill ist plattformunabhängig konzipiert und wird typischerweise in Web-basierten Animationsumgebungen mit GSAP oder ähnlichen Bibliotheken eingesetzt. Es definiert präzise Regeln für Größe, Look, Eintritt, Zielausrichtung, Klick-Verhalten und Exit, um eine konsistente und hochwertige Benutzererfahrung zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/HEAD/.agents/skills/oversized-cursor

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Übergroßer Cursor – der Augenträger

Ein bewusst übergroßer macOS-artiger Zeiger, der als sichtbarer Protagonist durch das Bild reist: Er kommt von außerhalb des Bildschirms herein, führt das Auge des Betrachters zum nächsten Punkt, klickt, um das Nächste auszulösen, und verlässt die Szene wieder. Produktionserprobt in mehreren Launch-Filmen.

Warum es das gibt. Große Cursorbewegungen sind eine der günstigsten, aber ergiebigsten Bewegungsquellen in einem Launch-Video: ein Element, reine Transform-Tweens, und es (1) führt das Auge über Szenen, die sonst tot wirken würden, (2) gibt Morphs/Übergängen einen kausalen Auslöser („Der Klick hat das gemacht“) und (3) befreit das Auge aus einem statischen Zustand, wenn eine neue Szene oder eine komplexe Animation startet. Größer ist besser – ein Cursor in Originalgröße verschwindet im Video-Maßstab.

Größe & Aussehen (Hauskonvention)

  • Vollbild-Szenen: 7cqw (≈134px bei 1920). In-Mock-/Kleinbildvarianten: 4,6–5,5cqw. Niemals kleiner.
  • Eine SVG-Pfeilgeometrie überall. Zwei bewährte Füllungen – weißer Körper + schwarzer Strich oder schwarzer Körper (#1c1c1c) + weißer Strich (1,4px). Pro Szene nach Kontrast wählen, innerhalb eines Films konstant halten.
  • Marken-Motiv-Cursor (der Trumpf). Der macOS-Pfeil ist der STANDARD, kein Muss. Wenn die Marke des Themas eine erkennbare Cursor-Identität hat – ein farbiger Mehrspielerpfeil mit Namensschild (Figma-Stil), ein Präzisions-Fadenkreuz einer Kreativsuite, ein unverwechselbarer Produktzeiger – dann verwende DIESEN Cursor stattdessen: sofort verständliche Markensprache für jeden, der das Produkt kennt. Dieselben Regeln gelten unverändert (übergroßer Maßstab, physischer Ein-/Austritt, Zielspitzenausrichtung, Klickzündung), und eine Variante mit Namensschild bewegt sich als eine starre Einheit (das Schild folgt dem Pfeil). Greife nur dann darauf zurück, wenn das Motiv wirklich wiedererkennbar ist; ein Cursor, den niemand erkennt, ist nur ein seltsamer Pfeil – falle auf macOS zurück.
  • filter: drop-shadow(0 4px 6px rgba(0,0,0,.3)), pointer-events: none, z-index über allem Szeneninhalt, will-change: transform.
#root .cursor {
  position: absolute;
  left: 48%;
  top: 115%; /* außerhalb des Bildschirms unten – die Ruheposition IST außerhalb des Bildschirms */
  width: 7cqw;
  height: 7cqw;
  z-index: 20;
  filter: drop-shadow(0 4px 6px rgba(0, 0, 0, 0.3));
  pointer-events: none;
  will-change: transform;
}

Eintrittsgesetz – physisch, niemals eingeblendet

Der Cursor tritt immer von außerhalb des Bildschirms ein (kanonisch: von unten, top:115–120%) und gleitet in einer einzigen, verlangsamenden Bewegung zu seinem ersten Ziel. Es muss sich anfühlen, als sei er in den Raum gekommen. Blende ihn niemals opak an einer Ruheposition ein, enthülle ihn niemals per Maskierung – das wirkt wie ein Glitch (ein realer, wiederholt beobachteter Fehlermodus).

  • Standardpfad: senkrecht die y-Achse hoch zum Ziel – keine fragmentierten Diagonalen. Eine Diagonale ist in Ordnung, wenn sie ZUR GESCHICHTE gehört (Eintritt zu einem außermittigen Ziel), aber es ist in beiden Fällen ein einziger kontinuierlicher Vektor.
  • duration: 0,4–0,92s, ease: power3.out, immediateRender: false beim fromTo.
tl.fromTo(
  cursor,
  { left: "48,6%", top: "115%" },
  { left: "48,6%", top: "55%", duration: 0,85, ease: "power3.out", immediateRender: false },
  0,25,
);

Zielspitzenausrichtung & der Klick-Tap

Der Hotspot ist die PFEILSPITZE, nicht die Boxmitte. Setze die Spitze auf die Mitte des Ziels und richte alle Druck-Skalierungen auf die Spitze aus: transformOrigin: '21% 14%' (für den Haus-Pfeilpfad in einem 24-Einheiten-ViewBox).

Klick = asymmetrisches Stauchen/Strecken (Verhältnis 1:2 wirkt wie ein echter Tap):

tl.to(cursor, { scale: 0,84, duration: 0,1, ease: "power2.in", transformOrigin: "21% 14%" }, t);
tl.to(
  cursor,
  { scale: 1, duration: 0,22, ease: "power2.out", transformOrigin: "21% 14%" },
  t + 0,1,
);

Die Reaktion des Ziels ist ein separater, paralleler Tween (Button: scale: 0.94 + Druckfarbe/-schatten, die gleichzeitig mit demselben t starten). Reine Cursor-Taps (z. B. Fokussieren eines Texteingabefelds) erhalten KEINE Zielreaktion. Kombiniere mit cursor-click-ripple / press-release-spring für die Zielseite.

Der Klick ZÜNDET den nächsten Beat

Lasse niemals einen Morph, eine Tippsequenz, eine Fenstertransformation oder eine szenendefinierende Animation einfach starten. Setze den Cursor auf den Auslöser und lass den Klick sie verursachen, im selben Frame:

  • Klick ▸ Menü-/Untermenü-Kaskade, Umschalt-Flip
  • Klick ▸ Tippstart in ein Eingabefeld
  • Klick ▸ Composer-Morph nach unten / Fenster verkleinern
  • Klick ▸ Logo-Zündung / Flugstart
  • Klick ▸ Play-State-Umschaltung + UI-Leben-Erwachen in einem Produkt-Mock

Während langer Beats, die es nicht selbst steuert (Tippen, Erzählung), gleitet der Cursor zur Seite (0,5–0,9s, power2.out) – niemals starr über der Aktion stehen bleiben, niemals nutzlos wackeln.

Austrittsgesetz & Szenenübergabe

Zwei erlaubte Ausgänge – beide physisch, niemals eine Opazitätseinblendung an Ort und Stelle:

  1. Das Bild verlassen: Beschleunige mit power2.in aus dem nächstgelegenen Rand (left:'118%', left:'-12%' oder top:'116%'), 0,5–0,7s.
  2. Schnittkurven-Übergabe: In den letzten ~0,3s vor einem harten Schnitt beginnt der Cursor, mit power2.in in Richtung des ersten Klickpunkts der NÄCHSTEN Szene zu beschleunigen und legt dabei das erste ~1/3 dieses Pfads zurück; die nächste Komposition setzt den Cursor mit gsap.set auf die Übergabepose und fährt mit power2.out bei angepasster Geschwindigkeit fort. Der Cursor selbst wird zum Trägerelement, das die Nahtstelle überbrückt:
// Szene A, letzte 0,3s – starte die Reise:
tl.to(cursor, { left: "40,7%", top: "63,7%", duration: 0,3, ease: "power2.in" }, CUT - 0,3);
// Szene B, t=0 – beende sie bei angepasster Geschwindigkeit:
gsap.set(cursorB, { left: "40,7%", top: "63,7%" });
tl.to(cursorB, { left: "22%", top: "45%", duration: 0,6, ease: "power2.out" }, 0);

Checkliste

  • ≥ 7cqw im Vollbild (4,6–5,5cqw innerhalb eines Mocks) – bei Unsicherheit: größer
  • tritt von außerhalb des Bildschirms auf einem kontinuierlichen Vektor ein (keine Ein-/Ausblendung oder Maskenenthüllung)
  • Spitze landet auf der Zielmitte; Druck dreht sich um transformOrigin: '21% 14%'
  • jeder Klick verursacht etwas, im selben Frame
  • gleitet während beats, die es nicht steuert, zur Seite; kein nutzloses Wackeln
  • verlässt die Szene physisch (rahmenlos ab oder Schnittkurven-Übergabe) – keine Einblendung an Ort und Stelle

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

Leaves sweep through the frame and part to reveal the headline. HyperFrames block, 1920×1080, 12s, 11 variables.

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

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

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.

Verwandte Skills