media-use: Bevor du Audio/Quellenmaterial verwendest, rufe
/media-useauf, um BGM/SFX/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. Dieses Skill erstellt ein Video von / über eine allgemeine Website. Wenn der Nutzer tatsächlich ein Produkt vermarktet / launched / bewirbt (auch über diese URL, selbst als „Promo für unsere Seite“) →
/product-launch-video. Ein sachliches Erklärvideo ohne Website →/faceless-explainer; ein GitHub-PR →/pr-to-video; Neuschnitt / Neufärbung / Neuordnung einer bestehenden Videodatei → außerhalb des Rahmens. Bei vager Angabe „Video erstellen“ oder Unsicherheit Launch vs. allgemeine Website? Lies zuerst/hyperframes(vollständige Routingtabelle + § Was HyperFrames nicht kann).
Nutzer sagen zum Beispiel:
- „Mach aus dieser Website einen 15-Sekunden-Social-Clip für Instagram“
- „Erstelle eine 30-Sekunden-Site-Tour / ein Showcase von https://...“
- „Erfasse unsere Startseite und baue ein Video aus ihren eigenen visuellen Inhalten“
Der Arbeitsablauf hat 7 Schritte. Jeder erzeugt ein Artefakt, das den nächsten Schritt freigibt. Standardmäßig ist er kollaborativ – mit 💬 markierte Tore stoppen und fragen den Nutzer. Signalisiert der Nutzer den autonomen Modus („entscheide für mich“, „überrasche mich“), werden 💬-Tore für Benutzerpräferenzen übersprungen; siehe step-2-brief.md, wie sich das fortpflanzt.
Der autonome Modus bedeutet NICHT „überspringe alle Tore.“ Der automatische Modus deckt Benutzerpräferenz-Fragen ab (TTS-Anbieter, Stimme, Farbschwerpunkt, Beat-Anzahl, Musik ja/nein, Untertitel ja/nein – bei denen der Agent im Namen des Benutzers entscheidet). Er deckt nicht die Qualitätsprüfungs-Tore ab. Die folgenden bleiben im automatischen Modus nicht überspringbar:
- Asset-Audit (Schritt 3) – Kontaktbögen betrachten und VERWENDEN/ÜBERSPRINGEN für jedes Asset begründen
- HTML-Lesen pro Beat (Schritt 5) – strukturierter Evidenzblock pro Beat
- DoD-Checkliste (Schritt 6) – einschließlich Animationskarte, WCAG-Überprüfung pro Warnung, Audio-/Bewegungs-Wiedergabe
- Abschnitt zur ehrlichen Offenlegung (Schritt 6) – „Was ich NICHT verifiziert habe“ muss in deiner endgültigen Zusammenfassung erscheinen
Wenn du denkst „Der automatische Modus sagt ‚Tendenz zum Handeln‘, also überspringe ich X“ – und X ist ein Verifikations-Tor, 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 verifiziert werden soll.
Schritt 0: Erfassen & die Marke verstehen
Lies: references/step-0-capture.md
Erfasse die Site, 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 an – führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es gibt an, ob Stimme/BGM HeyGen oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPPE und warte auf die Wahl des Nutzers – anmelden oder "go"/"offline" sagen, um mit lokalen Engines fortzufahren – bevor du den Brief oder irgendetwas anderes fragst. Behandle es als echten Entscheidungspunkt, nicht als Randnotiz; falte die Wahl nicht in die Brief-Frage und schreibe keine Schlüssel in eine .env pro Repository. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Tor: Site-Zusammenfassung ausgedruckt – strategie-zuerst (was das Produkt tut, für wen es ist, Markenstimme) vor dem Asset-/Farb-/Schriftarten-Inventar; Anmeldestatus wurde angezeigt (angemeldet oder offline fortgesetzt).
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 exakte berechnete Werte.
Geschwindigkeitsoption: Bei schnell getakteten Videos (Billboard-pro-Beat) kann DESIGN.md eine 50-zeilige Zusammenfassung von Farben + Schriftarten + 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, Schriftartauswahl und Do's/Don'ts.
Schritt 2: Strategie & Botschaft
Lies: references/step-2-brief.md, references/capabilities.md (scanne das Inhaltsverzeichnis – tiefere Abschnitte nur nach Bedarf)
Stelle mit dem Nutzer klar, was das Video kommunizieren muss, bevor du über visuelle Inhalte oder Assets sprichst. Analysiere die Eingabe des Nutzers – 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 konzept-zuerst-Storyboard schreiben.
Schritt 3: Storyboard + Drehbuch 💬
Lies: references/step-3-storyboard.md
Schreibe das Storyboard konzept-zuerst: 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 Nutzer mit einer Zusammenfassung Beat für Beat. Iteriere, bis er 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 keine Erzählung vorsieht – frage nach Hintergrundmusik, springe dann zu Schritt 5. Ansonsten: Frage den Nutzer nach dem TTS-Anbieter (HeyGen TTS, ElevenLabs oder Kokoro), generiere Audio, transkribiere, ordne Zeitstempel den Beats zu. Frage dann nach Untertiteln.
Tor: Entweder (a) keine Erzählung wurde gewünscht und das Storyboard hat manuelle Beat-Zeiten, oder (b) narration.wav + transcript.json existieren und Beat-Zeiten mit echten Dauern aktualisiert.
Schritt 5: Kompositionen erstellen
Lies: Das hyperframes-Skill (lade es – jede Regel zählt)
Lies: references/step-5-build.md
Erstelle index.html und Kompositionen gemäß der im Storyboard gewählten Architektur und Taktung (Schritt 3). Sub-Agenten führen hyperframes lint und hyperframes snapshot für jeden Beat aus, bevor sie Bericht erstatten.
Tor: Jedes compositions/beat-N.html wurde vom Hauptagenten von oben bis unten gegen DESIGN.md und STORYBOARD.md gelesen. Die Beat-für-Beat-Checkliste befindet sich in step-5-build.md.
Schritt 6: Validieren & ausliefern
Lies: references/step-6-validate.md
Lintern, validieren, Vorschaubilder erstellen (skaliert auf Videolänge – Formel: max(beats × 3, ceil(seconds / 2))), und jedes überprüfen. Behebe Probleme vor der Auslieferung. Liefere die lokale Studio-Projekt-URL aus – rendere nur auf ausdrücklichen Benutzerwunsch als MP4. Zeige diese Studio-URL nur bei der Übergabe – sie ist die endgültige, stabile Vorschau; die Vorschaubilder der Bauphase sind ohne GUI, also zeige keine Vorschau während des Baus.
Liefere etwas aus, auf das du stolz bist. Frage dich vor der Übergabe: Würde ich das mit meinem Namen in den sozialen Medien posten? 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 – 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-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 |
| Markenrolle | 20–45s | Musiktitel | Optional, Musikfokus |
| Launch-Teaser | 10–20s | Hook-Energie | Minimal |
Die Beat-Anzahl ist absichtlich nicht in dieser Tabelle – sie sollte aus dem Storyboard stammen, nicht aus „Social-Anzeige = 3-4 Beats“. Eine Social-Anzeige für ein komplexes Produkt braucht vielleicht 5 gut getaktete Beats. Eine Markenrolle mit einer starken visuellen These braucht vielleicht 3.
Format
- Querformat: 1920x1080 (Standard)
- Hochformat: 1080x1920 (Instagram Stories, TikTok)
- Quadratisch: 1080x1080 (Instagram-Stream)
Referenzdateien
| Datei | Wann lesen |
|---|---|
| step-0-capture.md | Schritt 0 – erfassen, Marke und Produkt verstehen, strategie-zuerst Site-Zusammenfassung schreiben |
| step-1-design.md | Schritt 1 – DESIGN.md Marken-Spickzettel schreiben (5 Abschnitte, 250-350 Zeilen; 50-zeiliger Schnellpfad für Social-Anzeigen im Billboard-Stil) |
| step-2-brief.md | Schritt 2 – Botschaft, narrativen Bogen, Zielgruppe mit dem Nutzer abstimmen |
| capabilities.md | Schritte 2 & 5 – vollständiges Inventar dessen, was HyperFrames kann (24 Abschnitte). Scanne das Inhaltsverzeichnis während des Briefs, tauche während des Baus in bestimmte Abschnitte ein |
| step-3-storyboard.md | Schritt 3 – Storyboard + Drehbuch (kombiniert) mit Benutzerprüfungs-Tor |
| step-4-vo.md | Schritt 4 – TTS-Anbieterwahl, Generierung, Timing |
| step-5-build.md | Schritt 5 – index.html + Kompositionen erstellen |
| step-6-validate.md | Schritt 6 – Lintern, validieren, Vorschaubilder (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 hyperframes-Skill) |