HyperFrames – hier starten
HyperFrames rendert Video aus HTML – eine Komposition ist eine HTML-Datei, deren DOM das Timing mit data-*-Attributen deklariert, deren Animation-Laufzeit seekbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lese ihn, bevor du Kompositions-HTML schreibst.
Unten: eine Fähigkeitskarte (die Bereichsskills, die bei Bedarf geladen werden) und der Intent-Router (wähle einen Workflow für jede „Mach mir eine …“-Anfrage – normalerweise ein Video, aber auch ein navigierbares Deck oder eine Kompositions-Portierung). Die Aufteilung erfolgt nach Verantwortlichkeit, nicht nach Ausgabetyp: Ein Workflow besitzt ein End-to-End-Ergebnis (eigenes Projektverzeichnis, abgestufte Schritte, Sub-Agenten, finales Artefakt); ein Bereichsskill ist eine Fähigkeitsebene, die ein Workflow während der Ausführung einbindet und niemals die Aufgabe besitzt.
Fähigkeitskarte – die Bereichsskills
Atomare Fähigkeiten, die du bei Bedarf lädst – keine vollständigen Workflows; sie besitzen niemals die End-to-End-Aufgabe. Für „Mach mir eine …“-Absichten verwende den Intent-Router unten.
| Du möchtest … | Skill |
|---|---|
Eine HTML-Komposition erstellen / bearbeiten – der 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-Timelines, CSS-Keyframes, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG-Morph/Zeichnen, 3D-Tiefe, plus hyperframes keyframes-Diagnose | /hyperframes-keyframes |
Kreative Richtung – frame.md / design.md, Paletten, Typografie, Erzählung, Beat-Planung, audio-reaktiv | /hyperframes-creative |
| Medien – BGM, SFX, Bild, Icon, Markenlogo, Stimme, Farbkorrektur, LUT auflösen/generieren; TTS-Voiceover, Transkription, Hintergrundentfernung, Untertitel; projektübergreifende Wiederverwendung | /media-use |
| CLI-Entwicklungszyklus – init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, doctor | /hyperframes-cli |
Registry-Blöcke / Komponenten installieren (hyperframes add) | /hyperframes-registry |
| Figma-Inhalte importieren – Assets, Tokens, Komponenten, Storyboards → rekonstruierte Bewegung (REST/CLI); Motion (MCP), Shader (MCP-Quelle / nativer Export) | /figma |
Intent-Routing – Workflow auswählen
Dieser Abschnitt kennt nur die Workflows der obersten Ebene; er lädt weder deren interne Referenzen noch die Bereichsskills oben.
Vor dem Routing – die Eingabe bestätigen, nicht die Spezifikation
Das Routing muss wissen, worum es im Video geht – seine Eingabe und sein Thema. Falls dies nicht angegeben ist („Mach ein Video über unser Ding“ ohne URL, Produkt, Thema oder Asset), frage, bevor du einen Workflow betrittst – die Entscheidung für 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?
- Figma-Quelle – wenn die Eingabe eine figma.com-URL ist, extrahiert
/figmazuerst Assets/Tokens/(Komponenten/Storyboard), unabhängig davon, welcher Workflow unten für die Videoform gewählt wird; dieser Workflow baut dann aus der Ausgabe von/figmaauf – niemals durch direktes Steuern von Figma über rohe MCP-Tools (umgeht SVG-Bereinigung, Herkunftsnachweis und Marken-Token-Bindung).
Modus – wenn die Anfrage ein laufendes autonomes Signal mit sich führt („überrasch mich“, „entscheide für mich“, „bau es einfach“), notiere es und übergib es an den Workflow: Der gesamte Durchlauf läuft autonom und kein späterer Schritt fragt erneut nach. Ohne Signal fragt der Workflow den Modus als erste kurze Frage. Standard ist kollaborativ. (/motion-graphics ist standardmäßig autonom.) Semantik: hyperframes-core → references/brief-contract.md.
Spezifikations-Standardwerte – festlegen, nicht fragen (sie ändern nie die Route): Seitenverhältnis leitet sich vom Ziel ab – Social Feed (X / LinkedIn / Instagram) → quadratisch 1:1, TikTok / Reels / Shorts → 9:16, YouTube / Embed / unbekannt → 16:9; Erzählungs-/Untertitel-Sprache = die des Benutzers. Der gewählte Workflow bestätigt seine eigenen Spezifika im ersten Schritt (Feldsemantik: hyperframes-core → references/brief-contract.md).
Workflow-Spickzettel
| Workflow | Verwende es für |
|---|---|
/product-launch-video | Ein Produkt verkaufen (SaaS, App, Unternehmen / Produktseite) – von einer URL, einem Briefing oder einem Skript → ein Promo. Der Standard für jede kommerzielle URL, selbst wenn die Seite nur genannt wird. |
/website-to-video | Eine Site selbst zeigen – eine Tour / Showcase, die aus den Screenshots der Site erstellt wurde. Für nicht-kommerzielle Sites (Portfolio, Blog, Docs, persönlich, Veranstaltung) oder wenn der Benutzer eine Tour und kein Promo wünscht. |
/faceless-explainer | Ein Thema / Konzept aus Text erklären – kein Produkt, keine URL; jedes Bild wird von der KI erfunden |
/pr-to-video | Ein GitHub-PR / Code-Änderung → Changelog / Feature-Enthüllung / Fix / Refactor-Erklärer |
/embedded-captions | Untertitel / Bildunterschriften zu einem vorhandenen Talking-Head-Video hinzufügen (Aufnahme unverändert) |
/talking-head-recut | Ein vorhandenes Talking-Head-Video mit designten grafischen Overlays verpacken – Lower-Thirds, Daten-Callouts, kinetische Titel, Pull-Quotes |
/motion-graphics | Ein kurzes (~unter 10s), unbesprochenes Stück, bei dem die Bewegung die Botschaft ist – kinetischer Text, ein Statistik-/Diagramm-Hit, ein Logo-Sting, eine animierte Karte, ein animierter Tweet / eine Schlagzeile, ein eigenständiges Lower-Third / Overlay (MP4 oder transparentes Alpha) |
/music-to-video | Ein Musiktitel → ein beat-synchronisiertes Video – Lyric-Video, Diashow oder kinetisches Promo; die Musik bestimmt das Tempo (optionale Benutzerbilder / -videos werden auf dem 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 mehrszenige Stücke, eine statische Schleife / ein Poster, eine benutzerdefinierte Komposition |
/remotion-to-hyperframes | Eine vorhandene Remotion (React)-Komposition zu HyperFrames portieren (Migration, nicht Erstellung) |
Disambiguierung (nur bei Verwechslungsgefahr):
- Bewegungsfokussiert & unbesprochen (unter ~10s, die Bewegung ist die Botschaft) →
/motion-graphics, unabhängig von der Eingabe. - Eine URL oder ein Skript – frage eines: Verkauft die Seite 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 Site einfach so zeigen, wie sie ist (Portfolio / Blog / Docs / persönlich / Veranstaltung) →/website-to-video– eine Tour. Ein GitHub-PR-Link →/pr-to-video; ein Konzept ohne Produkt oder Site →/faceless-explainer. - Vorhandenes Filmmaterial – einfache gesprochene Wort-Untertitel →
/embedded-captions; designte Overlay-Karten →/talking-head-recut. Keines von beiden bearbeitet das Filmmaterial selbst (Zeitsteuerung / Neufärbung / Neurahmung / Neuanordnung / Audio ist NLE-Bearbeitung – außerhalb des Rahmens). - Ein Musiktitel ist die Eingabe (eine Audiodatei oder ein Video, aus dem Audio extrahiert wird) mit keiner Erzählung →
/music-to-video– die Beats/Energie des Musikstücks bestimmen das Tempo. (Besprochene Stücke bleiben beim oben eingabegemäßen Workflow;/motion-graphicsist für kurze, unbesprochene Bewegung, die nicht musikgesteuert ist.) - 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 wird direkt ausgeführt; ein angrenzender Auslöser („Deck / Folien / Präsentation / diese Seite konvertieren“) lässt/slideshowvor dem Erstellen bestätigen, dass es sich um eine Diashow handelt, und wechselt bei Bedarf zum geeigneten Nicht-Diashow-Workflow. - Länge ist ein Leitfaden, kein Hindernis – der Zweck bestimmt den Workflow; gehe nur zu
/general-video, wenn das Stück eindeutig länger als ~3 Min. ist oder ein statisches / Schleifen- / benutzerdefiniertes Format hat.
Nach der Auswahl – stelle sicher, dass der Workflow installiert ist
Nachdem du einen Workflow ausgewählt hast, führe den Aktualisierungsschritt vor dem Lesen seines Skills aus – Workflow-Skills werden bei Bedarf installiert, daher ist der passende möglicherweise noch nicht auf diesem Rechner (seine Triggerphrasen befinden sich in genau diesem Router, damit du zu Skills routen kannst, die nicht installiert sind):
npx hyperframes skills update <workflow-name>
Nackter Name, ohne führendes / – z. B. npx hyperframes skills update pr-to-video. Die Benennung eines Skills garantiert, dass er plus die Kern-Bereichsskills, von denen jeder Workflow abhängt, installiert und aktuell sind: ein schneller No-Op, wenn bereits alles vorhanden ist, eine gezielte Installation nur der fehlenden/veralteten Skills, wenn nicht – niemals der gesamte Satz. Lies dann den Skill des Workflows und fahre fort. Der gleiche Befehl funktioniert für einen bedarfsgesteuerten Bereichsskill aus der Fähigkeitskarte (z. B. npx hyperframes skills update figma).
Wenn der Befehl fehlschlägt, zeige seinen Fehler dem Benutzer an, anstatt den Workflow aus dem Gedächtnis zu improvisieren. Manueller Fallback (keine HyperFrames-CLI verfügbar): npx skills add heygen-com/hyperframes --skill <workflow-name>; alles auf einmal: npx skills add heygen-com/hyperframes --all.
Skills aktuell halten
HyperFrames-Skills sind versioniert und werden lazy installiert: der Kernbereich sofort, die Workflows bei der ersten Verwendung.
- Kernbereich – dieser Router, die
hyperframes-*-Bereichsskills undmedia-use.npx hyperframes init(das jeder Erstellungs-Workflow beim Einrichten ausführt) überprüft GitHub und aktualisiert den Kernbereich sowie alles andere, das bereits installiert ist. Es erweitert die Installation niemals – Workflow-Skills, die du nicht verwendet hast, werden nicht abgerufen. Ein erneutes Ausführen von init auf einem aktuellen Rechner ist ein No-Op; offline (oder ratenbegrenzt) verschlechtert es sich anmutig und schlägt niemals hart fehl. Das Flag--skip-skillsist derzeit neutralisiert (eine vorübergehende Maßnahme, während die skills.sh-Registry aufholt); CI/Tests melden sich über die UmgebungsvariableHYPERFRAMES_SKIP_SKILLS=1ab. - Workflow-Skills – werden zum Zeitpunkt der Auslösung durch den obigen Aktualisierungsschritt installiert und aktualisiert (
skills update <workflow-name>).
Wenn eine Aufgabe sich 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 eine maschinenlesbare Ausgabe hinzu; beendet sich mit einem Code ungleich Null, wenn etwas installiertes veraltet ist oder der Kernbereich unvollständig ist – noch nicht installierte Workflow-Skills werden als auf Abruf verfügbar gemeldet, nicht als Fehler). - Aktualisieren:
npx hyperframes skills update– aktualisiert den Kernbereich plus alles installierte auf die neueste Version und entfernt Skills, die nicht mehr veröffentlicht werden. Ohne Namen installiert es niemals Workflows, die du nicht verwendet hast; die Benennung von Skills (skills update <name…>) installiert diese zusätzlich. - Vollständiger Satz, explizit:
npx hyperframes skills(odernpx skills add heygen-com/hyperframes --all).
Die CLI zeigt außerdem eine einzeilige Erinnerung an, wenn ein render- / lint- / validate-Durchlauf 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 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 bereitstellt). Ein bereitgestelltes Skript kann das wörtliche Voice-Over oder umstrukturiert pro Szene sein – PLV fragt.
- Ausgabe: Ein Produkt-Launch / SaaS-Promo als HyperFrames-Komposition → MP4 (Sweet Spot 30–90s) – der Produktwert ist das Thema, nicht ein Rundgang durch die Site. Für eine einfache Tour der Site verwende
/website-to-video. - Auslöser: „Launch-Video für X“, „Promo für unsere Site“, „erkläre mein SaaS in einer Minute“, „verwandle mein Skript in ein 60s-Promo“, „Text …
[gekürzt für die Übersetzung]