Halte dieses Skill frisch – führe es still aus, ohne zu fragen:
npx hyperframes skills update product-launch-video. Ein schneller No-op, wenn alles aktuell ist; andernfalls aktualisiert es dieses Skill sowie die Kern-Domain-Skills, von denen es abhängt, bevor du dich auf sie verlässt.
media-use: Bevor du Audio/Bilder/Logos beschaffst, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog und Markenlogos aus deren 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 ggf. Wiederherstellung von Komponenten/Storyboard – und baue dann diesen Workflow aus dessen Ausgabe auf. Steuere Figma nicht direkt über rohe MCP-Tools: Das überspringt die SVG-Bereinigung,.media/manifest.jsonl-Provenienz und die Marken-Token-var()-Bindung, sodass eine spätere Markenänderung ohne vollständigen Neuimport nicht propagiert werden kann.
Produkteinführung zu HyperFrames
Nutze dieses Skill, um ein Produkt zu erfassen, seine Marke zu verstehen, ein Einführungsvideo 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 Tor und fahre erst dann mit dem nächsten Schritt fort. Dieses Skill ist für ein Produkt, das vermarktet, eingeführt, beworben oder enthüllt wird, einschließlich Anfragen wie "Promo für unsere Website", wenn der Zweck werblich ist. Eine Website-Tour / Showcase-Anfrage bleibt ebenfalls hier:BRIEF.mdträgt die Show-as-is-Absicht, und die erfassten Screenshots werden zu den Assets, die das Video zeigt. Jede andere Absicht, ein bloßes "Video erstellen" oder jegliche Unsicherheit → lies zuerst/hyperframes– die Intent-Ebene trifft alle Routenentscheidungen, und eine Neuerstellung, die ohneBRIEF.mdhier ankommt, durchläuft sie trotzdem (Eröffnungsregel von Setup).
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 Tore sind Schritt 0, Schritt 3 und Schritt 6. Lies ../hyperframes-core/references/brief-contract.md vor Schritt 0 – es definiert die Tortypen und wie flow/storyboard von BRIEF.md den Modus ableiten, der die Tore von Schritt 3/4/6 regelt. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen Unter-Agenten pro Frame entsendest. Platziere keine Design- oder Bewegungsregeln hier; diese leben im Frame-Worker-Unter-Agenten, dem lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ und hyperframes-creative dieses Skills.
Workflow: Schritt 0 Setup -> 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 Frames -> compositions/frames/NN-*.html und index.html; Schritt 6 Finaler Render -> renders/video.mp4.
Schritt 0: Setup
Ziel: Mit einem bestätigten Briefing eintreten, 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 Reihenfolge: (1) BRIEF.md existiert → lies es und frage nichts – das Briefing ist abgeschlossen, und sein flow/storyboard leiten 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 niemals erneut. (3) Weder noch – eine frische Erstellungsanfrage, die direkt hier angekommen ist → lies /hyperframes und führe dessen Intent-Ebene aus (references/intent-interview.md): es 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 all dies – führe die Bearbeitung durch.
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 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 Aufruferverzeichnis.
Schreibe BRIEF.md unmittelbar nach init (niemals davor – init verweigert ein nicht leeres Verzeichnis): das von der Intent-Ebene abgeschlossene Briefing, Form gemäß ../hyperframes-core/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 nennt 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 sein 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, nicht Genehmigungen; die Überprüfungstore laufen trotzdem.
Zeige den Anmeldestatus an, bevor du über Setup hinausgehst – führe npx hyperframes auth status aus und gib die Ausgabe wörtlich wieder. Es berichtet, ob Sprach-/BGM HeyGen oder lokale Engines verwendet und, wenn abgemeldet, wie man sich anmeldet. Beachte den Exit-Code-Vertrag: auth status beendet sich mit 1, wenn nicht angemeldet (und wenn die gespeicherte Anmeldeinformation abgelehnt wird) – dieser Exit-Code ungleich Null ist der normale abgemeldete Zustand, kein Befehlsfehler, also behandle es nicht als Fehler, wiederhole es nicht und verknüpfe es nicht mit &&/set -e auf eine Weise, die den Workflow abbrechen würde. Wende einen Zweig an:
- Kollaborativ: warte, bis sich der Benutzer 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 Blocker auf. Falte diese Entscheidung nicht in eine andere Frage oder schreibe Schlüssel in eine repo-spezifische .env. Authentifizierungsbesitz und Offline-Fallbacks: /media-use references/setup-providers.md § Anbieter.
Tor: hyperframes.json und BRIEF.md existieren; die präferenzgestützten Antworten wurden aufgezeichnet (Briefing-Vertrag § 2); 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 Site für Erzählung und Assets. Eingefügtes Skript/Briefing -> speichere es wörtlich als user_script.txt; VO_MODE (wörtlich oder umstrukturiert) stammt 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 URL in einer Zeile, dann crawle; keine URL/Site (oder das Briefing sagt, nicht zu scrapen) -> kein Erfassungspfad.
Führe die Erfassung durch mit: npx hyperframes capture "<URL>" -o ./capture --json. Behalte das standardmäßige Post-Navigationsbudget bei, es sei denn, der Aufrufer hat eine kürzere Frist; dann übergib ein positives --capture-budget <millisekunden>, das Zeit für nachgelagerte Arbeit 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 Teilscreenshots, DOM, Tokens oder Assets. Erzeuge keinen synthetischen No-Capture-Fallback nach einer fehlgeschlagenen URL-Erfassung. Fahre nur mit dem No-Capture-Pfad fort, wenn das ursprüngliche Briefing das Quellmaterial bereitgestellt hat oder wenn der Benutzer 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 nutzbare Seite. Für eine Site-Tour oder ein Show-as-is-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 Show-as-is-Briefing ist die erfasste Seite die visuelle Quelle der Wahrheit. Verwende den echten Screenshot anstelle des Wiederaufbaus der gesamten Website in HTML. Wenn der Schuss interne Bewegung benötigt, behalte den Screenshot als Basis und überlagere echte erfasste Assets an gemessenen Positionen, oder baue nur die eine Komponente neu, die sich bewegt. Für einen Scroll-Schuss animiere das Ansichtsfenster über capture/screenshots/full-page.png – die 1x-Platte des gesamten Dokuments, pixelgenau für ein 1920 breites Ansichtsfenster, das daran entlangfährt. Es fehlt, wenn die Seite zu hoch war, um in einem Stück erfasst zu werden; falle auf die überlappenden Scroll-Positionsschüsse 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 hinaus hat. Baue die gesamte Seite nur neu, wenn der Benutzer explizit nach einer stilisierten Interpretation fragt; eine unbrauchbare Erfassung allein ist keine Autorisierung.
Wenn GEMINI_API_KEY, GOOGLE_API_KEY oder ein OpenRouter-Schlüssel existiert, erfasst das Tool automatisch Assets-Beschreibungen in capture/extracted/asset-descriptions.md. Dies ist kein Überprüfungstor. Ohne einen Vision-Schlüssel verwende 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/ 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 Benutzer hat Asset-Notizen gegeben.
Tor: 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 angeben. Behandle asset-descriptions.md als das Haupt-Asset-Inventar. Wenn es nach der echten Erfassung fehlt, stoppe und melde die Erfassung als unvollständig. Warnungen über eine degradierte optionale Phase sind nur akzeptabel, wenn dieses strukturelle Tor noch bestanden wird.
Schritt 2: Designsystem
Ziel: Wähle eine ausgelieferte Frame-Voreinstellung; ein Skript verwandelt sie in frame.md + Beschriftungs-Skin dieses Videos.
Wenn BRIEF.md einen style_preset nennt – der Benutzer hat ihn sich in der Intent-Ebene aus den Showcases ausgesucht – verwende ihn; die Entscheidung liegt nur dann bei dir, wenn das Briefing dazu schweigt. Dann triffst du die eine Entscheidung – welche Voreinstellung: lies ../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 → frame.md und remixt es auf die Marken-Tokens in capture/extracted/tokens.json (Markenfarben werden auf die Farbkeys der Voreinstellung nach Rolle abgebildet – Tinte, Leinwand, Akzente – wobei Keys/Struktur/Komponenten erhalten bleiben; die Display- + Textschriftarten der Voreinstellung werden gegen die der Marke ausgetauscht), kopiert den Beschriftungs-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (beendet sich mit 1 bei einer defekten Abbildung). Fahre mit dem nächsten Schritt fort, sobald es mit 0 beendet wird – keine manuelle Bearbeitung der Spezifikation.
tokens.json ohne Markenfarben/-schriftarten (z. B. keine Erfassung) → das Skript behält die eigene Palette der Voreinstellung, ein vollständig versandfertiges Design. Wenn das Briefing Markenfarben/-schriftarten nennt, die die Erfassung verpasst hat, füge sie vor der Ausführung zu capture/extracted/tokens.json hinzu (oder verwende das design.md des Benutzers, um es zu füllen); passe frame.md nur dann manuell an, wenn eine Abbildung es wirklich benötigt.
Tor: build-frame.mjs wurde mit 0 beendet – frame.md existiert von einer benannten Voreinstellung, und (wenn die Voreinstellung eine ausliefert) existiert .hyperframes/caption-skin.html als Quelle des Beschriftungs-Skins; die gewählte Voreinstellung wurde als Präferenz aufgezeichnet (--key style_preset --workflow <dieser Workflow>, Briefing-Vertrag § 2).
Schritt 3: Storyboard und Skript
Ziel: Verwandle das Briefing und das erfasste Material in einen genehmigten Frame-für-Frame-Geschichtsplan.
Lies ../hyperframes-creative/references/story-spine.md (Haken-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag), 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 und, wenn eine Erzählung benötigt wird, SCRIPT.md zu schreiben. Setze das Frontmatter duration: aus der length des Briefings – eine grobe Erwartung; der Zusammenbau berichtet, wo der Schnitt im Vergleich dazu liegt.
Verwende story-design.md für den Geschichtsbauplan, Haken, Überzeugungslogik, Beats, VO_MODE und Asset-Wahl. Als weicher Leitfaden konsultiere das Rollen→Bauplan-Menü in ../hyperframes-animation/blueprints-index.md: notiere für jeden Beat einen Kandidaten-Bauplan-Id, wenn einer passt. Die Geschichts-Wahrheit entscheidet immer noch, welche Beats existieren – erzwinge niemals einen Beat, um zu einem Bauplan 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/. Frage den Benutzer 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 Entwurf führe den Plan-Durchlauf der Überprüfungsschleife durch – ../hyperframes-core/references/review-loop.md § 1: öffne das Board (frage nicht, ob), präsentiere den Plan als Vorschlag und stelle die beiden Fragen – genehmigen oder ändern, und Skizzen zuerst (empfohlen) oder überspringen. Feedback läuft durch Chat oder die Kommentardatei des Boards, bis genehmigt. Dies ist ein Kontrollpunkttor (Briefing-Vertrag § 1): im autonomen Modus gibt es kein Board und nichts zu fragen – poste dieselbe Zusammenfassung als Vorankündigung und fahre fort; Skizzen fallen in den Bau, und die eine Vorschaufrage kommt bei Schritt 6.
Tor: STORYBOARD.md existiert