HyperFrames – Start hier
HyperFrames rendert Videos aus HTML – eine Komposition ist eine HTML-Datei, deren DOM mit data-*-Attributen das Timing deklariert, deren Animationsablauf suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lies ihn, bevor du Kompositions-HTML schreibst.
Unten: eine Fähigkeitsübersicht (die Domain-Fähigkeiten, die bei Bedarf geladen werden) und der Intent-Router (wähle einen Workflow für jede "Mach mir ein Video"-Anfrage).
Fähigkeitsübersicht – die Domain-Fähigkeiten
Atomare Fähigkeiten, die du bei Bedarf lädst – keine vollständigen Video-Workflows. Für "Mach mir ein Video" verwende den Intent-Router unten.
| Du möchtest… | Fähigkeit |
|---|---|
Eine HTML-Komposition erstellen/bearbeiten – der data-*-Vertrag, Clips, Spuren, Unterkompositionen, Variablen | /hyperframes-core |
| Animieren – atomare Bewegung, Szenenentwürfe, Übergänge, Laufzeit-Adapter (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Kreative Leitung – frame.md / design.md, Paletten, Typografie, Erzählung, Taktplanung, audio-reaktiv | /hyperframes-creative |
| Medien – TTS-Sprachausgabe, Hintergrundmusik, Transkription, Hintergrundentfernung, Untertitel | /hyperframes-media |
Medienauflösung – BGM, SFX, Bilder, Icons aus dem HeyGen-Katalog finden + einfrieren in .media/ mit Manifest-Verfolgung | /media-use |
| CLI-Entwicklungs-Schleife – init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, diagnostizieren | /hyperframes-cli |
Registry-Blöcke / Komponenten installieren (hyperframes add) | /hyperframes-registry |
Intent-Routing – wähle einen Workflow
Dieser Abschnitt kennt nur die übergeordneten Workflows; er lädt weder ihre internen Referenzen noch die oben genannten Domain-Fähigkeiten.
Vor dem Routing – bestätige die Eingabe, nicht die Spezifikation
Das Routing muss wissen, worum es in dem Video geht – seine Eingabe und sein Thema. Wenn dies nicht angegeben ist ("Mach ein Video über unser Ding" ohne URL, Produkt, Thema oder Asset), frage vor dem Einstieg in einen Workflow nach – die Entscheidung für einen Workflow IST die Routing-Entscheidung. Höchstens zwei Fragen:
- Eingabe – ein Produkt (URL / Kurzbeschreibung), eine allgemeine Website, ein GitHub-PR, ein Thema, das erklärt werden soll, oder ein vorhandenes Talking-Head-Video?
Standard-Spezifikationen – nenne sie, frage nicht (sie ändern nie die Route): Seitenverhältnis 16:9 (verwende 9:16 nur für ein benanntes vertikales Ziel – TikTok / Reels / Shorts); Sprachausgabe / Untertitel-Sprache = die des Benutzers. Der gewählte Workflow bestätigt seine eigenen Spezifikationen im ersten Schritt.
Workflow-Spickzettel
| Workflow | Verwende ihn für |
|---|---|
/product-launch-video | Vermarktung / Einführung / Werbung für ein Produkt – von seiner URL, einer Kurzbeschreibung oder einem Skript (auch wenn die Site nur genannt wird) |
/website-to-video | Eine allgemeine Website in ein Video verwandeln – Site-Tour, Portfolio / Landing-Page-Präsentation, Social-Clip aus den visuellen Elementen der Site |
/faceless-explainer | Erklärung eines Themas / Konzepts aus Text – kein Produkt, keine URL; jedes Bild ist KI-erfunden |
/pr-to-video | Ein GitHub-PR / Code-Änderung → Changelog / Feature-Enthüllung / Fix / Refactoring-Erklärvideo |
/embedded-captions | Hinzufügen von Untertiteln / Untertitel zu einem vorhandenen Talking-Head-Video (Aufnahmen unberührt) |
/talking-head-recut | Ein vorhandenes Talking-Head-Video mit designten Grafik-Overlays verpacken – Lower-Thirds, Daten-Callouts, kinetische Titel, Pull-Quotes |
/motion-graphics | Eine kurze, unbesprochene, designorientierte Bewegungsgrafik – Kinetischer Text, ein Stat / Diagramm-Treffer, ein Logo-Sting, ein Lower-Third-Overlay |
/music-to-video | Ein Musiktitel → ein takt-synchronisiertes Video – Lyric-Video, Diashow oder kinetischer Trailer; die Musik bestimmt das Tempo (optionale Benutzerbilder/-videos auf das Takt-Raster geschnitten) |
/slideshow | Eine Präsentation / Pitch-Deck / interaktives Deck – einzelne Folien, Fragmente, Verzweigungen, Hotspots; Ausgabe ist ein navigierbares Deck, kein gerendertes Video |
/general-video | Alles andere – längere oder mehrtaktige Stücke, eine statische Schleife / ein Poster, eine benutzerdefinierte Komposition |
/remotion-to-hyperframes | Portierung einer bestehenden Remotion (React)-Komposition zu HyperFrames (Migration, keine Erstellung) |
Abgrenzung (nur dort, wo Verwechslungsgefahr besteht):
- Bewegungsorientiert & unbesprochen (unter ~10s, die Bewegung ist die Botschaft) →
/motion-graphics, unabhängig von der Eingabe. - Eine URL oder ein Skript – vermarktet ein bestimmtes Produkt (auch wenn nur die Site genannt wird) →
/product-launch-video; eine allgemeine Nicht-Produkt-Site →/website-to-video; ein GitHub-PR-Link →/pr-to-video; erklärt ein Konzept ohne Produkt / Site →/faceless-explainer. Wirklich unklar ob Produkt-vs-Thema oder Launch-vs-allgemeine-Site → eine Frage stellen. - Vorhandenes Filmmaterial – einfache gesprochene Untertitel →
/embedded-captions; designte Overlay-Karten →/talking-head-recut. Keines bearbeitet das Filmmaterial selbst (Neutiming / Neufärbung / Neurahmen / Neuordnung / Audio ist NLE-Bearbeitung – nicht im Rahmen). - Ein Musiktitel ist die Eingabe (eine Audiodatei oder ein Video, aus dem Audio extrahiert werden soll) mit keiner Sprachausgabe →
/music-to-video– die Beats/Energie der Musik bestimmen das Tempo. (Besprochene Stücke bleiben beim oben passenden Workflow;/motion-graphicsist für kurze unbesprochene Bewegungen, die nicht musikgesteuert sind.) - Eine Präsentation / Pitch-Deck / interaktives Deck (einzelne Folien, Navigation, Präsentatormodus) →
/slideshow– Ausgabe ist ein navigierbares Deck, kein gerendertes Video. Eine explizite "Diashow"-Anfrage geht direkt weiter; ein angrenzender Auslöser ("Deck / Folien / Präsentation / diese Seite konvertieren") lässt/slideshowbestätigen, dass es eine Diashow ist, bevor es erstellt wird, und wechselt bei Bedarf zum passenden Nicht-Diashow-Workflow. - Länge ist eine Orientierung, kein Hindernis – der Zweck wählt den Workflow; gehe nur zu
/general-video, wenn das Stück deutlich länger als ~3 Min. ist oder ein statisches / Schleifen / benutzerdefiniertes Format hat.
Wenn der passende Workflow nicht installiert ist
Sobald du einen Workflow ausgewählt hast, überprüfe, ob er dir tatsächlich zur Verfügung steht. Wenn die passende Workflow-Fähigkeit nicht installiert ist, falle nicht zurück auf Raten – weise den Benutzer an, sie zuerst zu installieren:
- Nur diesen Workflow:
npx skills add heygen-com/hyperframes --skill <workflow-name>(z.B.--skill pr-to-video– einfacher Name, ohne führendes/). - Alle Workflows auf einmal:
npx skills add heygen-com/hyperframes --all(Core + jeder Workflow, überspringt die Auswahl).
Nachdem er sie ausgeführt hat, lies die Fähigkeit des Workflows erneut und fahre fort.
Workflow-Details
/product-launch-video
- Eingabe: Ein Produkt, das vermarktet wird – (a) eine Produkt-URL (mit Headless Chrome gecrawlt für Assets + Brand-Tokens), (b) ein Skript / eine Kurzbeschreibung, die die Site des Produkts auch ohne Link nennt (PLV löst sie auf + crawlt sie, es sei denn, der Benutzer lehnt ab) oder (c) ein Skript ohne ableitbare Site / "nicht scrapen" (No-Capture-Modus – wähle eine Stilvorlage, die Palette + Designsystem liefert). Ein bereitgestelltes Skript kann der wörtliche Voice-Over oder umstrukturiert pro Szene sein – PLV fragt nach.
- Ausgabe: Produkt-Launch / SaaS-Promo als HyperFrames-Komposition → MP4. (Sweet Spot 30–90s).
- Auslöser: "Launch-Video für X", "Promo für unsere Site", "Erkläre mein SaaS in einer Minute", "Verwandle mein Skript in einen 60s-Promo", "Text-Only-Launch-Video, nicht scrapen".
/website-to-video
- Eingabe: Eine allgemeine Website / URL, die in ein Video verwandelt werden soll – wenn das Ziel ein Video der Site ist, kein Produkt-Launch. Mit Headless Chrome erfasst für echte Screenshots + Brand-Assets.
- Ausgabe: eine Site-Tour / Portfolio / Landing-Page-Präsentation / Social-Clip, aufgebaut aus den eigenen visuellen Elementen der Site → MP4.
- Auslöser: "Verwandle diese Website in ein Video", "Site-Tour von ", "Social-Clip von unserer Homepage", "Ich habe nur eine URL – mach etwas".
/faceless-explainer
- Eingabe: Beliebiger Text – ein Thema, ein Artikel oder Notizen – der erklärt wird, wobei kein Produkt vermarktet und keine Site erfasst wird. (Abgezweigt von
/product-launch-video; kein Headless Chrome.) - Ausgabe: Gesichtsloses Erklärvideo → MP4, jedes Bild KI-erfunden pro Szene (Typografie / abstrakt / Diagramm / Datenvisualisierung); wird mit dem
pin-and-paper-Voreinstellung geliefert. (Sweet Spot 30–90s). - Auslöser: "Gesichtsloses Erklärvideo über X", "Erkläre, wie DNS als Video funktioniert", "Verwandle diesen Artikel in ein Erklärvideo", "Erklärvideo aus meinen Notizen".
/pr-to-video
- Eingabe: Ein GitHub-Pull-Request – eine PR-URL, ein
owner/repo#N-Verweis oder "dieser PR" – viagh-CLI gelesen (keine zu scrapende Site). - Ausgabe: Code-Änderungs-Erklärvideo (Changelog / Feature-Enthüllung / Fix / Refactoring) → MP4 – Diff-Highlights, Vorher/Nachher-, Dateibaum- + Auswirkungsszenen. ≤ (Sweet Spot 30–90s).
- Auslöser: "Mach ein Video über diesen PR", "Verwandle PR #1187 in ein Changelog-Video", "Release-Notes-Video von github.com/org/repo/pull/123".
/embedded-captions
- Eingabe: Ein vorhandenes Talking-Head-Video (MP4) zum Untertiteln – tatsächliches Filmmaterial, keine URL oder Kurzbeschreibung. Lokal transkribiert (Whisper, kein API-Schlüssel) und maskiert (RVM), sodass das Motiv Untertitel verdecken kann.
- Ausgabe: dasselbe Filmmaterial unberührt, mit einer Untertitelebene – Standard (wörtliche Lower-Third-Schiene + ein eingebetteter Höhepunkt hinter dem Motiv) oder Kinematografisch (jeder Untertitel hinter dem Motiv zusammengesetzt). Jede Länge.
- Auslöser: "Untertitel / Untertitel zu diesem Video hinzufügen", "Untertitel hinter dem Motiv", "Kinematografische Untertitel für meinen Clip".
/talking-head-recut
- Eingabe: Ein vorhandenes Talking-Head / Interview / Podcast-Video (MP4), um es mit Bildschirmgrafiken zu verpacken – tatsächliches Filmmaterial. Lokal transkribiert (Whisper). Der Clip läuft vollständig darunter, unberührt.
- Ausgabe: dasselbe Filmmaterial mit zeitgesteuerten Grafik-Overlay-Karten – kinetische Titel, Lower-Thirds, Daten-Callouts, Pull-Quotes, Seitenleisten, Bild-im-Bild – synchronisiert zum Transkript. Jede Länge.
- Auslöser: "Verpacke dieses Video", "Füge Grafik-Overlays / Lower-Thirds / Daten-Callouts zu meinem Vortrag hinzu", "Verwandle dieses Interview in eine grafikverpackte Bearbeitung".
/motion-graphics
- Eingabe: Eine kurze, designorientierte Bewegungsgrafik, bei der die Bewegung die Botschaft ist – typischerweise unter ~10s, keine Sprachausgabe. Genres: kinetische Typografie, ein Stat / Zahlen-Count-Up, ein Diagramm-Treffer, ein Logo-Sting, ein Lower-Third / Overlay oder ein suchgesteuerter Seiten- / Tweet- / Headline-Shot.
- Ausgabe: eine kurze Bewegungsgrafik → MP4 oder ein transparentes Overlay (Alpha WebM / MOV) für ein Lower-Third / Callout.
- Auslöser: "Ein 8s Logo-Sting", "Animiere diesen Stat", "Ein kinetischer Intro", "Verwandle diesen Tweet in eine Bewegungsgrafik", "Ein transparentes Lower-Third-Overlay".
/music-to-video
- Eingabe: Ein Musiktitel – eine Audiodatei oder ein Video, aus dem Audio extrahiert werden soll – mit keiner Sprachausgabe und keinem Website-Capture. Optional vom Benutzer bereitgestellte Bilder / Videos zum Einweben. Der Titel wird einmal in eine deterministische Beat- / Energie-Karte (
audiomap.json) analysiert, auf der das gesamte Video aufbaut. - Ausgabe: Eine takt-synchronisierte HyperFrames-Komposition → MP4, bei der die Musik das Tempo bestimmt. Typografie und Vorlagen sind der Boden (ein vollständiges Video benötigt null Assets); alle bereitgestellten Medien werden auf dasselbe Takt-Raster geschnitten (Beat-Cut / Ken-Burns). Das Genre – Lyric-Video, Diashow, kinetischer Promo – ergibt sich aus den per-Frame-Entscheidungen; die Pipeline verzweigt sich nie darauf.
- Auslöser: "Mach ein Video für diesen Song", "Takt-synchronisiertes Video aus diesem Titel", "Lyric-Video", "Verwandle diese Musik in ein Video", "Musikvisualisierer / kinetischer Promo zu diesem Beat".
/slideshow
- Eingabe: Eine Präsentation / Pitch-Deck / interaktives Deck zum Erstellen – eine Kurzbeschreibung, eine Gliederung oder eine vorhandene Seite, die in Folien umgewandelt werden soll. Keine Anfrage für ein gerendertes Video; wenn der Zweck mehrdeutig ist, bestätigt die Fähigkeit "Möchtest du dies als HyperFrames-Diashow?" vor dem Erstellen.
- Ausgabe: Eine ausführbare HyperFrames-Komposition + eine JSON-Insel, die der
SlideshowControllerdes Players liest, um die GSAP-Zeitleiste in ein navigierbares Deck zu verwandeln – einzelne Folien, Fragment-Enthüllungen, Verzweigungssequenzen, Hotspot-Navigation, Präsentatormodus und Sprechernotizen. Das Ergebnis ist ein Deck, kein MP4. - Auslöser: "Mach ein Pitch-Deck / eine Präsentation / ein Slide-Deck", "Ein interaktives Deck", "Konvertiere diese Seite in Folien", "Eine Diashow mit Präsentatormodus".
/general-video
- Eingabe: Alles, was nicht oben genannt ist – eine kreative Kurzbeschreibung, ein einzelnes Element zum Animieren, eine Bearbeitung einer Komposition, die du erstellst. Eingabe- und längenunabhängig.
- Ausgabe: Eine HyperFrames-Komposition (jede Länge / jedes Format) über den ursprünglichen Ablauf: Designsystem → Prompt-Erweiterung → Plan → Layout-vor-Animation → Erstellung (Delegierung an die
hyperframes-* Fähigkeiten) → Validierung…