Mediennutzung: Bevor Audio/Quellen/Bilder beschafft werden, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe Skill/media-use.
Website zu HyperFrames
Erfasse eine Website und erstelle daraus ein professionelles Video.
Bestätige den Pfad vor Schritt 0. Dieser Skill erstellt ein Video von / aus einer allgemeinen Website. Wenn der Benutzer wirklich ein Produkt vermarktet / launched / bewirbt (auch von dieser URL, selbst wenn es "Promo für unsere Website" heißt) →
/product-launch-video. Ein thematisches Erklärvideo ohne Website →/faceless-explainer; ein GitHub-PR →/pr-to-video; Nachbearbeitung / Neufärbung / Neuanordnung einer vorhandenen Videodatei → nicht im Rahmen. Wird hierher weitergeleitet bei vager Aufforderung "Erstelle ein Video" oder bei Unsicherheit, ob Launch oder allgemeine Website? Lies zuerst/hyperframes(vollständige Routing-Tabelle + § Was HyperFrames nicht kann).
Benutzer sagen Dinge wie:
- "Wandle diese Website in einen 15-Sekunden Social Clip für Instagram um."
- "Erstelle eine 30-sekündige Site-Tour / einen Showcase von https://..."
- "Erfasse unsere Homepage und erstelle ein Video aus ihren eigenen visuellen Inhalten."
Der Workflow besteht aus 7 Schritten. Jeder erzeugt ein Artefakt, das den nächsten Schritt freigibt. Standardmäßig ist er kollaborativ – Tore, die mit 💬 markiert sind, halten an und fragen den Benutzer. Wenn der Benutzer den autonomen Modus signalisiert („entscheide für mich“, „überrasche mich“), werden die benutzerpräferenzabhängigen 💬-Tore übersprungen; siehe step-2-brief.md, wie sich das fortpflanzt.
Der autonome Modus ist NICHT „überspringe alle Tore“. Der automatische Modus deckt Fragen zu Benutzerpräferenzen ab (TTS-Anbieter, Stimme, Farbakzente, Beat-Anzahl, Musik ja/nein, Untertitel ja/nein – bei denen der Agent im Namen des Benutzers entscheidet). Er deckt NICHT die Qualitätssicherungstore ab. Die folgenden bleiben im automatischen Modus nicht überspringbar:
- Asset-Audit (Schritt 3) – Ansicht der Kontaktabzüge und Begründung der VERWENDUNG / ÜBERSPRUNG für jedes Asset
- Pro-Beat-HTML-Lesen (Schritt 5) – strukturierter Nachweisblock pro Beat
- DoD-Checkliste (Schritt 6) – einschließlich Animations-Map, WCAG-Überprüfung pro Warnung, Audio-/Bewegungswiedergabe
- Ehrlicher Offenlegungsabschnitt (Schritt 6) – „Was ich NICHT überprüft habe“ muss in der endgültigen Zusammenfassung erscheinen
Solltest du denken „autonomer Modus sagt Tendenz zum Handeln, also überspringe ich X“ – und X ist ein Verifikationstor, keine Präferenzfrage – dann ist dieses Denken falsch. Tendenz zum Handeln gilt für die Entscheidung, was gebaut werden soll, nicht für die Entscheidung, ob überprüft werden soll.
Schritt 0: Erfassen & Verstehen der Marke
Lies: references/step-0-capture.md
Erfasse die Website und lies dann die extrahierten Daten, um die Marke und das Produkt zu verstehen – was es tut, für wen es ist, welche Stimme es spricht, in welcher Stimmung es lebt. Die erfassten Assets sind ein Markenwerkzeugkasten für später, nicht die Bausteine, aus denen das Video besteht.
Zeige den Anmeldestatus vor dem Brief – führe npx hyperframes auth status aus und gib die Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es wird berichtet, ob Voice/BGM HeyGen oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPPE und warte, bis der Benutzer wählt – anmelden oder „go"/"offline" sagen, um mit lokalen Engines fortzufahren – bevor du nach dem Brief oder irgendetwas anderem fragst. Behandle es als echten Entscheidungspunkt, nicht als beiläufige Notiz; klappe die Wahl nicht in die Brief-Frage und schreibe keine Schlüssel in eine pro-Repo .env. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Tor: Site-Zusammenfassung gedruckt – strategie-zuerst (was das Produkt tut, für wen es ist, Markenstimme) vor dem Asset-/Farb-/Schriftinventar; Anmeldestatus wurde gezeigt (angemeldet oder Fortsetzung offline).
Schritt 1: Markenidentität
Lies: references/step-1-design.md
Schreibe DESIGN.md – einen Marken-Spickzettel, der die visuelle Identität abdeckt: Farben, Typografie, Komponentenstile, Layout-Prinzipien. Verwende design-styles.json für genaue berechnete Werte.
Geschwindigkeitsoption: Für schnell getaktete Videos (Billboard-pro-Beat) kann DESIGN.md eine 50-zeilige Zusammenfassung von Farben + Schriftarten + Dos/Don'ts sein – kein 300-zeiliges Dokument. Der Sub-Agent-Prompt in Schritt 5 fügt Markenwerte direkt ein, daher ist die Tiefe von DESIGN.md nur für komplexe Kompositionen relevant.
Tor: DESIGN.md existiert (beliebige Länge) mit mindestens: Farbpalette, Schriftauswahl und Dos/Don'ts.
Schritt 2: Strategie & Botschaft
Lies: references/step-2-brief.md, references/capabilities.md (überfliege das Inhaltsverzeichnis – vertiefende Abschnitte nur bei Bedarf)
Stimme dich mit dem Benutzer ab, was das Video kommunizieren muss, bevor du über Bilder oder Assets sprichst. Analysiere die Eingabeaufforderung des Benutzers – er hat dir wahrscheinlich bereits den Videotyp und -stil genannt. Frage nur nach dem, was fehlt: die EINE Sache, die dieses Video sagen muss, der narrative Bogen und die Zielgruppe.
Tor: Videotyp, Dauer, Format und – entscheidend – die Botschaft und der narrative Bogen sind festgelegt. Ohne diese kann Schritt 3 kein konzeptorientiertes Storyboard schreiben.
Schritt 3: Storyboard + Drehbuch 💬
Lies: references/step-3-storyboard.md
Schreibe das Storyboard konzepterst: Botschaft → narrativer Bogen → Beats, die den Bogen bedienen → Techniken pro Beat → Markenakzente am Ende. Schreibe dann das Erzähldrehbuch passend dazu. Präsentiere beides dem Benutzer mit einer Beat-für-Beat-Zusammenfassung. Iteriere, bis er zustimmt.
Tor: STORYBOARD.md + SCRIPT.md existieren UND der Benutzer hat den Plan genehmigt.
Schritt 4: VO, Timing + Untertitel 💬
Lies: references/step-4-vo.md
Wenn Schritt 2 „keine Erzählung" sagte – frage nach Hintergrundmusik und springe dann zu Schritt 5. Andernfalls: Frage den Benutzer nach dem TTS-Anbieter (HeyGen TTS, ElevenLabs oder Kokoro), generiere Audio, transkribiere, ordne Zeitstempel den Beats zu. Frage dann nach Untertiteln.
Tor: Entweder (a) es wurde keine Erzählung gewünscht und das Storyboard hat manuelle Beat-Timings, oder (b) narration.wav + transcript.json existieren und Beat-Timings wurden mit echten Dauern aktualisiert.
Schritt 5: Kompositionen erstellen
Lies: Den Skill hyperframes (lade ihn – jede Regel zählt)
Lies: references/step-5-build.md
Erstelle index.html und Kompositionen gemäß der im Storyboard (Schritt 3) gewählten Architektur und Taktung. Sub-Agenten führen hyperframes lint und hyperframes snapshot für jeden Beat aus, bevor sie zurückmelden.
Tor: Jede compositions/beat-N.html wurde vom Hauptagenten von oben bis unten gegen DESIGN.md und STORYBOARD.md gelesen. Die Pro-Beat-Checkliste befindet sich in step-5-build.md.
Schritt 6: Validieren & Ausliefern
Lies: references/step-6-validate.md
Linte, validiere, mache Snapshots, skaliert auf die Videolänge (Formel: max(beats × 3, ceil(duration_seconds / 2))), und überprüfe jeden. Behebe Probleme vor der Auslieferung. Liefere die lokale Studio-Projekt-URL aus – rendere nur auf ausdrücklichen Benutzerwunsch als MP4. Gib die Studio-URL nur bei der Übergabe aus – sie ist die finale, stabile Vorschau; die Snapshots der Bauphase sind Headless, zeige also keine Vorschau während des Baus.
Liefere etwas aus, auf das du stolz bist. Frage dich vor der Übergabe: Würde ich das in den sozialen Medien mit meinem Namen veröffentlichen? Wenn nicht, behebe, was falsch ist.
Tor: npx hyperframes lint und npx hyperframes validate bestehen mit null Fehlern, und die endgültige Antwort enthält die aktive Studio-Projekt-URL.
Kurzreferenz
Videotypen
Typische Einschränkungen nach Videotyp – verwende sie als Ausgangspunkt, nicht als Formel. Die Beat-Anzahl sollte sich aus dem Inhalt und der Erzählung ergeben, nicht aus einem Zielbereich.
| Typ | Typische Dauer | Dauer-Treiber | Erzählung |
|---|---|---|---|
| Social Ad (IG/TikTok) | 10–15s | Plattformlimit | Optional |
| Produktdemo | 30–60s | Skriptlänge | Vollständige Erzählung |
| Feature-Ankündigung | 15–30s | Feature-Komplexität | Vollständige Erzählung |
| Brand-Reel | 20–45s | Musiktitel | Optional, Musikfokus |
| Launch-Teaser | 10–20s | Hook-Energie | Minimal |
Die Beat-Anzahl ist absichtlich nicht in dieser Tabelle enthalten – sie sollte aus dem Storyboard stammen, nicht aus „Social Ad = 3-4 Beats." Eine Social Ad für ein komplexes Produkt könnte 5 gut getaktete Beats benötigen. Ein Brand-Reel mit einer starken visuellen These könnte 3 benötigen.
Format
- Landschaft: 1920x1080 (Standard)
- Hochformat: 1080x1920 (Instagram Stories, TikTok)
- Quadratisch: 1080x1080 (Instagram-Feed)
Referenzdateien
| Datei | Wann lesen |
|---|---|
| step-0-capture.md | Schritt 0 – erfassen, Marke und Produkt verstehen, strategieorientierte Site-Zusammenfassung schreiben |
| step-1-design.md | Schritt 1 – DESIGN.md Marken-Spickzettel schreiben (5 Abschnitte, 250-350 Zeilen; 50-zeiliger Schnellpfad für Billboard-artige Social Ads) |
| step-2-brief.md | Schritt 2 – Botschaft, narrativen Bogen und Zielgruppe mit dem Benutzer abstimmen |
| capabilities.md | Schritte 2 & 5 – vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). Überfliege das Inhaltsverzeichnis während des Briefs, vertiefe bestimmte Abschnitte während des Baus |
| step-3-storyboard.md | Schritt 3 – Storyboard + Drehbuch (kombiniert) mit Benutzerüberprüfungstor |
| step-4-vo.md | Schritt 4 – TTS-Anbieterauswahl, Generierung, Timing |
| step-5-build.md | Schritt 5 – index.html + Kompositionen erstellen |
| step-6-validate.md | Schritt 6 – linten, validieren, Snapshots (skaliert auf Videolänge), Vorschau |
| techniques.md | Schritte 3 & 5 – 13 primitive Animationstechniken mit Code-Mustern (anpassen, nicht kopieren und einfügen) |
| html-in-canvas-patterns.md | Schritt 5 – vollständige Code-Muster für HTML-in-Canvas-Effekte (befindet sich im hyperframes-Skill) |