Plugin-Installationen: Befolge vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln, wenn dieser Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen gelten die unten stehenden Aktualisierungshinweise.
Halte diesen Skill zuerst frisch – bestätige mit dem Benutzer, bevor du ausführst:
npx hyperframes skills update product-launch-video. Ein schneller No-op, wenn alles aktuell ist; andernfalls wird dieser Skill zusammen mit den Kern-Domain-Skills, von denen er abhängt, aktualisiert, bevor du sie verwendest.
media-use: Bevor du Audio/Bilder/Logos beschaffst, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog und Markenlogos aus offiziellen Quellen zu beziehen. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill.
figma-Quelle: Wenn die Quelle eine figma.com-URL ist, führe zuerst
/figmaaus – Asset-Export, Marken-Tokens und Komponenten-/Storyboard-Rekonstruktion, falls nötig – und baue dann diesen Workflow aus dessen Ausgabe auf. Verwende Figma nicht direkt über rohe MCP-Tools: Das überspringt die SVG-Bereinigung, die.media/manifest.jsonl-Provenienz und die Brand-Token-var()-Bindung, sodass eine spätere Markenänderung nicht ohne einen vollständigen Re-Import propagiert werden kann.
Produkt-Launch zu HyperFrames
Verwende diesen Skill, um ein Produkt zu erfassen, seine Marke zu verstehen, ein Launch-Video zu planen und es Frame für Frame in HyperFrames zu erstellen.
Die Eingangstür ist
/hyperframes. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Gate und fahre erst dann mit dem nächsten Schritt fort. Dieser Skill ist für ein Produkt, das vermarktet, gelauncht, beworben oder vorgestellt wird, einschließlich Anfragen wie „Werbung für unsere Website“, wenn der Zweck werblich ist. Eine Site-Tour/Präsentationsanfrage bleibt auch hier:BRIEF.mdträgt die „Zeig es, wie es ist“-Absicht, und die erfassten Screens werden zu den Assets, die das Video zeigt. Jede andere Absicht, ein bloßes „Mach ein Video“ oder Unklarheit → lies zuerst/hyperframes– die Intent-Ebene trifft jede Routenentscheidung, und eine neue Erstellung, die ohneBRIEF.mdhier ankommt, durchläuft sie trotzdem (Setups Eröffnungsregel).
Du bist der Orchestrator. Arbeite in videos/<projekt>/. Führe Schritte in der Reihenfolge aus und passiere jedes Gate, bevor du fortfährst. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Lies ../hyperframes/references/brief-contract.md vor Schritt 0 – es definiert die Gate-Typen und wie der flow/storyboard von BRIEF.md den Modus ableitet, der die Gates von Schritt 3/4/6 regelt. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen Unter-Agenten pro Frame einsetzt. Platziere keine Design- oder Bewegungsregeln hier; diese leben im Frame-Worker-Unter-Agenten, in den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ und in hyperframes-creative.
Workflow: Schritt 0 Setup -> hyperframes.json; Schritt 1 Erfassung -> capture/; Schritt 2 Designsystem -> frame.md; Schritt 3 Storyboard/Drehbuch -> STORYBOARD.md und SCRIPT.md; Schritt 3.1 Audio -> audio_meta.json; Schritt 4 Visuelles Design -> angereichertes STORYBOARD.md; Schritt 5 Frames -> compositions/frames/NN-*.html und index.html; Schritt 6 Finaler Render -> renders/video.mp4.
Schritt 0: Setup
Ziel: Mit einem bestätigten Briefing starten, das HyperFrames-Projekt erstellen und das Briefing dauerhaft machen.
Das Briefing wird von der Intent-Ebene bestätigt, nicht durch hier gestellte Fragen. Eröffnungsregel, in dieser Reihenfolge: (1) BRIEF.md existiert → lies es und stelle nichts – das Briefing ist abgeschlossen, und sein flow/storyboard leitet den Modus ab (Briefing-Vertrag § 1). (2) Kein BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf der Festplatte) → setze ab dem Frontmatter des Storyboards und den aufgezeichneten Präferenzen fort; befrage ein halbfertiges Projekt nie erneut. (3) Weder noch – eine neue Erstellungsanfrage, die direkt hier ankommt → lies /hyperframes und führe seine Intent-Ebene aus (references/intent-interview.md): sie prüft Rezepte und gespeicherte Standardeinstellungen, führt die Fragen dieser Route durch (../hyperframes/references/routes/product-launch-video.md) und gibt das abgeschlossene Briefing zurück. Bearbeitungsanfragen überspringen dies alles – gehe zur Bearbeitung über.
Initialisiere nur, wenn hyperframes.json fehlt. Benenne <projekt> nach der Marke oder Domain in Kebab-Schreibweise, z. B. acme-promo; verwende niemals den Workspace-Namen oder Zeitstempel.
npx hyperframes init "videos/<projekt>" --non-interactive --example=blank --skill=product-launch-video – init prüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert den globalen Satz, wenn welche veraltet sind.
Nach der Initialisierung sei <PROJECT_ROOT> = videos/<projekt> und führe jeden nachfolgenden relativen Pfadbefehl mit diesem Verzeichnis als Arbeitsverzeichnis aus. In den folgenden Befehlen bedeutet . <PROJECT_ROOT>; schreibe niemals .media, capture oder Ausgabedateien in das aufrufende Verzeichnis.
Schreibe BRIEF.md sofort nach der Initialisierung (niemals davor – init lehnt ein nicht leeres Verzeichnis ab): das abgeschlossene Briefing der Intent-Ebene, Struktur gemäß ../hyperframes/references/brief-format.md. Löse <MEDIA_DIR> als das installierte /media-use Skill-Verzeichnis auf. Zeichne dann jede präferenzgestützte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md benennt die Teilmenge). Wenn die Intent-Ebene ein Rezept übernommen hat, führe node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> aus; es kopiert seine frame.md in das Projekt (Schritt 2 wird dann übersprungen) und gibt die Skelette zurück, von denen Schritt 3 Entwürfe erstellt. Ein Rezept füllt Antworten, keine Genehmigungen; die Überprüfungsgates laufen trotzdem.
Zeige den Anmeldestatus an, bevor du über das Setup hinausgehst – führe npx hyperframes auth status aus und gib seine Ausgabe wortwörtlich weiter. Es berichtet, ob Sprach-/BGM HeyGen oder lokale Engines verwendet werden und, wenn abgemeldet, wie man sich anmeldet. Beachte den Exit-Code-Vertrag: auth status beendet sich mit 1, wenn nicht angemeldet (und wenn das gespeicherte Zugangsdokument abgelehnt wird) – dieser Exit-Code ungleich Null ist der normale abgemeldete Zustand, kein Befehlsfehler, also behandle ihn nicht als Fehler, wiederhole ihn nicht und verknüpfe ihn nicht mit &&/set -e auf eine Weise, die den Workflow abbrechen würde. Wende einen Zweig an:
- Kollaborativ: Warte darauf, dass der Benutzer sich anmeldet oder explizit
offline/gowählt. - Autonom: Gib den Status an und fahre mit den verfügbaren lokalen Engines fort.
Übergehe nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter existiert; zeige den Blockierer an. Fasse diese Entscheidung nicht in eine andere Frage oder schreibe Schlüssel in eine pro-Repo .env. Eigentum der Authentifizierung und Offline-Fallbacks: /media-use references/setup-providers.md § Anbieter.
Gate: hyperframes.json und BRIEF.md existieren; die präferenzgestützten Antworten wurden aufgezeichnet (Briefing-Vertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung im Offline-Modus).
Schritt 1: Assets erfassen
Ziel: Das Quellmaterial, Markensignale und verwendbare Assets für das Video sammeln.
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; VO_MODE (wörtlich oder umstrukturiert) kommt aus BRIEF.md – die Intent-Ebene fragt danach, wenn ein Skript ankommt (frage hier nur einmal, wenn das Briefing es irgendwie vermissen lässt). 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 (oder das Briefing sagt, nicht zu scrapen) -> kein Erfassungspfad.
Führe die Erfassung aus mit: npx hyperframes capture "<URL>" -o ./capture --json. Behalte das Standard-Post-Navigationsbudget, es sei denn, der Aufrufer hat eine kürzere Frist; dann übergib ein positives --capture-budget <Millisekunden>, das Zeit für nachgelagerte Arbeiten lässt. --timeout steuert nur die Seitennavigation. Verwende --skip-vision nur, wenn die optionale Bildbeschriftung absichtlich deaktiviert ist.
Überprüfe das Befehlsergebnis und das Ausgabeverzeichnis sofort. Ein Exit-Code ungleich Null, JSON ok: false oder capture/BLOCKED.md ist ein harter Stopp für den Erfassungspfad: melde den aufgezeichneten Grund und verwende keine partiellen Screenshots, DOM, Tokens oder Assets. Erzeuge keinen synthetischen No-Capture-Fallback nach einer fehlgeschlagenen URL-Erfassung. Fahre nur dann mit dem No-Capture-Pfad fort, wenn das ursprüngliche Briefing das Quellmaterial bereitgestellt hat oder wenn der Benutzer nach dem Fehlschlag explizit zu einem bereitgestellten Screenshot oder Briefing wechselt.
Warnungen wie „sehr wenig Textinhalt“ zusammen mit einem leeren Asset-Katalog sind kein Beweis für eine verwendbare Seite. Für eine Site-Tour oder ein „Zeig-es-wie-es-ist“-Briefing, erfordere eine vertrauenswürdige erfasste Struktur oder einen bereitgestellten Screenshot; wenn keines existiert, stoppe. Erfinde oder baue die Seite nicht neu, nur weil die Erfassung unbrauchbar ist.
Für eine Site-Tour oder ein „Zeig-es-wie-es-ist“-Briefing ist die erfasste Seite die visuelle Quelle der Wahrheit. Verwende den echten Screenshot, anstatt die gesamte Website in HTML neu zu erstellen. Wenn das Bild interne Bewegung benötigt, behalte den Screenshot als Basis und überlagere echte erfasste Assets an gemessenen Positionen, oder baue nur die eine Komponente, die sich bewegt. Für einen Scroll-Screenshot, animiere den Viewport über capture/screenshots/full-page.png – die 1x-Platte des gesamten Dokuments, pixelgenau für einen 1920 breiten Viewport, der darüber fährt. Sie fehlt, wenn die Seite zu groß war, um in einem Stück erfasst zu werden; falle auf die überlappenden Scroll-Positions-Screenshots im selben Verzeichnis zurück. Ein Hereinzoomen über 1:1 hinaus möchte stattdessen eine eigene 2x-Erfassung dieser Region, da die Platte keinen Spielraum über 1x hat. Baue die gesamte Seite nur neu, wenn der Benutzer explizit nach einer stilisierten Interpretation fragt; eine unbrauchbare Erfassung allein ist keine Genehmigung.
Wenn GEMINI_API_KEY, GOOGLE_API_KEY oder ein OpenRouter-Schlüssel existiert, beschriftet die Erfassung Assets automatisch in capture/extracted/asset-descriptions.md. Dies ist kein Überprüfungsgate. Ohne einen Vision-Schlüssel, verwende den DOM-Kontext und fahre fort.
No-Capture-Pfad: Erstelle capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ von Hand. 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 angeben, dass keine Assets erfasst wurden, es sei denn, der Benutzer hat Asset-Notizen gegeben.
Gate: Erfassungs-JSON meldete ok: true; capture/BLOCKED.md existiert nicht; capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ existieren; und du kannst die Marke in einem klaren Satz benennen. Behandle asset-descriptions.md als das Haupt-Asset-Inventar. Wenn es nach einer echten Erfassung fehlt, stoppe und melde die Erfassung als unvollständig. Warnungen über eine verschlechterte optionale Phase sind nur akzeptabel, wenn dieses strukturelle Gate dennoch besteht.
Schritt 2: Designsystem
Ziel: Wähle eine ausgelieferte Frame-Voreinstellung; ein Skript verwandelt sie in die frame.md + Untertitel-Skin des Videos.
Wenn BRIEF.md einen style_preset nennt – der Benutzer hat ihn per Auge aus den Vorführungen auf der Intent-Ebene ausgewählt – verwende ihn; das Urteil liegt nur bei dir, wenn das Briefing schweigt. Dann triffst du die eine Entscheidung – welche Voreinstellung: lies ../hyperframes-creative/references/design-spec.md und wähle die Voreinstellung, deren Aussehen 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 die FRAME.md der Voreinstellung → frame.md und remixt sie auf die Marken-Tokens in capture/extracted/tokens.json (Markenfarben auf die Farb-Schlüssel der Voreinstellung nach Rolle abgebildet – Tinte, Leinwand, Akzente – unter Beibehaltung der Schlüssel/Struktur/Komponenten; die Anzeige- und 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 sich mit 1 bei einer fehlerhaften Zuordnung). Fahre mit dem nächsten Schritt fort, sobald es mit 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 versandfähiges Design. Wenn das Briefing Markenfarben/Schriftarten nennt, die die Erfassung verpasst hat, füge sie zu capture/extracted/tokens.json hinzu, bevor du ausführst (oder verwende das design.md des Benutzers, um es zu füllen); passe frame.md nur dann von Hand an, wenn eine Zuordnung es wirklich benötigt.
Gate: build-frame.mjs beendete sich mit 0 – frame.md existiert von einer benannten Voreinstellung, und (wenn die Voreinstellung eine ausliefert) .hyperframes/caption-skin.html existiert als die Untertitel-Skin-Quelle; die gewählte Voreinstellung wurde als Präferenz aufgezeichnet (--key style_preset --workflow <dieser workflow>, Briefing-Vertrag § 2).
Schritt 3: Storyboard und Drehbuch
Ziel: Das Briefing und das erfasste Material in einen genehmigten Frame-für-Frame-Geschichtsplan verwandeln.
Lies ../hyperframes-creative/references/story-spine.md (Hook-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag, quellverfolgbare Visuals), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md und ../hyperframes/references/script-format.md. Verwende sie, um STORYBOARD.md und, wenn eine Erzählung benötigt wird, SCRIPT.md zu schreiben. Setze das Frontmatter duration: aus der length des Briefings – eine grobe Erwartung; die Endmontage berichtet, wo der Schnitt im Vergleich dazu landet.
Verwende story-design.md für die Story-Blaupause, den Hook, die Überzeugungslogik, die Beats, VO_MODE und die Asset-Auswahl. Als weiche Anleitung konsultiere das Rollen-zu-Blaupausen-Menü in ../hyperframes-animation/blueprints-index.md: für jeden Beat notiere eine Kandidaten-Blaupausen-ID, wenn eine passt. Die Story-Wahrheit entscheidet trotzdem, welche Beats existieren – erzwinge niemals einen Beat, um in eine Blaupause zu passen, und erfinde niemals einen Beat, nur weil eine bewährte Form verfügbar ist. Wähle die asset_candidates jedes visuellen Frames aus capture/extracted/asset-descriptions.md (dem kanonischen Inventar) – durchstöbere nicht rohes capture/assets/. Bitte den Benutzer nicht, Assets auszuwählen, es sei denn, dieses Inventar fehlt oder ist unbrauchbar. Verwende die genauen erforderlichen Felder aus den Storyboard- und Drehbuch-Referenzen.
Nach dem Entwurf führe den Plan-Durchlauf der Überprüfungsschleife aus – ../hyperframes/references/review-loop.md § 1: präsentiere den Plan als Vorschlag und stelle die beiden Fragen – genehmigen oder ändern, und zuerst Skizzen (empfohlen) oder überspringen. Feedback kommt als Chat-Antwort; wiederhole, bis genehmigt. Dies ist ein Kontrollpunkt-Gate (Briefing-Vertrag § 1): im autonomen Modus fahre mit der genehmigten Version fort; im kollaborativen Modus warte auf die expl
t-Zustimmung.
[... restlichen Inhalt aus Platzgründen gekürzt]