media-use: Bevor Audio-/Bildquellen besorgt 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. Dieses Skill erstellt ein Video von / aus einer allgemeinen Seite. Wenn der Nutzer tatsächlich ein Produkt vermarktet / launched / bewirbt (selbst von dieser URL, selbst „Promo für unsere Seite“) →
/product-launch-video. Ein Themen-Erklärvideo ohne Seite →/faceless-explainer; ein GitHub PR →/pr-to-video; Nachbearbeitung / Neufärbung / Neuanordnung einer bestehenden Videodatei → außerhalb des Rahmens. Bei unklarem „Video erstellen“ oder Unsicherheit Launch-vs-allgemeine-Seite? Lies zuerst/hyperframes(vollständige Routingtabelle + § Was HyperFrames nicht kann).
Nutzer sagen Dinge wie:
- „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 Workflow hat 7 Schritte. Jeder erzeugt ein Artefakt, das den nächsten Schritt öffnet. Standardmäßig ist er kollaborativ – mit 💬 markierte Tore stoppen und fragen den Benutzer. Wenn der Benutzer den autonomen Modus signalisiert („entscheide für mich“, „überrasche mich“), werden 💬 Benutzereinstellungstore übersprungen; siehe step-2-brief.md für die Auswirkungen.
Der autonome Modus bedeutet NICHT „alle Tore überspringen.“ Der Auto-Modus deckt Benutzereinstellungsfragen ab (TTS-Anbieter, Stimme, Farbbetonung, Beat-Anzahl, Musik ja/nein, Untertitel ja/nein – wo der Agent im Namen des Benutzers entscheidet). Er deckt NICHT die Qualitätsprüfungstore ab. Die folgenden bleiben im Auto-Modus nicht überspringbar:
- Asset-Prüfung (Schritt 3) – Betrachten von Kontaktblättern und Begründung von VERWENDEN/ÜBERSPRINGEN für jedes Asset
- Pro-Beat HTML-Lesen (Schritt 5) – strukturierter Evidenzblock pro Beat
- DoD-Checkliste (Schritt 6) – einschließlich Animationskarte, WCAG-Überprüfung pro Warnung, Audio/Bewegungswiedergabe
- Ehrlicher Offenlegungsabschnitt (Schritt 6) – „Was ich NICHT verifiziert habe“ muss in deiner endgültigen Zusammenfassung erscheinen
Wenn du denkst „der Auto-Modus sagt Voreingenommenheit fürs Handeln, also überspringe ich X“ – und X ist ein Verifikationstor, keine Präferenzfrage – dann ist diese Überlegung falsch. Voreingenommenheit fürs Handeln gilt für die Entscheidung, was gebaut wird, nicht für die Entscheidung, ob verifiziert wird.
Schritt 0: Erfassen & Verstehen der Marke
Lies: references/step-0-capture.md
Erfasse die Seite, 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, welche Stimmung es hat. 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 seine Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es meldet, ob Stimme/BGM HeyGen oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPP und warte auf die Wahl des Benutzers – 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 ein pro-Repo .env. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Tor: Zusammenfassung der Seite gedruckt – zuerst die Strategie (was das Produkt tut, für wen es ist, Markenstimme) vor dem Asset-/Farb-/Schriftinventar; Anmeldestatus wurde gezeigt (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: 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 – tiefgehende Abschnitte nur bei Bedarf)
Stimme mit dem Benutzer ab, was das Video kommunizieren muss, bevor du über visuelle Elemente oder Assets sprichst. Analysiere die Eingabe des Benutzers – er hat dir wahrscheinlich bereits den Videotyp und -stil genannt. Frage nur nach dem, was fehlt: das EINE, was 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 konzeptbasiertes Storyboard schreiben.
Schritt 3: Storyboard + Skript 💬
Lies: references/step-3-storyboard.md
Schreibe das Storyboard konzeptbasiert: Botschaft → narrativer Bogen → Beats, die den Bogen bedienen → Techniken pro Beat → Markenakzente am Ende. Schreibe dann das Erzählskript passend dazu. Präsentiere beides dem Benutzer mit einer Zusammenfassung Beat für Beat. Iteriere, bis der Benutzer 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 vorsieht – 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-Zeitangaben, oder (b) narration.wav + transcript.json existieren und Beat-Zeitangaben wurden 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 in 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 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
Linte, validiere, mache Screenshots skaliert auf die Videolänge (Formel: max(Beats × 3, ceil(Dauer_Sekunden / 2))) und überprüfe jeden einzelnen. Behebe Probleme vor der Auslieferung. Liefere die lokale Studio-Projekt-URL – rendere nur auf expliziten Benutzerwunsch in MP4. Gib diese Studio-URL nur bei der Übergabe aus – es ist die endgültige, stabile Vorschau; die Build-Phasen-Screenshots sind Headless, also zeige keine Vorschau während des Baus.
Liefere etwas, auf das du stolz bist. Frage dich vor der Übergabe: Würde ich das in sozialen Medien mit meinem Namen 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.
Kurzreferenz
Videotypen
Typische Einschränkungen nach Videotyp – verwende sie als Ausgangspunkt, nicht als Formel. Die Beat-Anzahl sollte aus dem Inhalt und der Erzählung folgen, nicht aus einem Zielbereich.
| Typ | Typische Dauer | Treiber der Dauer | Erzählung |
|---|---|---|---|
| Social Ad (IG/TikTok) | 10–15s | Plattformlimit | Optional |
| Produktdemo | 30–60s | Skriptlänge | Vollständig |
| Feature-Announcement | 15–30s | Feature-Komplexität | Vollständig |
| Brand-Reel | 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 kommen, nicht aus „Social Ad = 3-4 Beats.“ Eine Social Ad für ein komplexes Produkt braucht vielleicht 5 gut getimte Beats. Ein Brand-Reel mit einer starken visuellen These braucht vielleicht 3.
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, zuerst-strategische Zusammenfassung schreiben |
| step-1-design.md | Schritt 1 – DESIGN.md Marken-Spickzettel schreiben (5 Abschnitte, 250-350 Zeilen; 50-zeiliger Schnellpfad für Billboard-Style-Social Ads) |
| step-2-brief.md | Schritt 2 – Botschaft, narrativen Bogen, Zielgruppe mit Benutzer abstimmen |
| capabilities.md | Schritte 2 & 5 – vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). Scanne das Inhaltsverzeichnis während des Briefs, lies tiefgehend während des Baus |
| step-3-storyboard.md | Schritt 3 – Storyboard + Skript (kombiniert) mit Benutzer-Review-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 – linten, validieren, Screenshots (skaliert auf Videolänge), Vorschau |
| techniques.md | Schritte 3 & 5 – 13 primitive Animationstechniken mit Code-Mustern (adaptieren, nicht kopieren) |
| html-in-canvas-patterns.md | Schritt 5 – vollständige Code-Muster für HTML-in-Canvas-Effekte (lebt im hyperframes Skill) |