Communitygithub.com

jonosin/jstack

Dünner Router zu HeyGen HyperFrames – der HTML-nativen Motion-Graphics-Engine (HTML schreiben, deterministisches MP4 lokal mit Headless Chrome + FFmpeg rendern).

Was ist jstack?

Diese Fähigkeit dient als schlanker Router zu HeyGen HyperFrames, einer Apache-2.0-lizenzierten Engine (github.com/heygen-com/hyperframes), mit der HTML-, CSS- und JS-Kompositionen in deterministische MP4-Dateien umgewandelt werden. Der Renderer erfasst jeden Frame in einem Headless Chrome und kodiert ihn mit FFmpeg. Die Fähigkeit selbst enthält kein tiefgehendes Wissen, sondern leitet alle Anfragen an das geklonte Repository und die dortigen 20 Agent-Skills weiter. Sie wird aktiviert, wenn der Benutzer Begriffe wie „Hyperframe“, „animierte Überlagerung“, „Motion Graphics“, „HTML zu Video“ oder „kinetische Titel“ verwendet. Wichtig: Diese Fähigkeit ist nicht für generative Videos (dafür ist /vidgen zuständig) und nicht für statische Textüberlagerungen von StayFrame (dafür bleibt /jstack-sf-caption zuständig).

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

In Ihrer bevorzugten KI fragen

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

Dokumentation

hyperframe — Router zu HeyGen HyperFrames

HyperFrames (Apache-2.0, github.com/heygen-com/hyperframes) verwandelt HTML/CSS/JS-Kompositionen in deterministische MP4s: der Renderer sucht jeden Frame in Headless Chrome und kodiert ihn mit FFmpeg. Diese Fähigkeit ist ein DÜNNER Router – das gesamte Wissen lebt im geklonten Repository und seinen eigenen 20 Agent-Skills; niemals die Upstream-Dokumentation hier duplizieren.

Lokale Pfade

Auflösung: HYPERFRAMES_HOME Umgebungsvariable → ~/.jstack/config.env → Standard unten.

WasWo
Geklontes Repository (kanonische lokale Kopie)~/.jstack/vendor/hyperframes
Upstream-Router-Skill (Zuerst lesen FÜR JEDE mach-mir-ein-Video-Anfrage)~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md
Seine 20 Agent-Skills (auch installiert in ~/.claude/skills/ + ~/.agents/skills/ durch hyperframes init)~/.jstack/vendor/hyperframes/skills/
Block-/Komponenten-Registry (70+ Blöcke: Lower-Thirds lt-*, code-*, logo-outro, glitch, data-chart…)~/.jstack/vendor/hyperframes/registry/{blocks,components}
Dokumentationsquellen (Schnellstart, Konzepte, Referenz, Katalog)~/.jstack/vendor/hyperframes/docs/
Online: Dokumentation + Block-Kataloghyperframes.heygen.com (Schnellstart/Dokumente/Katalog), hyperframes.dev (Playground + Designvorlagen)

Installation / Zustandsprüfung

Voraussetzungen: Node 22+ und FFmpeg im PATH (auf diesem Rechner verifiziert, CLI v0.7.48).

npx --yes hyperframes doctor          # Umgebungs-Check
npx --yes hyperframes init my-video   # Projekt anlegen (installiert/aktualisiert auch seine Agent-Skills)
cd my-video && npm run render         # → renders/*.mp4

init erstellt index.html + hyperframes.json und fixiert die CLI-Version in package.json Scripts (dev/check/render/publish). Klon aktualisieren mit git -C ~/.jstack/vendor/hyperframes pull.

Dispatch-Tabelle

Leiten Sie die Absicht weiter, dann ÖFFNEN/SIE das Upstream-Ziel aus – improvisieren Sie keinen Workflow.

