media-use: Bevor Audioquellen/Bilder beschafft werden, rufe
/media-useauf, um Hintergrundmusik/Soundeffekte/Bilder aus dem HeyGen-Katalog zu beziehen. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-use-Skill.
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 tatsächlich ein Produkt vermarktet / launcht / bewirbt (selbst von dieser URL, selbst „Promo für unsere Seite“) →
/product-launch-video. Ein Themenerklärer ohne Website →/faceless-explainer; ein GitHub-PR →/pr-to-video; ein vorhandenes Video neu schneiden / einfärben / anordnen → nicht im Rahmen. Hier gelandet bei vager Anweisung „Erstelle ein Video“ oder unsicher, ob Launch oder allgemeine Website? Lies zuerst/hyperframes(vollständige Routingtabelle + § Was HyperFrames nicht kann).
Benutzer sagen Dinge wie:
- „Verwandle diese Website in einen 15-Sekunden-Social-Clip für Instagram“
- „Erstelle eine 30-Sekunden-Website-Tour / Showcase von https://...“
- „Erfasse unsere Startseite und baue ein Video aus ihren eigenen visuellen Elementen“
Der Workflow hat 7 Schritte. Jeder erzeugt ein Artefakt, das den nächsten Schritt freischaltet. Standardmäßig ist er kollaborativ – mit 💬 markierte Tore stoppen und fragen den Benutzer. Signalisiert der Benutzer den autonomen Modus („entscheide für mich“, „überrasche mich“), werden 💬 Tore mit Benutzerpräferenzen übersprungen; siehe step-2-brief.md für die Auswirkungen.
Der autonome Modus bedeutet NICHT „alle Tore überspringen“. Der Automatikmodus deckt Benutzerpräferenzfragen ab (TTS-Anbieter, Stimme, Farbakzente, Anzahl Beats, Musik ja/nein, Untertitel ja/nein – bei denen der Agent anstelle des Benutzers entscheidet). Er deckt NICHT Qualitätssicherungstore ab. Die folgenden Tore bleiben auch im Automatikmodus nicht überspringbar:
- Asset-Audit (Schritt 3) – Kontaktbögen ansehen und USE/SKIP für jedes Asset rechtfertigen
- 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 verifiziert habe“ muss in der endgültigen Zusammenfassung erscheinen
Wenn du denkst „Automatikmodus bedeutet Tendenz zum Handeln, also überspringe ich X“ – und X ist ein Verifikationstor, keine Präferenzfrage – dann ist diese Überlegung falsch. Die Tendenz zum Handeln gilt für die Entscheidung, was gebaut werden soll, nicht für die Entscheidung, ob verifiziert werden soll.
Schritt 0: Erfassen und Verstehen der Marke
Lies: references/step-0-capture.md
Erfasse die Website, 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 Marken-Werkzeugkasten für später, nicht die Bausteine, aus denen das Video besteht.
Zeige den Anmeldestatus vor dem Briefing – führe npx hyperframes auth status aus und gib die Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es wird gemeldet, ob Sprache/Hintergrundmusik HeyGen oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOP und warte auf die Wahl des Benutzers – anmelden oder „go“/„offline“ sagen, um mit lokalen Engines fortzufahren – bevor du nach dem Briefing oder irgendetwas anderem fragst. Behandle es als echten Entscheidungspunkt, nicht als beiläufige Notiz; klappe die Wahl nicht in die Briefing-Frage ein und schreibe keine Schlüssel in eine pro-Repo .env-Datei. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Tor: Site-Zusammenfassung gedruckt – zuerst die Strategie (was das Produkt tut, für wen es ist, Markenstimme) vor dem Asset-/Farb-/Schriftinventar; Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).
Schritt 1: Markenidentität
Lies: references/step-1-design.md
Schreibe DESIGN.md – ein Marken-Spickzettel über die visuelle Identität: Farben, Typografie, Komponentenstile, Layout-Prinzipien. Verwende design-styles.json für exakte berechnete Werte.
Geschwindigkeitsoption: Für schnell geschnittene Videos (Billboard-pro-Beat) kann DESIGN.md eine 50-zeilige Zusammenfassung von Farben + Schriften + Do's/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 Do's/Don'ts.
Schritt 2: Strategie und Botschaft
Lies: references/step-2-brief.md, references/capabilities.md (scanne das Inhaltsverzeichnis – ausführliche Abschnitte nur bei Bedarf)
Stimme dich mit dem Benutzer ab, was das Video kommunizieren muss, bevor du über Bilder oder Assets sprichst. Analysiere die Eingabe 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 konzeptorientiert: Botschaft → narrativer Bogen → Beats, die dem Bogen dienen → Techniken pro Beat → Markenakzente am Ende. Schreibe dann das Erzählskript passend dazu. Präsentiere beides dem Benutzer mit einer Beat-für-Beat-Zusammenfassung. Wiederhole, bis er zustimmt.
Tor: STORYBOARD.md + SCRIPT.md existieren UND der Benutzer hat den Plan genehmigt.
Schritt 4: Sprachausgabe, Timing + Untertitel 💬
Lies: references/step-4-vo.md
Wenn Schritt 2 „keine Erzählung“ vorgesehen hat – frage nach Hintergrundmusik, 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 hyperframes-Skill (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 des Timings. 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 Haupt-Agenten 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 und Ausliefern
Lies: references/step-6-validate.md
Linten, validieren, Screenshots erstellen, skaliert auf die Videolänge (Formel: max(beats × 3, ceil(duration_seconds / 2))), und jeden überprüfen. Behebe Probleme vor der Auslieferung. Liefere die lokale Studio-Projekt-URL aus – rendere nur auf expliziten Benutzerwunsch in MP4. Die Studio-URL nur bei der Übergabe preisgeben – sie ist die finale, stabile Vorschau; die Screenshots der Bauphase sind headless, zeige also keine Vorschau während des Bauens.
Liefere etwas, 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 ohne Fehler, und die endgültige Antwort enthält die aktive Studio-Projekt-URL.
Kurzreferenz
Videotypen
Typische Einschränkungen nach Videotyp – 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-Anzeige (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 befindet sich nicht absichtlich in dieser Tabelle – sie sollte aus dem Storyboard stammen, nicht aus „Social-Anzeige = 3-4 Beats“. Eine Social-Anzeige 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
- Querformat: 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-Social-Anzeigen) |
| step-2-brief.md | Schritt 2 – Botschaft, narrativen Bogen, Zielgruppe mit dem Benutzer abstimmen |
| capabilities.md | Schritte 2 & 5 – vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). Scanne das Inhaltsverzeichnis während des Briefings, tauche während des Bauens in bestimmte Abschnitte ein |
| step-3-storyboard.md | Schritt 3 – Storyboard + Drehbuch (kombiniert) mit Benutzer-Review-Tor |
| 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, Screenshots (skaliert auf Videolänge), Vorschau |
| techniques.md | Schritte 3 & 5 – 13 primitive Animationstechniken mit Code-Mustern (anpassen, nicht kopieren-einfügen) |
| html-in-canvas-patterns.md | Schritt 5 – vollständige Code-Muster für HTML-in-Canvas-Effekte (befindet sich im hyperframes-Skill) |