HyperFrames, starte hier
HyperFrames rendert Videos 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 Authoring-Vertrag befindet sich in /hyperframes-core; lies ihn, bevor du Kompositions-HTML schreibst.
Unten: eine Fähigkeitskarte (die Domänenskills, die bei Bedarf geladen werden) und der Intent-Router (wähle einen Workflow für jede "Mach mir ein Video"-Anfrage).
Fähigkeitskarte. Die Domänenskills
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… | Skill |
|---|---|
Eine HTML-Komposition erstellen / bearbeiten: den data-*-Vertrag, Clips, Spuren, Unterkompositionen, Variablen | /hyperframes-core |
| Animieren: atomare Bewegung, Szenen-Blaupausen, Übergänge, Laufzeit-Adapter (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Seek-sichere Keyframes erstellen: GSAP-Zeitachsen, CSS-Keyframes, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG-Morph/Draw, 3D-Tiefe, plus hyperframes keyframes-Diagnose | /hyperframes-keyframes |
Kreative Richtung: frame.md / design.md, Paletten, Typografie, Erzählung, Taktplanung, audio-reaktiv | /hyperframes-creative |
| Medien: TTS-Voiceover, Hintergrundmusik, Transkription, Hintergrundentfernung, Untertitel | /hyperframes-media |
Medienauflösung: BGM, SFX, Bilder, Icons aus dem HeyGen-Katalog in .media/ mit Manifest-Tracking finden + einfrieren | /media-use |
| CLI-Entwicklungs-Loop: init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, doctor | /hyperframes-cli |
Registry-Blöcke / Komponenten installieren (hyperframes add) | /hyperframes-registry |
| Figma-Inhalt importieren: Assets, Tokens, Komponenten, Storyboards → Animatics (REST/CLI); Motion, Shader (MCP) | /figma |
Intent-Routing, wähle einen Workflow
Dieser Abschnitt kennt nur die übergeordneten Workflows; er lädt weder ihre internen Referenzen noch die oben genannten Domänenskills.
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 nach, bevor du in einen Workflow eintrittst; die Entscheidung für einen Workflow IST die Routing-Entscheidung. Maximal zwei Fragen:
- Eingabe: ein Produkt (URL / Briefing), eine allgemeine Website, ein GitHub-PR, ein zu erklärendes Thema oder ein vorhandenes Talking-Head-Video?
Spezifikations-Standardwerte: Zustand, nicht fragen (sie ändern niemals die Route): Seitenverhältnis 16:9 (verwende 9:16 nur für ein benanntes vertikales Ziel: TikTok / Reels / Shorts); Erzählungs / Untertitel-Sprache = die des Benutzers. Der ausgewählte Workflow bestätigt seine eigenen spezifischen Details im ersten Schritt.
Workflow-Spickzettel
| Workflow | Verwende ihn für |
|---|---|
/product-launch-video | Ein Produkt verkaufen (SaaS, App, Unternehmens-/Produktseite). Von einer URL, einem Briefing oder einem Skript → einen Promo. Der Standard für jede kommerzielle URL, selbst wenn die Seite nur genannt wird. |
/website-to-video | Eine Website selbst zeigen: eine Tour / Showcase, die aus den eigenen Screenshots der Site erstellt wurde. Für nicht-kommerzielle Websites (Portfolio, Blog, Docs, persönlich, Veranstaltung) oder wenn der Benutzer eine Tour, keine Werbung möchte. |
/faceless-explainer | Ein Thema / Konzept erklären aus Text, kein Produkt, keine URL; jedes visuelle Element wird vom LLM erfunden |
/pr-to-video | Ein GitHub-PR / eine Codeänderung → Changelog / Feature-Reveal / Fix / Refactor-Erklärvideo |
/embedded-captions | Untertitel / Beschriftungen zu einem vorhandenen Talking-Head-Video hinzufügen (Filmmaterial unberührt) |
/talking-head-recut | Ein vorhandenes Talking-Head-Video mit gestalteten grafischen Overlays verpacken: Lower-Thirds, Daten-Callouts, kinetische Titel, Pull-Quote |
/motion-graphics | Eine kurze, unvertonte, designorientierte Bewegungsgrafik: kinetische Typografie, ein Statistik-/Diagramm-Hit, ein Logo-Sting, ein Lower-Third-Overlay |
/music-to-video | Einen Musik-Track → ein beat-synchrones Video, Lyric-Video, Diashow oder kinetisches Promo; die Musik bestimmt das Tempo (optionale Benutzerbilder / -videos, die auf den Beat-Raster geschnitten werden) |
/slideshow | Eine Präsentation / Pitch-Deck / interaktive Präsentation: diskrete Folien, Fragmente, Verzweigungen, Hotspots; die Ausgabe ist ein navigierbares Deck, kein gerendertes Video |
/general-video | Alles andere: längere oder mehrszenige Stücke, eine statische Schleife / ein Poster, eine benutzerdefinierte Komposition |
/remotion-to-hyperframes | Portierung einer vorhandenen Remotion (React)-Komposition zu HyperFrames (Migration, keine Neuerstellung) |
Disambiguierung (nur bei Verwechslungsgefahr):
- Bewegungsorientiert & unvertont (unter ~10s, die Bewegung ist die Botschaft) →
/motion-graphics, unabhängig von der Eingabe. - Eine URL oder ein Skript: Frage eines: Verkauft die Website ein Produkt? Ja (SaaS / App / Produkt / Unternehmensseite) →
/product-launch-video: ein Promo und der Standard für jede kommerzielle URL, selbst wenn die Seite nur genannt wird. Nein, oder der Benutzer möchte die Seite einfach so zeigen (Portfolio / Blog / Docs / persönlich / Veranstaltung) →/website-to-video: eine Tour. Ein GitHub-PR-Link →/pr-to-video; ein Konzept ohne Produkt oder Seite →/faceless-explainer. - Vorhandenes Filmmaterial: einfache gesprochene Untertitel →
/embedded-captions; gestaltete Overlay-Karten →/talking-head-recut. Keines von beiden bearbeitet das Filmmaterial selbst (Neutiming / Neufärbung / Neuausschnitt / Neuordnung / Audio ist NLE-Bearbeitung, nicht im Rahmen). - Ein Musik-Track ist die Eingabe (eine Audiodatei oder ein Video, aus dem Audio extrahiert wird) mit keiner Erzählung →
/music-to-video: Die Beats/Energie der Musik bestimmen das Tempo. (Vertonte Stücke bleiben beim eingabeangepassten Workflow oben;/motion-graphicsist für kurze unvertonte Bewegungen, die nicht musikgesteuert sind.) - Eine Präsentation / Pitch-Deck / interaktive Präsentation (diskrete Folien, Navigation, Präsentatormodus) →
/slideshow: Ausgabe ist ein navigierbares Deck, kein gerendertes Video. Eine explizite "Diashow"-Anfrage wird direkt ausgeführt; ein angrenzender Auslöser ("Deck / Folien / Präsentation / diese Seite konvertieren") lässt/slideshowvor dem Authoring bestätigen, dass es sich um eine Diashow handelt, und wechselt andernfalls zum passenden Nicht-Diashow-Workflow. - Die 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 ist.
Wenn der passende Workflow nicht installiert ist
Sobald du einen Workflow ausgewählt hast, überprüfe, ob er tatsächlich verfügbar ist. Wenn der passende Workflow-Skill nicht installiert ist, falle nicht auf Raten zurück, sondern fordere den Benutzer auf, ihn zuerst zu installieren:
- Nur diesen Workflow:
npx skills add heygen-com/hyperframes --skill <workflow-name>(z. B.--skill pr-to-video: bloßer Name, kein führendes/). - Alle Workflows auf einmal:
npx skills add heygen-com/hyperframes --all(Kern + jeder Workflow, überspringt den Auswähler).
Nachdem der Benutzer dies ausgeführt hat, lies den Skill des Workflows erneut und fahre fort.
Skills aktuell halten
HyperFrames-Skills sind versioniert. npx hyperframes init überprüft die installierten Skills auf dem neuesten Stand gegenüber GitHub und installiert / aktualisiert die vollständige Sammlung, sobald etwas veraltet oder fehlt. Ein neu initialisiertes Projekt hat also immer die vollständige, neueste Sammlung (und die erneute Ausführung von init bei einem aktuellen Projekt ist ein No-Op). Die Überprüfung ist ein schneller GitHub-Rundgang; offline (oder ratenbegrenzt) fällt sie nach einem kurzen Timeout auf die Installation zurück, sodass init niemals aufgrund eines Netzwerkproblems hart fehlschlägt. Die Erstellungs-Workflows rüsten mit init vor, sodass ein neues Projekt immer diese Überprüfung durchführt und unsere neuesten Skills von GitHub abruft, 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, wird die Überprüfung nicht übersprungen, 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ätige, dass die installierten Skills aktuell sind:
- Überprüfen:
npx hyperframes skills check(füge--jsonfür ein maschinenlesbares Urteil hinzu; beendet sich mit einem Fehler, wenn etwas veraltet oder fehlt). - Aktualisieren:
npx hyperframes skills update: Holt die vollständige Sammlung auf den neuesten Stand, installiert alles, was noch nicht vorhanden ist (derselbe Schritt wie in 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 vermarktetes Produkt: (a) eine Produkt-URL (mit Headless Chrome nach Assets + Marken-Tokens gecrawlt), (b) ein Skript / Briefing, das die Website des Produkts sogar ohne Link nennt (PLV löst auf + crawlt sie, es sei denn, der Benutzer lehnt ab), oder (c) ein Skript ohne ableitbare Website / "Nicht scannen"-Modus (No-Capture-Modus, wähle eine Stilvorlage, die Palette + Designsystem bereitstellt). Ein bereitgestelltes Skript kann der wortwörtliche Voice-Over oder szene neu strukturiert sein. PLV fragt.
- Ausgabe: ein Produkt-Launch / SaaS-Promo als HyperFrames-Komposition → MP4 (Sweet Spot 30-90s). Der Wert des Produkts ist das Thema, nicht ein Rundgang durch die Seite. Für eine einfache Tour der Seite verwende
/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 ein 60s-Promo", "Text-only Launch-Video, nicht scannen".
/website-to-video
- Eingabe: Eine Website / URL, deren Ziel es ist, die Website selbst zu zeigen, nicht ein Produkt zu verkaufen. Am besten für nicht-kommerzielle Websites (Portfolio, Blog, Docs, persönlich, Veranstaltung) oder wenn der Benutzer explizit einen Tour der Website so wie sie ist wünscht. Mit Headless Chrome für echte Screenshots + Marken-Assets erfasst. Wenn die Seite etwas verkauft und der Benutzer einen Promo möchte, verwende
/product-launch-video. - Ausgabe: ein Site-Tour / Showcase / Social-Clip, der aus den eigenen visuellen Elementen der Site erstellt wurde → 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, Artikel oder Notizen, die erklärt werden, ohne ein Produkt, das vermarktet wird, und ohne eine zu erfassende Website. (Abgeleitet von
/product-launch-video; kein Headless Chrome.) - Ausgabe: Faceless-Erklärvideo → MP4, jedes visuelle Element per Szene vom LLM erfunden (Typografie / Abstrakt / Diagramm / Datenvisualisierung); wird mit der
pin-and-paper-Vorlage ausgeliefert. (Sweet Spot 30-90s). - Auslöser: "Faceless-Erklärvideo ü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-Ref oder "dieser PR". Wird über diegh-CLI gelesen (keine zu scannende Website). - Ausgabe: Code-Änderungs-Erklärvideo (Changelog / Feature-Reveal / Fix / Refactor) → 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) zur Untertitelung, tatsächliches Filmmaterial, keine URL oder kein Briefing. Lokal transkribiert (Whisper, kein API-Schlüssel) und mattiert (RVM), sodass das Motiv Untertitel überdecken kann.
- Ausgabe: dasselbe Filmmaterial unberührt, mit einer Untertitelebene, Standard (wortwörtliche untere Schiene + ein eingebetteter Höhepunkt hinter dem Motiv) oder Kinematografisch (jeder Untertitel hinter dem Motiv zusammengesetzt). Jede Länge.
- Auslöser: "Füge diesem Video Untertitel / Beschriftungen hinzu", "Untertitel hinter dem Motiv", "Kinematografische Untertitel für meinen Clip".
/talking-head-recut
- Eingabe: Ein vorhandenes Talking-Head- / Interview- / Podcast-Video (MP4), das mit Bildschirmgrafiken verpackt werden soll, tatsächliches Filmmaterial. Lokal transkribiert (Whisper). Der Clip läuft vollständig darunter, unberührt.
- Ausgabe: dasselbe Filmmaterial mit zeitlich abgestimmten Grafik-Overlay-Karten: kinetische Titel, Lower-Thirds, Daten-Callouts, Pull-Quote, Seitenfelder, Bild-in-Bild, synchronisiert
…
[für die Übersetzung abgeschnitten]