HyperFrames – Hier starten
HyperFrames rendert Video aus HTML – eine Komposition ist eine HTML-Datei, deren DOM mit data-* Attributen das Timing deklariert, deren Animations-Laufzeit durchsuchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lesen Sie ihn, bevor Sie Kompositions-HTML schreiben.
Unten: eine Fähigkeitslandkarte (die Domänen-Skills, die bei Bedarf geladen werden) und der Intent-Router (wählen Sie einen Workflow für jede „Erstelle mir ein Video“-Anfrage).
Fähigkeitslandkarte – die Domänen-Skills
Atomare Fähigkeiten, die Sie bei Bedarf laden – keine vollständigen Video-Workflows. Für „Erstelle mir ein Video“ verwenden Sie den Intent-Router unten.
| Sie möchten… | Skill |
|---|---|
Eine HTML-Komposition erstellen / bearbeiten – der data-* Vertrag, Clips, Spuren, Unterkompositionen, Variablen | /hyperframes-core |
| Animieren – atomare Bewegungen, Szenen-Blaupausen, Übergänge, Laufzeit-Adapter (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Seek-sichere Keyframes erstellen – GSAP Timeline, CSS Keyframes, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG-Morph/Zeichnen, 3D-Tiefe, plus hyperframes keyframes Diagnose | /hyperframes-keyframes |
Kreative Leitung – frame.md / design.md, Paletten, Typografie, Narration, Taktplanung, audio-reaktiv | /hyperframes-creative |
| Medien – TTS-Sprachausgabe, Hintergrundmusik, Transkription, Hintergrundentfernung, Untertitel | /hyperframes-media |
Medien auflösen – BGM, SFX, Bilder, Icons aus dem HeyGen-Katalog finden und in .media/ mit Manifest-Tracking einfrieren | /media-use |
| CLI-Entwicklungsschleife – init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, diagnostizieren | /hyperframes-cli |
Registry-Blöcke / Komponenten installieren (hyperframes add) | /hyperframes-registry |
Intent-Routing – Workflow auswählen
Dieser Abschnitt kennt nur die Workflows der obersten Ebene; er lädt weder deren interne Referenzen noch die oben genannten Domänen-Skills.
Vor dem Routing – Eingabe bestätigen, nicht die Spezifikation
Routing muss wissen, worum es im Video geht – seine Eingabe und sein Betreff. Wenn das nicht angegeben ist („Erstelle ein Video über unser Ding“ ohne URL, Produkt, Thema oder Asset), fragen Sie, bevor Sie in einen Workflow einsteigen – die Festlegung auf einen Workflow IST die Routing-Entscheidung. Höchstens zwei Fragen:
- Eingabe – ein Produkt (URL / Briefing), eine allgemeine Website, ein GitHub-PR, ein zu erklärendes Thema oder ein vorhandenes Talking-Head-Video?
Spezifikationsstandards – Zustand, nicht fragen (sie ändern nie die Route): Seitenverhältnis 16:9 (verwenden Sie 9:16 nur für ein benanntes vertikales Ziel – TikTok / Reels / Shorts); Erzählung / Untertitel Sprache = die des Benutzers. Der gewählte Workflow bestätigt seine eigenen Spezifika im ersten Schritt.
Workflow-Spickzettel
| Workflow | Verwenden Sie es für |
|---|---|
/product-launch-video | Ein Produkt verkaufen (SaaS, App, Unternehmen / Produktseite) – aus einer URL, einem Briefing oder einem Skript → eine Promo. Der Standard für jede kommerzielle URL, auch wenn die Website nur genannt wird. |
/website-to-video | Eine Website selbst zeigen – eine Tour / Showcase, erstellt aus den eigenen Screenshots der Website. Für nicht-kommerzielle Websites (Portfolio, Blog, Docs, Persönlich, Event) oder wenn der Benutzer eine Tour, keine Promo möchte. |
/faceless-explainer | Ein Thema / Konzept erklären aus Text – kein Produkt, keine URL; jedes Bild ist KI-erfunden |
/pr-to-video | Ein GitHub PR / Code-Änderung → Changelog / Funktionsvorstellung / Fix / Refaktor-Erklärvideo |
/embedded-captions | Untertitel / Bildunterschriften zu einem vorhandenen Talking-Head-Video hinzufügen (Filmmaterial unberührt) |
/talking-head-recut | Ein vorhandenes Talking-Head-Video mit designten Grafik-Overlays verpacken – Lower Thirds, Daten-Callouts, kinetische Titel, Pull-Quote-Zitate |
/motion-graphics | Ein kurzes, unvertontes, designorientiertes Motion Graphic – kinetische Typografie, ein Statistik-/Diagramm-Hit, ein Logo-Sting, ein Lower-Third-Overlay |
/music-to-video | Ein Musikstück → ein beat-synchronisiertes Video – Lyrikvideo, Diashow oder kinetische Promo; die Musik bestimmt das Tempo (optionale Benutzerbilder/-videos auf das Beat-Raster geschnitten) |
/slideshow | Eine Präsentation / Pitch Deck / Interaktives Deck – diskrete Folien, Fragmente, Verzweigungen, Hotspots; Ausgabe ist ein navigierbares Deck, kein gerendertes Video |
/general-video | Alles andere – längere oder multi-szenische Stücke, eine statische Schleife / ein Poster, eine benutzerdefinierte Komposition |
/remotion-to-hyperframes | Portieren einer vorhandenen Remotion (React)-Komposition zu HyperFrames (Migration, keine Erstellung) |
Disambiguierung (nur bei Verwechslungsgefahr):
- Bewegungsbasiert & unvertont (unter ~10s, die Bewegung ist die Botschaft) →
/motion-graphics, unabhängig von der Eingabe. - Eine URL oder ein Skript – fragen Sie eine Sache: Verkauft die Website ein Produkt? Ja (SaaS / App / Produkt / Unternehmensseite) →
/product-launch-video– eine Promo und der Standard für jede kommerzielle URL, auch wenn die Website nur genannt wird. Nein, oder der Benutzer möchte die Website einfach so zeigen, wie sie ist (Portfolio / Blog / Docs / Persönlich / Event) →/website-to-video– eine Tour. Ein GitHub-PR-Link →/pr-to-video; ein Konzept ohne Produkt oder Website →/faceless-explainer. - Vorhandenes Filmmaterial – einfache gesprochene Wort-Untertitel →
/embedded-captions; designte Overlay-Karten →/talking-head-recut. Keines bearbeitet das Filmmaterial selbst (Neu-Timing / Neufärbung / Neurahmen / Neuordnung / Audio ist NLE-Schnitt – außerhalb des Rahmens). - Ein Musikstück ist die Eingabe (eine Audiodatei oder ein Video, aus dem Audio extrahiert werden soll) mit keiner Erzählung →
/music-to-video– die Beats/Energie der Musik bestimmen das Tempo. (Erzählte Stücke bleiben beim eingabeangepassten Workflow oben;/motion-graphicsist für kurze unvertonte Bewegungen, die nicht musikgesteuert sind.) - Eine Präsentation / Pitch Deck / Interaktives Deck (diskrete Folien, Navigation, Präsentatormodus) →
/slideshow– Ausgabe ist ein navigierbares Deck, kein gerendertes Video. Eine explizite „Diashow“-Anfrage geht direkt vor; ein angrenzender Auslöser („Deck / Folien / Präsentation / diese Seite konvertieren“) lässt/slideshowbestätigen, dass es sich um eine Diashow handelt, bevor es erstellt wird, und wechselt zum entsprechenden Nicht-Diashow-Workflow, wenn nicht. - Länge ist ein Leitfaden, kein Tor – die Absicht wählt den Workflow; gehen Sie nur zu
/general-video, wenn das Stück eindeutig länger als ~3 Min. ist oder ein statisches / Schleifen- / benutzerdefiniertes Format hat.
Wenn der passende Workflow nicht installiert ist
Sobald Sie einen Workflow ausgewählt haben, überprüfen Sie, ob er tatsächlich verfügbar ist. Wenn der passende Workflow-Skill nicht installiert ist, raten Sie nicht – sagen Sie dem Benutzer, er solle ihn zuerst installieren:
- Nur diesen Workflow:
npx skills add heygen-com/hyperframes --skill <workflow-name>(z. B.--skill pr-to-video– reiner Name, kein führendes/). - Alle Workflows auf einmal:
npx skills add heygen-com/hyperframes --all(Core + jeder Workflow, überspringt den Auswähler).
Nachdem der Benutzer es ausgeführt hat, lesen Sie den Skill des Workflows erneut und fahren Sie fort.
Skills aktuell halten
HyperFrames-Skills sind versioniert. npx hyperframes init überprüft die installierten Skills gegen die neuesten auf GitHub und installiert/aktualisiert den vollen Satz, wenn etwas veraltet oder fehlt – ein frisch initialisiertes Projekt hat also immer den vollständigen, aktuellen Satz (und eine erneute Ausführung von init bei einem aktuellen Projekt ist ein No-Op). Die Überprüfung ist eine schnelle GitHub-Rundreise; offline (oder ratenbegrenzt) fällt sie nach einem kurzen Timeout auf die Installation zurück, sodass init nie bei einem Netzwerk-Hickup hart fehlschlägt. Die Erstellungs-Workflows rüsten mit init, sodass ein neues Projekt immer diese Überprüfung durchführt und unsere neuesten Skills von GitHub zieht, wenn sie veraltet sind. Das --skip-skills-Flag ist derzeit neutralisiert (eine vorübergehende Maßnahme, während das skills.sh-Register aufholt): Wenn es übergeben wird, überspringt es die Überprüfung nicht mehr, sodass jedes init GitHub überprüft. CI/Tests melden sich über die Umgebungsvariable HYPERFRAMES_SKIP_SKILLS=1 ab.
Wenn sich eine Aufgabe unerwartet verhält oder vor einem langen Build, bestätigen Sie, dass die installierten Skills aktuell sind:
- Überprüfen:
npx hyperframes skills check(fügen Sie--jsonfür ein maschinenlesbares Urteil hinzu; beendet mit Nicht-Null, wenn etwas veraltet oder fehlt). - Aktualisieren:
npx hyperframes skills update– zieht den vollen Satz auf den neuesten Stand, installiert alle noch nicht vorhandenen (gleicher Installationsschritt wie bei init).
Die CLI zeigt auch eine einzeilige Erinnerung an, wenn ein render / lint / validate-Lauf veraltete Skills erkennt.
Workflow-Details
/product-launch-video
- Eingabe: Ein Produkt, das vermarktet wird – (a) eine Produkt-URL (mit Headless Chrome gecrawlt für Assets + Marken-Tokens), (b) ein Skript / Briefing, das die Website des Produkts auch ohne Link nennt (PLV löst auf + crawlt sie, es sei denn, der Benutzer lehnt ab), oder (c) ein Skript ohne ableitbare Website / „Nicht scrapen“ (No-Capture-Modus – wählen Sie eine Stilvorlage, die Palette + Designsystem liefert). Ein bereitgestelltes Skript kann die wörtliche Sprachausgabe sein oder pro Szene umstrukturiert – PLV fragt nach.
- Ausgabe: eine Produkteinführungs- / SaaS Promo als HyperFrames-Komposition → MP4 (Sweet Spot 30–90s) – der Produktwert ist das Thema, nicht ein Rundgang durch die Website. Für einen reinen Rundgang durch die Website verwenden Sie
/website-to-video. - Auslöser: „Launch-Video für X“, „Promo für unsere Seite“, „Erkläre mein SaaS in einer Minute“, „Verwandle mein Skript in eine 60s-Promo“, „Nur-Text-Launch-Video, nicht scrapen“.
/website-to-video
- Eingabe: Eine Website / URL, deren Ziel es ist die Seite selbst zu zeigen, nicht ein Produkt zu verkaufen. Am besten für nicht-kommerzielle Seiten (Portfolio, Blog, Docs, Persönlich, Event) oder wenn der Benutzer explizit einen Rundgang durch eine Seite wünscht. Mit Headless Chrome für echte Screenshots + Marken-Assets erfasst. Wenn die Seite etwas verkauft und der Benutzer eine Promo möchte, verwenden Sie
/product-launch-video. - Ausgabe: ein Seitenrundgang / Showcase / Social-Clip, erstellt aus den eigenen visuellen Elementen der Seite → MP4.
- Auslöser: „Mache ein Video aus dieser Website“, „Seitentour von ", "Social-Clip von unserer Startseite", "Ich habe nur eine URL – mach etwas".
/faceless-explainer
- Eingabe: Beliebiger Text – ein Thema, Artikel oder Notizen – der erklärt wird, ohne dass ein Produkt vermarktet oder eine Seite erfasst wird. (Abgespalten von
/product-launch-video; kein Headless Chrome.) - Ausgabe: Erklärvideo ohne Sprecher → MP4, jedes Bild KI-erfunden pro Szene (Typografie / abstrakt / Diagramm / Daten-Visualisierung); liefert die
pin-and-paper-Vorlage. (Sweet Spot 30–90s). - Auslöser: „Erklärvideo ohne Sprecher über X“, „Erkläre, wie DNS funktioniert, als Video“, „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“ – gelesen über diegh-CLI (keine zu scrapende Seite). - Ausgabe: Code-Änderungs-Erklärvideo (Changelog / Funktionsvorstellung / Fix / Refaktor) → MP4 – Diff-Highlights, Vorher/Nachher, Dateibaum + Auswirkungsszenen. ≤ (Sweet Spot 30–90s).
- Auslöser: „Erstelle 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 kein Briefing. Lokal transkribiert (Whisper, kein API-Key) und mattiert (RVM), sodass die Person Untertitel überdecken kann.
- Ausgabe: das gleiche Filmmaterial unberührt, mit einer Untertitelebene – Standard (wörtliche Lower-Third-Schiene + ein eingebetteter Höhepunkt hinter der Person) oder Kinematografisch (jeder Untertitel hinter der Person zusammengesetzt). Jede Länge.
- Auslöser: „Füge diesem Video Untertitel / Bildunterschriften hinzu", "Untertitel hinter der Person", "Kinematografische Untertitel für meinen Clip".
/talking-head-recut
- Eingabe: Ein vorhandenes Talking-Head / Interview / Podcast-Video (MP4) zum Verpacken mit Bildschirmgrafiken – tatsächliches Filmmaterial. Lokal transkribiert (Whisper). Der Clip läuft vollständig darunter, unberührt.
- Ausgabe: das gleiche Filmmaterial mit zeitgesteuerten Grafik-Overlay-Karten – kinetische Titel, Lower Thirds, Daten-Callouts, Pull-Quote-Zitate, Seitenpaneele, Bild-in-Bild – synchronisiert zum Transkript. Jede Länge.
- Auslöser: „Verpacke dieses Video", "Füge Grafik-Overlays / Lower Thirds / Daten-Callouts zu meinem Talk hinzu", "Verwandle diesen Talk"