HyperFrames – Start hier
HyperFrames rendert Videos aus HTML – eine Komposition ist eine HTML-Datei, deren DOM mit data-*-Attributen zeitlich gesteuert wird, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework verwaltet wird. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lesen Sie diesen, bevor Sie Kompositions-HTML schreiben.
Unten: eine Fähigkeitskarte (die Domain-Skills, die bei Bedarf geladen werden) und der Intention-Router (wählen Sie einen Workflow für jede „Erstelle mir eine …“-Anfrage – normalerweise ein Video, aber auch ein navigierbares Deck oder eine Kompositionsportierung). Die Aufteilung erfolgt nach Eigentum, nicht nach Ausgabetyp: Ein Workflow besitzt ein durchgängig lieferbares Ergebnis (sein eigenes Projektverzeichnis, abgestufte Schritte, Unter-Agenten, endgültiges Artefakt); eine Domain-Skill ist eine Fähigkeitsebene, die ein Workflow während des Prozesses einbindet und niemals die Aufgabe besitzt.
Fähigkeitskarte – die Domain-Skills
Atomare Fähigkeiten, die Sie bei Bedarf laden – keine vollständigen Workflows; sie besitzen niemals die durchgängige Aufgabe. Verwenden Sie für „Erstelle mir eine …“-Absichten den Intentionsrouter unten.
| Sie möchten… | Skill |
|---|---|
Eine HTML-Komposition erstellen / bearbeiten – der data-*-Vertrag, Clips, Spuren, Unterkompositionen, Variablen | /hyperframes-core |
| Animieren – atomare Bewegung, Szenenentwürfe, Übergänge, Laufzeitadapter (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Sichere Keyframes für die Suche erstellen – GSAP-Timelines, CSS-Keyframes, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG-Morph/Zeichnung, 3D-Tiefe, plus hyperframes keyframes-Diagnose | /hyperframes-keyframes |
Kreative Leitung – frame.md / design.md, Paletten, Typografie, Erzählung, Taktplanung, audio-reaktiv | /hyperframes-creative |
| Medien – Auflösen/Generieren von BGM, SFX, Bild, Symbol, Markenlogo, Stimme; TTS-Voiceover, Transkription, Hintergrundentfernung, Untertitel; projektübergreifende Wiederverwendung | /media-use |
| CLI-Entwicklungsschleife – 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 / natives Export) | /figma |
Intentionsrouting – Wählen Sie einen Workflow
Dieser Abschnitt kennt nur die Workflows der obersten Ebene; er lädt nicht deren interne Referenzen oder die oben genannten Domain-Skills.
Vor dem Routing – Bestätigen Sie 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 („Erstellen Sie ein Video über unser Ding“ ohne URL, Produkt, Thema oder Asset), fragen Sie nach, bevor Sie einen Workflow betreten – die Festlegung auf einen Workflow IST die Routing-Entscheidung. Maximal zwei Fragen:
- Eingabe – ein Produkt (URL / Kurzbeschreibung), eine allgemeine Website, ein GitHub-PR, ein zu erklärendes Thema oder ein vorhandenes Talking-Head-Video?
Modus – wenn die Anfrage ein fortlaufendes autonomes Signal trägt („überraschen Sie mich“, „entscheiden Sie für mich“, „bauen Sie es einfach“), notieren Sie es und geben Sie es an den Workflow weiter: Der gesamte Durchlauf wird autonom und kein späterer Schritt fragt erneut. Ohne Signal fragt der Workflow nach dem Modus als erste kurze Frage. Standard ist kollaborativ. (/motion-graphics ist von Natur aus autonom.) Semantik: hyperframes-core → references/brief-contract.md.
Standardwerte der Spezifikation – Zustand, nicht fragen (sie ändern niemals die Route): Seitenverhältnis leitet sich vom Ziel ab – Social Feed (X / LinkedIn / Instagram) → quadratisch 1:1, TikTok / Reels / Shorts → 9:16, YouTube / Einbettung / unbekannt → 16:9; Erzähl-/Untertitel-Sprache = die des Benutzers. Der gewählte Workflow bestätigt seine eigenen Spezifika in seinem ersten Schritt (Feldsemantik: hyperframes-core → references/brief-contract.md).
Workflow-Spickzettel
| Workflow | Verwenden Sie es für |
|---|---|
/product-launch-video | Ein Produkt verkaufen (SaaS, App, Unternehmen / Produktwebsite) – von einer URL, einer Kurzbeschreibung oder einem Skript → einen Werbepunkt. Der Standard für jede kommerzielle URL, selbst wenn die Website nur genannt wird. |
/website-to-video | Eine Website selbst zeigen – eine Tour / Präsentation, die aus den eigenen Screenshots der Website erstellt wurde. Für nicht-kommerzielle Websites (Portfolio, Blog, Docs, persönlich, Veranstaltung) oder wenn der Benutzer eine Tour und keinen Werbespot wünscht. |
/faceless-explainer | Ein Thema / Konzept aus Text erklären – kein Produkt, keine URL; jedes Bild wird vom LLM erfunden |
/pr-to-video | Ein GitHub-PR / eine Codeänderung → Changelog / Feature-Präsentation / Fix-/Refactoring-Erklärvideo |
/embedded-captions | Hinzufügen von Untertiteln / Untertitel zu einem vorhandenen Talking-Head-Video (Bildmaterial unberührt) |
/talking-head-recut | Verpacken eines vorhandenen Talking-Head-Videos mit designten grafischen Overlays – Lower-Thirds, Daten-Callouts, kinetische Titel, Pull-Quote |
/motion-graphics | Ein kurzes (~unter 10s), unbesprochenes Stück, bei dem die Bewegung die Botschaft ist – kinetische Typografie, ein Statistik-/Diagramm-Treffer, ein Logo-Sting, eine animierte Karte, ein animierter Tweet / eine Schlagzeile, ein eigenständiges Lower-Third / Overlay (MP4 oder mit transparentem Alphakanal) |
/music-to-video | Ein Musikstück → ein takt-synchronisiertes Video – Lyrikvideo, Slideshow oder kinetischer Werbespot; die Musik bestimmt das Tempo (optionale Benutzerbilder/-videos werden auf das Taktgitter 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 | Portieren einer vorhandenen Remotion (React)-Komposition zu HyperFrames (Migration, keine Neuerstellung) |
Disambiguierung (nur bei Verwechslungsgefahr):
- Bewegungsorientiert & unbesprochen (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 / Unternehmenswebsite) →
/product-launch-video– ein Werbespot, und der Standard für jede kommerzielle URL, selbst 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 / Veranstaltung) →/website-to-video– eine Tour. Ein GitHub-PR-Link →/pr-to-video; ein Konzept ohne Produkt oder Website →/faceless-explainer. - Vorhandenes Bildmaterial – einfache gesprochene Untertitel →
/embedded-captions; designte Overlay-Karten →/talking-head-recut. Keines von beiden bearbeitet das Bildmaterial selbst (Neutaktung / Neufärbung / Neurahmung / Neuordnung / Audio ist NLE-Schnitt – nicht im Lieferumfang enthalten). - 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 oben genannten, eingabeangepassten Workflow;/motion-graphicsist für kurze, unerzählte 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 „Slideshow“-Anfrage wird direkt verarbeitet; ein benachbarter Auslöser („Deck / Folien / Präsentation / diese Seite konvertieren“) lässt/slideshowvor dem Erstellen bestätigen, dass es sich um eine Slideshow handelt, und wechselt andernfalls zum entsprechenden Nicht-Slideshow-Workflow. - Die Länge ist ein Leitfaden, kein Tor – die Absicht wählt den Workflow; gehen Sie nur zu
/general-video, wenn das Stück deutlich länger als ~3 Min. ist oder ein statisches / Schleifen- / benutzerdefiniertes Format hat.
Nach der Auswahl – Stellen Sie sicher, dass der Workflow installiert ist
Sobald Sie einen Workflow ausgewählt haben, führen Sie den Aktualisierungsschritt vor dem Lesen seiner Skill aus – Workflow-Skills werden bei Bedarf installiert, daher ist der von Ihnen ausgewählte möglicherweise noch nicht auf diesem Rechner vorhanden (seine Auslösephrasen befinden sich genau aus diesem Grund in diesem Router, damit Sie zu Skills routen können, die nicht installiert sind):
npx hyperframes skills update <workflow-name>
Reiner Name, ohne führendes / – z. B. npx hyperframes skills update pr-to-video. Die Benennung einer Skill garantiert, dass sie plus die Kern-Domain-Skills, von denen jeder Workflow abhängt, installiert und aktuell sind: ein schneller No-Op, wenn alles bereits vorhanden ist, eine gezielte Installation nur der fehlenden/veralteten Skills, wenn nicht – niemals die gesamte Menge. Lesen Sie dann die Skill des Workflows und fahren Sie fort. Der gleiche Befehl funktioniert für eine On-Demand-Domain-Skill aus der Fähigkeitskarte (z. B. npx hyperframes skills update figma).
Wenn der Befehl fehlschlägt, zeigen Sie 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 installieren lazy: die Kernmenge eagerly, die Workflows bei erster Verwendung.
- Kernmenge – dieser Router, die
hyperframes-*-Domain-Skills undmedia-use.npx hyperframes init(das jeder Erstellungs-Workflow beim Einrichten des Gerüsts ausführt) überprüft GitHub und aktualisiert die Kernmenge sowie alles andere, was bereits installiert ist. Es erweitert die Installation niemals – Workflow-Skills, die Sie nicht verwendet haben, werden nicht gezogen. Das erneute Ausführen von init auf einem aktuellen Rechner ist ein No-Op; offline (oder ratenbegrenzt) wird es elegant heruntergestuft und schlägt niemals hart fehl. Das--skip-skills-Flag ist derzeit neutralisiert (eine vorübergehende Maßnahme, während die skills.sh-Registry aufholt); CI/Tests optieren über die UmgebungsvariableHYPERFRAMES_SKIP_SKILLS=1aus. - Workflow-Skills – werden zum Zeitpunkt der Auslösung durch den obigen Aktualisierungsschritt installiert und aktualisiert (
skills update <workflow-name>).
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 eine maschinenlesbare Bewertung hinzu; beendet sich mit einem Fehler, wenn etwas Installiertes veraltet ist oder die Kernmenge unvollständig ist – noch nicht installierte Workflow-Skills werden als auf Abruf verfügbar gemeldet, nicht als Fehler). - Aktualisieren:
npx hyperframes skills update– aktualisiert die Kernmenge plus alles Installierte auf die neueste Version und entfernt Skills, die nicht mehr veröffentlicht werden. Ohne Namen installiert es niemals Workflows, die Sie nicht verwendet haben; das Benennen von Skills (skills update <name…>) installiert diese zusätzlich. - Gesamte Menge, explizit:
npx hyperframes skills(odernpx skills add heygen-com/hyperframes --all).
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 nach Assets + Marken-Tokens durchsucht), (b) ein Skript / eine Kurzbeschreibung, die auch ohne Link die Website des Produkts nennt (PLV löst die URL auf + durchsucht sie, es sei denn, der Benutzer widerspricht), oder (c) ein Skript ohne ableitbare Website / „nicht scrapen“ (kein Aufnahmemodus – wählen Sie eine Stilvorlage, die Palette + Designsystem bereitstellt). Ein bereitgestelltes Skript kann das wörtliche Voice-Over oder je Szene umstrukturiert sein – PLV fragt nach.
- Ausgabe: ein Produkteinführungs- / SaaS-Werbepunkt als HyperFrames-Komposition → MP4 (Sweet Spot 30–90s) – der Wert des Produkts ist das Thema, nicht ein Rundgang durch die Website. Für eine reine Tour durch die Website verwenden Sie
/website-to-video. - Auslöser: „Launch-Video für X“, „Werbespot für unsere Website“, „Erklären Sie mein SaaS in einer Minute“, „Verwandeln Sie mein Skript in einen 60s-Werbespot“, „Nur-Text-Launch-Video, nicht scrapen“.
/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 eine Tour durch eine Website wünscht, wie sie ist. Mit Headless-Chrome für echte Screenshots + Marken-Assets erfasst.
...