media-use: Bevor Audio/Assets beschafft werden,
/media-useaufrufen, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Zuerst--adoptausführen, 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. Dieses Skill erstellt ein Video von / über eine allgemeine Website. Wenn es dem Nutzer wirklich um Vermarktung / Launch / Promotion eines Produkts geht (auch von dieser URL, auch „Promo für unsere Website“) →
/product-launch-video. Ein themenspezifisches Erklärvideo ohne Website →/faceless-explainer; ein GitHub PR →/pr-to-video; Neu zuschneiden / einfärben / anordnen einer vorhandenen Videodatei → außerhalb des Rahmens. Wird hier bei einer vagen Aussage „Video erstellen“ oder bei Unsicherheit Launch-vs-allgemeine-Website gelandet? Lies zuerst/hyperframes(vollständige Routing-Tabelle + § Was HyperFrames nicht kann).
Nutzer sagen Dinge wie:
- „Verwandle diese Website in einen 15-Sekunden-Social-Clip für Instagram“
- „Erstelle eine 30-Sekunden-Site-Tour / Präsentation von https://…“
- „Erfasse unsere Startseite und baue 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, stoppen und fragen den Nutzer. Signalisiert der Nutzer den autonomen Modus („entscheide für mich“, „überrasche mich“), werden 💬 Nutzerpräferenz-Tore übersprungen; siehe Schritt-2-Brief.md für die Auswirkungen.
Der autonome Modus bedeutet NICHT „alle Tore überspringen“. Der automatische Modus deckt nutzerpräferenzbezogene Fragen ab (TTS-Anbieter, Stimme, Farbakzent, Beat-Anzahl, Musik ja/nein, Untertitel ja/nein – bei denen der Agent anstelle des Nutzers entscheidet). Er deckt NICHT die Qualitätssicherungstore ab. Die folgenden Tore bleiben im automatischen Modus nicht überspringbar:
- Asset-Audit (Schritt 3) – Sichtung der Kontaktbögen und Begründung von VERWENDEN/ÜBERSPRINGEN für jedes Asset
- Pro-Beat-HTML-Lesen (Schritt 5) – Strukturierter Nachweisblock pro Beat
- DoD-Checkliste (Schritt 6) – einschließlich Animations-Map, pro-Warnung-WCAG-Überprüfung, Audio-/Bewegungswiedergabe
- Ehrlicher Offenlegungsabschnitt (Schritt 6) – „Was ich NICHT überprüft habe“ muss in der endgültigen Zusammenfassung erscheinen
Wenn du denkst „der automatische Modus sagt Handlungsorientierung, also überspringe ich X“ – und X ist ein Überprüfungstor, keine Präferenzfrage – dann ist dieser Gedanke falsch. Handlungsorientierung gilt für die Entscheidung, was zu bauen ist, nicht dafür, ob zu überprüfen ist.
Schritt 0: Erfassung & Verständnis der Marke
Lies: references/step-0-capture.md
Erfasse die Website und lese dann die extrahierten Daten, um die Marke und das Produkt zu verstehen – was es tut, für wen es ist, in welcher 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 an – führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich wieder (nicht paraphrasieren oder umschreiben). Es gibt an, ob Stimme/BGM HeyGen oder lokale Engines verwenden und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPP und warte auf die Wahl des Nutzers – 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; falte die Wahl nicht in die Brief-Frage ein 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 der Asset-/Farb-/Schriftinventur; Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).
Schritt 1: Markenidentität
Lies: references/step-1-design.md
Schreibe DESIGN.md – ein 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 wichtig.
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 (scanne das Inhaltsverzeichnis – Detailabschnitte nur bei Bedarf)
Stimme dich mit dem Nutzer darüber ab, was das Video kommunizieren muss, bevor über visuelle Elemente oder Assets gesprochen wird. Analysiere die Eingabe des Nutzers – wahrscheinlich hat er/sie dir bereits den Videotyp und -stil genannt. Frage nur, 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 den Bogen bedienen → Techniken pro Beat → Markenakzente am Ende. Schreibe dann das Erzählskript dazu. Präsentiere beides dem Nutzer mit einer Beat-für-Beat-Zusammenfassung. Iteriere, bis der Nutzer zustimmt.
Tor: STORYBOARD.md + SCRIPT.md existieren UND der Nutzer hat den Plan genehmigt.
Schritt 4: Sprachausgabe, Timing + Untertitel 💬
Lies: references/step-4-vo.md
Wenn Schritt 2 sagte „keine Erzählung“ – frage nach Hintergrundmusik, springe dann zu Schritt 5. Andernfalls: Frage den Nutzer, welcher 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 die Beat-Timings wurden mit echten Dauern aktualisiert.
Schritt 5: Kompositionen erstellen
Lies: Das Skill hyperframes (lade es – jede Regel zählt)
Lies: references/step-5-build.md
Erstelle index.html und Kompositionen nach 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 Bericht erstatten.
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 & Ausliefern
Lies: references/step-6-validate.md
Lintern, validieren, erstelle 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 expliziten Nutzerwunsch in MP4. Zeige die Studio-URL nur bei der Übergabe – sie ist die endgültige, stabile Vorschau; die Build-Phasen-Snapshots sind headless, zeige also keine Vorschau mitten im Build.
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.
Kurzübersicht
Videotypen
Typische Einschränkungen nach Videotyp – als Ausgangspunkt verwenden, 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 | Plattform-Limit | Optional |
| Produktdemo | 30–60s | Skriptlänge | Vollständige Erz. |
| Feature-Ankündigung | 15–30s | Feature-Komplexität | Vollständige Erz. |
| Brand Reel | 20–45s | Musiktrack | Optional, Musikfokus |
| Launch-Teaser | 10–20s | Hook-Energie | Minimal |
Die Beat-Anzahl ist absichtlich nicht in dieser Tabelle – sie sollte aus dem Storyboard kommen, nicht aus „Social Ad = 3-4 Beats“. Eine Social Ad für ein komplexes Produkt braucht vielleicht 5 gut getaktete Beats. Ein Brand Reel mit einer starken visuellen These braucht vielleicht 3.
Format
- Querformat: 1920×1080 (Standard)
- Hochformat: 1080×1920 (Instagram Stories, TikTok)
- Quadratisch: 1080×1080 (Instagram-Feed)
Referenzdateien
| Datei | Wann lesen |
|---|---|
| step-0-capture.md | Schritt 0 – Erfassen, Marke und Produkt verstehen, strategieorientierte Website-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 – Abstimmung von Botschaft, narrativem Bogen, Zielgruppe mit dem Nutzer |
| capabilities.md | Schritte 2 & 5 – Vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). TOC während des Briefs scannen, in bestimmte Abschnitte während des Builds eintauchen |
| step-3-storyboard.md | Schritt 3 – Storyboard + Drehbuch (kombiniert) mit Nutzer-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 – Lintern, validieren, Snapshots (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 (lebt im Skill hyperframes) |