media-use: Bevor du Audio/Bilder abrufst, verwende
/media-use, um BGM/SFX/Bilder aus dem HeyGen-Katalog aufzulösen. Führe zuerst--adoptaus, um bestehende Assets zu registrieren. Siehe/media-use-Skill.
Produkteinführung zu HyperFrames
Verwende diesen Skill, um ein Produkt zu erfassen, seine Marke zu verstehen, ein Einführungsvideo zu planen und es Rahmen für Rahmen in HyperFrames zu erstellen.
Bestätige den richtigen Pfad vor Schritt 0. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Tor und fahre erst dann mit dem nächsten Schritt fort. Dieser Skill ist für ein Produkt, das vermarktet, eingeführt, beworben oder enthüllt wird, einschließlich Anfragen wie "Promo für unsere Seite", wenn der Zweck werblich ist. Leite andere Absichten woanders hin: eine allgemeine, nicht auf eine Einführung bezogene Website-Tour ->
/website-to-video; ein Thema-Erklärvideo ohne Produkt ->/faceless-explainer; ein GitHub-PR ->/pr-to-video; Untertitel auf vorhandenem Filmmaterial ->/embedded-captions; eine kurze, unerzählte Bewegungsgrafik ->/motion-graphics. Wenn der Nutzer nur "mach ein Video" sagt oder der Pfad unsicher ist, lies zuerst/hyperframes.
Du bist der Orchestrator. Arbeite in videos/<projekt>/. Führe die Schritte der Reihe nach aus und bestehe jedes Tor, bevor du fortfährst. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen Unter-Agenten pro Rahmen einsetzt. Lege hier keine Design- oder Bewegungsregeln fest; diese leben im Rahmenarbeiter-Unter-Agenten, den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ dieses Skills und hyperframes-creative.
Workflow: Schritt 0 Einrichtung -> hyperframes.json; Schritt 1 Erfassung -> capture/; Schritt 2 Designsystem -> frame.md; Schritt 3 Storyboard/Skript -> STORYBOARD.md und SCRIPT.md; Schritt 3.1 Audio -> audio_meta.json; Schritt 4 Visuelles Design -> angereichertes STORYBOARD.md; Schritt 5 Rahmen -> compositions/frames/NN-*.html und index.html; Schritt 6 Finaler Render -> renders/video.mp4.
Schritt 0: Einrichtung und Briefing
Ziel: Lege das Kern-Video-Briefing fest und erstelle bei Bedarf das HyperFrames-Projekt.
Initialisiere nur, wenn hyperframes.json fehlt. Benenne <projekt> nach der Marke oder Domain in Kebab-Schreibweise, z. B. acme-promo; verwende niemals den Arbeitsbereichsnamen oder einen Zeitstempel.
npx hyperframes init "videos/<projekt>" --non-interactive --example=blank — init überprüft die installierten Skills auf dem neuesten Stand gegen GitHub und aktualisiert bei Bedarf die globalen.
Zeige den Anmeldestatus vor dem Briefing an — führe npx hyperframes auth status aus und gib die Ausgabe wörtlich wieder (paraphrasiere oder formuliere sie nicht um). Es wird berichtet, ob Sprach-/BGM-Ausgabe HeyGen oder lokale Engines verwendet und, falls nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPEN und warte darauf, dass der Nutzer wählt — sich 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 flüchtige Notiz; binde die Wahl nicht in die Briefing-Frage ein und schreibe keine Schlüssel in ein .env-Datei pro Repository. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Tor: hyperframes.json existiert und Bildwinkel, Länge, Seitenverhältnis und Sprache sind festgelegt; der Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).
Schritt 1: Assets erfassen
Ziel: Sammle das Quellmaterial, Markensignale und nutzbare Assets für das Video.
Klassifiziere die Eingabe und wähle den Pfad. Explizite URL -> erfasse sie und verwende die Website für Erzählung und Assets. Eingefügtes Skript/Briefing -> speichere es wörtlich als user_script.txt, frage einmal "wörtlich verwenden oder umstrukturieren?", speichere die Antwort als VO_MODE, löse dann das Erfassungsziel auf: URL im Text -> verwende sie; nur Markenname -> WebSearch, bestätige die URL in einer Zeile, dann crawle; keine URL/Website -> kein Erfassungspfad.
Führe die Erfassung aus mit: npx hyperframes capture "<URL>" -o ./capture
Wenn GEMINI_API_KEY, GOOGLE_API_KEY oder ein OpenRouter-Schlüssel existiert, erfasst capture automatisch Assets in capture/extracted/asset-descriptions.md. Dies ist kein Überprüfungstor. Ohne einen Vision-Schlüssel verwende den DOM-Kontext und fahre fort.
Kein Erfassungspfad: erstelle capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ manuell. tokens.json sollte { "title": "", "description": "", "colors": [], "fonts": [] } sein; fülle Titel/Beschreibung aus dem Briefing, wenn möglich. visible-text.txt enthält das vollständige Briefing oder Skript. asset-descriptions.md sollte besagen, dass keine Assets erfasst wurden, es sei denn, der Nutzer hat Asset-Notizen gegeben.
Tor: capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ existieren; du kannst die Marke in einem klaren Satz angeben. Behandle asset-descriptions.md als das Haupt-Asset-Inventar. Wenn es nach der echten Erfassung fehlt, stoppe und melde die unvollständige Erfassung. Wenn capture/BLOCKED.md existiert, folge ihm.
Schritt 2: Designsystem
Ziel: Wähle eine ausgelieferte Rahmenvoreinstellung; ein Skript verwandelt sie in die frame.md + Untertitel-Skin dieses Videos.
Du triffst die eine Beurteilung — welche Voreinstellung. Lese ../hyperframes-creative/references/design-spec.md und wähle die Voreinstellung, deren Look am besten zur Marke und zum Briefing passt. Führe dann aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
Das Skript erledigt den Rest deterministisch: kopiert das FRAME.md der Voreinstellung nach frame.md und remixt es auf die Marken-Token in capture/extracted/tokens.json (Markenfarben werden nach Rolle — Tinte, Leinwand, Akzente — auf die Farb-Schlüssel der Voreinstellung abgebildet, wobei Schlüssel/Struktur/Komponenten erhalten bleiben; die Anzeige- + Textschriftarten der Voreinstellung werden gegen die der Marke ausgetauscht), kopiert den Untertitel-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (Beendet mit Code 1 bei einer fehlerhaften Zuordnung). Fahre mit dem nächsten Schritt fort, sobald es mit Code 0 endet — keine manuelle Bearbeitung der Spezifikation.
tokens.json ohne Markenfarben/Schriftarten (z. B. keine Erfassung) -> das Skript behält die eigene Palette der Voreinstellung bei, ein vollständig lieferbares Design. Wenn das Briefing Markenfarben/Schriftarten nennt, die die Erfassung übersehen hat, füge sie zu capture/extracted/tokens.json hinzu, bevor du das Skript ausführst (oder verwende das design.md des Nutzers, um es zu füllen); passe frame.md danach nur von Hand an, wenn eine Zuordnung es wirklich benötigt.
Tor: build-frame.mjs endete mit Code 0 — frame.md existiert von einer benannten Voreinstellung und (wenn die Voreinstellung eine ausliefert) .hyperframes/caption-skin.html existiert als Quelle des Untertitel-Skins.
Schritt 3: Storyboard und Skript
Ziel: Verwandle das Briefing und das erfasste Material in einen genehmigten rahmenbasierten Storyplan.
Lese references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md und ../hyperframes-core/references/script-format.md. Verwende sie, um STORYBOARD.md zu schreiben und, wenn eine Erzählung benötigt wird, SCRIPT.md.
Verwende story-design.md für Story-Blaupause, Aufhänger, Überzeugungslogik, Beats, VO_MODE und Asset-Auswahl. Als weiche Anleitung konsultiere das Rollen→Blaupausen-Menü in ../hyperframes-animation/blueprints-index.md: notiere für jeden Beat eine Kandidaten-Blaupausen-ID, wenn eine passt. Die Story-Wahrheit entscheidet immer noch, welche Beats existieren — erzwinge niemals einen Beat, um zu einer Blaupause zu passen, und erfinde niemals einen Beat, nur weil eine bewährte Form verfügbar ist. Wähle jedes visuelles Frame' asset_candidates aus capture/extracted/asset-descriptions.md (dem kanonischen Inventar) — durchstöbere nicht die rohen capture/assets/. Frage den Nutzer nicht, Assets auszuwählen, es sei denn, dieses Inventar fehlt oder ist unbrauchbar. Verwende die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.
Nach dem Verfassen zeige eine rahmenweise Zusammenfassung. Frage in derselben Nachricht den Nutzer nach zwei Dingen: (a) Genehmigung oder Änderungswünsche und (b) ob sie eine Live-Vorschau des Storyboard-Gerüsts wünschen (npx hyperframes preview) — öffne es nur bei einer Zusage. Iteriere, bis es genehmigt ist, und trage die Vorschauauswahl zu Schritt 6.
Tor: STORYBOARD.md existiert, jedes visuelle Frame hat asset_candidates, SCRIPT.md existiert, wenn eine Erzählung benötigt wird, und der Nutzer hat den rahmenweisen Plan genehmigt.
Schritt 3.1: Audio
Ziel: Generiere Erzählung, Wortzeitsteuerung, Musik und Audio-Metadaten aus dem genehmigten Skript.
Starte Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus, fahre dann mit Schritt 4 fort.
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
Das Audio-Skript übernimmt Erzählung, Wortzeitsteuerung, BGM-Suche aus HeyGens Musikbibliothek und Zeitsteuerungs-Metadaten. Die BGM-Stimmung kommt aus dem music:-Feld des Storyboards. Dies verwendet die HeyGen Audio API zum Abruf, nicht zur Generierung, und verwendet denselben ~/.heygen-Credential wie TTS. Für Anbieterdetails lies ../hyperframes-media/references/tts.md.
Wenn es keine Erzählung und kein SCRIPT.md gibt, überspringe die Spracherzeugung. BGM kann trotzdem laufen, wenn das Storyboard eine Musikstimmung hat.
Tor: Audio-Job wurde gestartet oder das Projekt ist als stumm markiert.
Schritt 4: Rahmen Visuelles Design
Ziel: Füge die visuelle Richtung, Layout-Absicht und Bewegungswahl zu jedem Storyboard-Frame hinzu.
Bearbeite STORYBOARD.md an Ort und Stelle. Erstelle kein weiteres Storyboard. Verwende frame.md als Quelle der Wahrheit für Farbe, Typografie, Layout-Gefühl und Stil.
Lese references/visual-design.md, ../hyperframes-animation/blueprints-index.md, references/motion-language.md und ../hyperframes-animation/rules-index.md. Verwende visual-design.md für die Methode (die zeitcodierte Shot-Sequenz, das Inline-Layout-Vokabular und den erforderlichen ## Video direction-Block). Verwende ../hyperframes-animation/blueprints-index.md, um die Shot-Form jedes Frames auszuwählen. Verwende motion-language.md (das Bewegungsvokabular + die Bewegungsdoktrin) und ../hyperframes-animation/rules-index.md (gültige Regelnamen) für Bewegung — erfinde keine Bewegungsnamen.
Schreibe für jedes visuelle Frame eine zeitcodierte Shot-Sequenz in STORYBOARD.md gemäß der Methode von visual-design.md: wähle die Blaupause des Frames (oder komponiere sie), instanziiere sie mit dem Inhalt DIESES Produkts und takte die Enthüllung jeder Szene auf den Voiceover, sodass sich das Frame über seine gesamte Dauer entwickelt, anstatt vorn zu laden und dann einzufrieren. Gib Layout und Bewegung inline pro Szene an (Vokabulare in visual-design.md und motion-language.md). Füge einen videoweiten ## Video direction-Block hinzu.
Ändere nicht die Geschichte, das Skript, die Asset-Auswahl, asset_candidates, transition_in oder das erfasste Quellmaterial. Schreibe in diesem Schritt kein HTML.
Stufe benannte Assets ein, nachdem das visuelle Design festgelegt ist:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
Tor: Jedes visuelle Frame hat eine zeitcodierte Shot-Sequenz, deren Enthüllungen auf den Voiceover abgestimmt sind (keine Vorladung); ## Video direction existiert; assets/ enthält die benannten Assets.
Schritt 5: Rahmen bauen
Ziel: Baue jedes Storyboard-Frame als HTML-Komposition und erstelle das abspielbare Video.
Warte darauf, dass Schritt 3.1 Audio fertig ist, falls Audio gestartet wurde. Synchronisiere dann Dauern und hole SFX; überspringe beides, wenn stumm.
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
Dauern-Synchronisation ist mechanisch: Die echte Sprachdauer gewinnt; stumme Frames behalten Schätzungen; bearbeite nie synchronisierte Dauern von Hand.
Vor dem Abruf lies sub-agents/frame-worker.md und ../hyperframes-core/references/subagent-dispatch.md. Setze einen Unter-Agenten pro Frame ein, wenn möglich parallel; ansonsten führe Arbeiter in Wellen aus. Jeder Arbeiter erhält genau ein Frame.
Jeder Arbeiterkontext muss PROJECT_DIR, frame_id, Leinwandgröße, Untertitelstatus und Schutzbereich enthalten, wenn Untertitel aktiviert sind, sowie RULES_DIR als absoluten Pfad zu ../hyperframes-animation/rules/ dieses Skills. Jeder Arbeiter liest frame.md, seinen eigenen ## Frame N-Block aus STORYBOARD.md, das lokale Regel-Rezept (../hyperframes-animation/rules/<id>.md) für jede zitierte Bewegung und die Blaupausenvorlage des Frames (../hyperframes-animation/blueprints/<id>.md). Jeder Arbeiter schreibt nur compositions/frames/NN-*.html. Arbeiter dürfen niemals STORYBOARD.md bearbeiten.
Sobald ein Arbeiter zurückkommt, markiert der Orchestrator dieses Frame als animated in STORYBOARD.md.
Nachdem Audio-Zeitsteuerungen existieren, baue Untertitel im Hintergrund und erstelle den Index:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjs verwendet das .hyperframes/caption-skin.html des Projekts (in Schritt 2 kopiert) als Untertitel-Look und injiziert Marken-Token aus frame.md; ohne Skin rendert es die integrierte Standard-Pille. captions: skipped (<grund>) ist gültig. Fahre ohne Untertitel fort, wenn sie explizit übersprungen wurden.
Tor: Jedes Frame ist als animated markiert, index.html existiert und Untertitel sind erstellt oder explizit übersprungen.
Schritt 6: Finalisieren
Ziel: Überprüfe das zusammengesetzte Video, hole die Nutzergenehmigung ein und rendere das endgültige MP4.
Füge Übergänge ein, führe Prüfungen durch, halte für eine Überprüfung an und rendere dann.
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
npx hyperframes snapshot --at <frame-midpoints>
snapshot setzt die erfassten Frames zu einem Kontaktblatt zusammen (snapshots/contact-sheet.jpg). Wirf einen Blick darauf; wenn nichts offensichtlich kaputt ist, mach weiter — verweile nicht hier.
Wenn ein Befehl fehlschlägt, zeige stderr und stoppe — häufe keine Wiederherstellungsbefehle an. Behebe es selbst: die billigste sichere Bearbeitung von compositions/frames/NN-*.html, dann führe die fehlgeschlagene Prüfung erneut aus.
Nach bestandenen Prüfungen halte für die Nutzerüberprüfung an. Das Video ist zusammengesetzt, sichtbar und im Studio bearbeitbar. Verwalte die Vorschau nur einmal über Schritt 3 und Schritt 6 hinweg: öffne sie, wenn der Nutzer früher darum gebeten hat, biete sie an, wenn sie früher abgelehnt wurde, und frage nicht erneut, wenn sie bereits im Studio prüfen.
Vorschau: npx hyperframes preview
Rendere ...
[gekürzt für Übersetzung]