media-use: Bevor Audio-/Bildquellen 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 Route vor Schritt 0. Dieser Skill erstellt ein Video von / aus einer allgemeinen Website. Wenn der Nutzer tatsächlich ein Produkt vermarktet / launched / bewirbt (selbst von dieser URL, selbst „Promo für unsere Seite“) →
/product-launch-video. Ein themenerklärendes Video ohne Website →/faceless-explainer; ein GitHub-PR →/pr-to-video; Neuschnitt / Neufärbung / Neuordnung einer vorhandenen Videodatei → außerhalb des Rahmens. Falls aufgrund einer vagen „Erstelle ein Video“-Anfrage hierher geroutet wurde oder Unsicherheit herrscht, ob Launch oder allgemeine Website? Lies zuerst/hyperframes(vollständige Routingtabelle + Abschnitt „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 / Showcase von https://...“
- „Erfasse unsere Homepage und baue ein Video aus ihren eigenen visuellen Inhalten“
Der Workflow hat 7 Schritte. Jeder erzeugt ein Artefakt, das den nächsten Schritt freischaltet. Standardmäßig ist er kollaborativ – mit 💬 gekennzeichnete Tore halten an und fragen den Nutzer. Signalisiert der Nutzer den autonomen Modus („entscheide für mich“, „überrasche mich“), werden die 💬-Nutzerpräferenz-Tore übersprungen; siehe step-2-brief.md für die Fortpflanzung.
Autonomer Modus bedeutet NICHT „alle Tore überspringen.“ Der Auto-Modus deckt Nutzerpräferenz-Fragen ab (TTS-Anbieter, Stimme, Farbschwerpunkt, Beat-Anzahl, Musik ja/nein, Untertitel ja/nein – bei denen der Agent im Namen des Nutzers entscheidet). Er deckt NICHT die Qualitätssicherungs-Tore ab. Die folgenden bleiben im Auto-Modus nicht überspringbar:
- Asset-Audit (Schritt 3) – Betrachten von Kontaktblättern und Begründung von VERWENDEN/ÜBERSPRINGEN für jedes Asset
- Pro-Beat-HTML-Durchsicht (Schritt 5) – strukturierter Evidenzblock pro Beat
- DoD-Checkliste (Schritt 6) – einschließlich Animations-Map, WCAG-Überprüfung pro Warnung, Audio-/Bewegungs-Wiedergabe
- Ehrlicher Offenlegungsabschnitt (Schritt 6) – „Was ich NICHT überprüft habe“ muss in der endgültigen Zusammenfassung erscheinen
Wenn du denkst „Auto-Modus sagt Voreingenommenheit für Handlung, also überspringe ich X“ – und X ist ein Überprüfungs-Tor, keine Präferenzfrage – dann ist diese Überlegung falsch. Voreingenommenheit für Handlung bezieht sich auf die Entscheidung was gebaut wird, nicht auf die Entscheidung ob etwas überprüft wird.
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 Marken-Werkzeugkasten für später, nicht die Bausteine, aus denen das Video gemacht wird.
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 berichtet, ob Stimme/BGM HeyGen oder lokale Engines verwendet und – wenn nicht angemeldet – wie man sich anmeldet. Falls nicht angemeldet, STOPP und warte auf die Wahl des Nutzers – anmelden oder „go“/„offline“ sagen, um mit lokalen Engines fortzufahren – bevor du das Briefing oder irgendetwas anderes fragst. Behandle es als echten Entscheidungspunkt, nicht als beiläufige Notiz; falte die Wahl nicht in die Briefing-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: Sitesumme ausgedruckt – strategie-zuerst (was das Produkt tut, für wen es ist, Markenstimme) vor dem Asset-/Farb-/Schriftinventar; der Anmeldestatus wurde angezeigt (angemeldet oder Offline-Fortsetzung).
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, Schriftartenauswahl und Do's/Don'ts.
Schritt 2: Strategie & Botschaft
Lies: references/step-2-brief.md, references/capabilities.md (scanne das Inhaltsverzeichnis – vertiefende Abschnitte nur bei Bedarf)
Stimme mit dem Nutzer ab, was das Video kommunizieren muss, bevor über Bilder oder Assets gesprochen wird. Parst den Prompt des Nutzers – er hat dir wahrscheinlich bereits den Videotyp und -stil genannt. Frage nur, was fehlt: die EINE Sache, die dieses Video sagen muss, den erzählerischen Bogen und die Zielgruppe.
Tor: Videotyp, Dauer, Format und – entscheidend – die Nachricht und der erzählerische Bogen sind festgelegt. Ohne diese kann Schritt 3 kein konzeptgetriebenes Storyboard schreiben.
Schritt 3: Storyboard + Skript 💬
Lies: references/step-3-storyboard.md
Schreibe das Storyboard konzeptgetrieben: Nachricht → erzählerischer Bogen → Beats, die den Bogen bedienen → Techniken pro Beat → Markenakzente am Ende. Schreibe dann das Erzählskript passend dazu. Präsentiere beides dem Nutzer mit einer Beat-für-Beat-Zusammenfassung. Wiederhole, bis der Nutzer zustimmt.
Tor: STORYBOARD.md + SCRIPT.md existieren UND der Nutzer hat den Plan genehmigt.
Schritt 4: VO, Timing & Untertitel 💬
Lies: references/step-4-vo.md
Wenn Schritt 2 keine Erzählung vorsah – frage nach Hintergrundmusik und 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) 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 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
Linten, validieren, Snapshots 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 – rendere nur auf ausdrücklichen Nutzerwunsch als MP4. Zeige diese Studio-URL nur bei der Übergabe – sie ist die endgültige, stabile Vorschau; die Snapshots der Bauphase sind headless, zeige also keine Vorschau während des Baus.
Liefere etwas, auf das du stolz bist. Frage dich vor der Übergabe: Würde ich das in den 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 – 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 – sie sollte aus dem Storyboard kommen, nicht aus „Social Ad = 3-4 Beats.“ Ein Social Ad für ein komplexes Produkt könnte 5 gut getimte Beats benötigen. Ein Brand Reel mit einer starken visuellen These könnte nur 3 benötigen.
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, 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 Billboard-artige Social Ads) |
| step-2-brief.md | Schritt 2 – Nachricht, erzählerischen Bogen, Zielgruppe mit dem Nutzer abstimmen |
| capabilities.md | Schritte 2 & 5 – vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). Scanne das Inhaltsverzeichnis während des Briefings, vertiefe spezifische Abschnitte während des Baus |
| step-3-storyboard.md | Schritt 3 – Storyboard + Skript (kombiniert) mit Nutzerüberprüfungs-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, 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) |