AbsichtGehe zu
Jede „Mach mir ein Video/Animation“-Anfrage (Einstiegspunkt)Lesen Sie das /hyperframes Router-Skill: ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md – es wählt den Workflow aus
Animierter Hook-Text / kinetische Titel / Stat-Hit / Logo-Sting / End-Card / Lower-Third (kurz, unerzählt, designgetrieben)/motion-graphics Workflow: skills/motion-graphics/ im Klon; Lower-Third-Blöcke = Registry lt-*, End-Card = logo-outro
Kinetische Untertitel auf einem vorhandenen Talking-Head-Video/embedded-captions Workflow: skills/embedded-captions/ (Footage unberührt, Untertitel darüber gerendert)
HTML→MP4-Komposition erstellen oder bearbeiten (der data-* Timing-Vertrag, Clips, Tracks)/hyperframes-core dann /hyperframes-animation: skills/hyperframes-core/, skills/hyperframes-animation/
Blöcke und Komponenten durchsuchen / installierenRegistry-Verzeichnisse registry/{blocks,components} oder hyperframes.heygen.com/catalog; installieren + verdrahten über /hyperframes-registry und npx hyperframes add [block]
Rendern / Vorschau / Linten / Validieren einer Komposition/hyperframes-cli: npx hyperframes preview, npx hyperframes lint && npx hyperframes validate, npx hyperframes render, npx hyperframes doctor
BGM / SFX / Voiceover / Icons / Hintergrundentfernung für eine Komposition/media-use: skills/media-use/
Deck / Slideshow, Produkt-Promo, PR-to-Video, musik-synchronisiert, Website-Tour, Remotion-PortDas passende Workflow-Skill in skills/ (siehe Cheat-Sheet des /hyperframes Routers)

Wann NICHT verwenden (StayFrame rote Linie)

StayFrames Feed-Ästhetik-Nordstern (ADR 0002, editorial-minimal – „Würde das unbemerkt im Aman/Soneva-Grid sitzen?“) macht starke Motion-Graphics-Stile OFF-BRAND: Hormozi-artige kinetische Untertitel, Glitch/VFX-Blöcke, News-Ticker, Liquid-Glass-Widgets. Für StayFrame-Reels HyperFrames nur für SUBTILE minimale Überlagerungen verwenden, und:

  • Statische Textüberlagerungen bleiben auf der bestehenden Spur – Headless-Chrome + ffmpeg via /jstack-sf-caption. Nicht auf HyperFrames migrieren.
  • Generative Videos (i2v/t2v) sind nie HyperFrames – das ist /vidgen.

Fallstricke

  • hyperframes init hat kein --yes Flag (Fehler bei unbekannten Flags); es ist bereits nicht-interaktiv.
  • init Nebeneffekt: Installiert/aktualisiert HyperFrames eigene Kern-Skills in ~/.claude/skills/ und ~/.agents/skills/ – erwartet, hält den Upstream-Router aktuell.
  • Eigenständige Skill-Installation: npx skills add heygen-com/hyperframes --full-depth – --full-depth verwenden, sonst erhält man ein veraltetes skills.sh Registry-Blob, das hinter main hinterherhinkt.
  • Telemetrie ist standardmäßig aktiviert; deaktivieren mit hyperframes telemetry disable.
  • Render-Ausgabe landet in renders/[project]_[timestamp].mp4 im Projektverzeichnis.

Nächste Skills

NächstesWann
/vidgenDie Komposition benötigt generiertes Footage (i2v/t2v-Clips) als Quellmaterial – Videogenerierung wird immer dorthin weitergeleitet, nie direkt zu einem Backend.
/jstack-sf-captionEin StayFrame-Reel benötigt einfache statische Textüberlagerungen – diese Spur bleibt bei Headless-Chrome + ffmpeg, nicht bei HyperFrames.
/jstack-sf-trim-stitchEin gerenderter HyperFrames-Overlay/End-Card muss in ein StayFrame-Reel eingebaut werden.

Verwandte Skills