Halte dieses Skill aktuell – bestätige mit dem Benutzer, bevor du es ausführst:
npx hyperframes skills update faceless-explainer. Ein schneller No-Op, wenn alles auf dem neuesten Stand ist; andernfalls aktualisiert es dieses Skill und 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 offiziellen Quellen zu erhalten. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill.
Faceless Explainer zu HyperFrames
Verwende dieses Skill, um einen Textkörper in ein Erklärvideo zu verwandeln: Wähle ein Designsystem, plane eine lehrreiche Geschichte und baue sie Frame für Frame in HyperFrames auf. Faceless bedeutet, dass jede visuelle Darstellung downstream erfunden wird – es gibt keinen Erfassungsschritt und kein reales Asset-Inventar.
Der Eingang ist
/hyperframes. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Gate und fahre nur dann fort. Dieses Skill ist dafür gedacht, ein Thema aus einem Text zu erklären, ohne Produkt und ohne zu erfassende Website. Bei jeder anderen Absicht, einem einfachen "ein Video erstellen" oder Unsicherheit → lies zuerst/hyperframes– die Intent-Ebene besitzt jede Routenentscheidung, und eine neue Erstellung, die hier ohneBRIEF.mdankommt, durchläuft sie trotzdem (Eröffnungsregel des Setups).
Du bist der Orchestrator. Arbeite in videos/<project>/. Führe Schritte in der Reihenfolge aus und passiere jedes Gate, bevor du fortfährst. Benutzergesteuerte Gates sind Schritt 0, Schritt 3 und Schritt 6. Lies ../hyperframes/references/brief-contract.md vor Schritt 0 – es definiert die Gatestypen und wie BRIEF.md's flow/storyboard den Modus ableiten, der die Gates der Schritte 3/4/6 steuert. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen Sub-Agenten pro Frame entsendest. Platziere keine Design- oder Bewegungsregeln hier; diese leben im Frame-Worker-Sub-Agenten, den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ und hyperframes-creative.
Workflow: Schritt 0 Setup → hyperframes.json; Schritt 1 Brief → capture/extracted/; 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 Finales Rendern → renders/video.mp4.
Schritt 0: Einrichtung
Ziel: Mit einem bestätigten Brief starten, das HyperFrames-Projekt erstellen und den Brief dauerhaft machen.
Der Brief wird von der Intent-Ebene bestätigt, nicht durch hier gestellte Fragen. Öffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lies es und frage nichts – der Brief ist abgeschlossen, und sein flow/storyboard leiten den Modus ab (Briefvertrag § 1). (2) Kein BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf der Festplatte) → setze vom Frontmatter des Storyboards und den gespeicherten Präferenzen fort; befrage niemals ein halbfertiges Projekt erneut. (3) Weder noch – eine frische Erstellungsanfrage, die direkt hier ankommt → lies /hyperframes und führe dessen Intent-Ebene aus (references/intent-interview.md): es überprüft Rezepte und gespeicherte Standardeinstellungen, führt die Fragen dieser Route durch (../hyperframes/references/routes/faceless-explainer.md) und gibt den gesperrten Brief zurück. Bearbeitungsanfragen überspringen all dies – führe die Bearbeitung durch.
Initialisiere nur, wenn hyperframes.json fehlt. Benenne <project> nach dem Thema in Kebab-Schreibweise, z. B. compound-interest-explained; verwende niemals den Workspace-Namen oder einen Zeitstempel.
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer – init überprü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/<project> 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 sofort nach der Initialisierung (niemals davor – init lehnt ein nicht leeres Verzeichnis ab): der gesperrte Brief der Intent-Ebene, Form 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 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 seine frame.md in das Projekt (Schritt 2 wird dann übersprungen) und gibt die Skelette zurück, von denen Schritt 3-Entwürfe ausgehen. Ein Rezept füllt Antworten, nicht 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 wörtlich weiter. Es meldet, ob Sprache/BGM HeyGen oder lokale Engines verwendet und, wenn abgemeldet, wie man sich anmeldet. Wende einen Zweig an:
- Kollaborativ: Warte, bis 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 das Hindernis an. Falte diese Entscheidung nicht in eine andere Frage oder schreibe Schlüssel in ein 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 (Briefvertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet, oder Fortsetzung offline).
Schritt 1: Brief (keine Erfassung)
Ziel: Den Text des Benutzers als Informationsquelle in das Projekt einfügen. Es gibt keine Website-Erfassung und keine echten Assets – dies ist ein Faceless Explainer.
Speichere die vollständige Eingabe des Benutzers wörtlich und erstelle dann das synthetische Erfassungspaket von Hand:
capture/extracted/visible-text.txt– der vollständige Artikel / die Notizen / das Thema / die Kurzbeschreibung, wörtlich. Dies ist die Quelle der Information, keine Story-Vorlage (Schritt 3 formt sie um).capture/extracted/tokens.json–{ "title": "", "description": "", "colors": [], "fonts": [] }. Fülletitle/descriptionaus dem Brief. Lassecolors/fontsleer, es sei denn, der Benutzer hat explizit Markenfarben oder -schriftarten angegeben – füge sie dann hinzu (die Designvoreinstellung liefert trotzdem eine vollständige Palette).
Wenn der Benutzer ein Skript eingefügt hat oder möchte, dass seine Formulierung erhalten bleibt, 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 nach, wenn der Brief es irgendwie vermissen lässt, und speichere die Antwort für Schritt 3.
Führe nicht npx hyperframes capture aus (es gibt keine URL). Erstelle kein asset-descriptions.md oder fülle capture/assets/ – Faceless-Visuals werden in den Schritten 4-5 erfunden, nicht erfasst. Die eine Ausnahme: Wenn der Benutzer ein echtes Bild bereitgestellt hat, platziere es unter public/<basename> und vermerke es für Schritt 3.
Gate: capture/extracted/visible-text.txt und capture/extracted/tokens.json existieren; du kannst das Thema und die Zielgruppe des Erklärers in einem klaren Satz angeben.
Schritt 2: Designsystem
Ziel: Wähle eine mitgelieferte Frame-Voreinstellung; ein Skript wandelt sie in das frame.md + Untertitel-Skin dieses Videos um.
Wenn BRIEF.md einen style_preset nennt – der Benutzer hat ihn sich in den Präsentationen der Intent-Ebene ausgesucht – verwende ihn; die Beurteilung liegt nur bei dir, wenn der Brief schweigt. Dann triffst du die eine Entscheidung – welche Voreinstellung: lies ../hyperframes-creative/references/design-spec.md und durchsuche ../hyperframes-creative/frame-presets/; wähle die Voreinstellung, deren Aussehen am besten zu Thema, Ton und Zielgruppe passt. Führe dann aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
Das Skript erledigt den Rest deterministisch: es kopiert das FRAME.md der Voreinstellung → frame.md und mischt es mit allen Marken-Token in capture/extracted/tokens.json (Markenfarben werden nach Rolle auf die Farbtasten der Voreinstellung abgebildet; die Anzeige- + Textschriftarten der Voreinstellung werden gegen die der Marke ausgetauscht), kopiert das Untertitel-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit 1 bei einer fehlerhaften Zuordnung). Fahre fort, sobald es mit 0 beendet ist – keine manuelle Bearbeitung der Spezifikation.
Ein Faceless Explainer hat normalerweise keine Markenfarben/-schriftarten (tokens.json Farben/Schriftarten leer) → das Skript behält die eigene Palette der Voreinstellung, ein vollständiges, auslieferbares Design. Nur wenn der Benutzer Markenfarben/-schriftarten genannt hat, füge sie vor der Ausführung zu tokens.json hinzu, und passe frame.md nur dann von Hand an, wenn eine Zuordnung es wirklich erfordert.
Gate: build-frame.mjs wurde mit 0 beendet – frame.md existiert von einer benannten Voreinstellung, und (wenn die Voreinstellung eine mitliefert) .hyperframes/caption-skin.html existiert als Quelle des Untertitel-Skins; die gewählte Voreinstellung wurde als Präferenz aufgezeichnet (--key style_preset --workflow <this workflow>, Briefvertrag § 2).
Schritt 3: Storyboard und Skript
Ziel: Den Text in einen genehmigten Frame-für-Frame-Lehrplan verwandeln.
Lies ../hyperframes-creative/references/story-spine.md (Aufhängersprache, Wert-vor-Beweis, Storyboard als Vorschlag, quellnachvollziehbare 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 die duration: im Frontmatter aus der length des Briefs – eine grobe Erwartung; die Montage berichtet, wo der Schnitt relativ dazu landet.
Verwende story-design.md für die Erklärstruktur (Konzept / Anleitung / Liste / Geschichte), Aufhängungsstrategie, Klarheitstechniken, emotionale Beats, die Typ-Enum-Zuordnung und VO_MODE. Die Reihenfolge des Videos stammt aus dem narrativen Design, nicht aus der Absatzreihenfolge des Eingabetextes – ordne neu, führe zusammen, lasse aus, komprimiere. Als weichen Leitfaden konsultiere die Rolle→Blueprint-Menü in ../hyperframes-animation/blueprints-index.md: Schreibe für jeden Beat das Voiceover in der Form, die sein Kandidaten-Blueprint impliziert, und tagge diesen Kandidaten mit der blueprint:-ID, wenn eine passt. Die Lehrwahrheit entscheidet immer noch, welche Beats existieren – erzwinge niemals einen Beat, um in einen Blueprint zu passen, und erfinde niemals einen Beat, nur weil eine bewährte Form verfügbar ist. Faceless-Visuals werden downstream erfunden, daher führen Frames kein Asset-Inventar: Lasse asset_candidates leer, es sei denn, der Benutzer hat ein echtes public/<basename>-Bild bereitgestellt. Verwende die genauen erforderlichen Felder aus den Storyboard- und Skript-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; schleife, bis genehmigt. Dies ist ein Kontrollpunkt-Gate (Briefvertrag § 1): Im autonomen Modus gibt es nichts zu fragen – poste dieselbe Zusammenfassung als Vorankündigung und fahre fort; Skizzen werden in den Build integriert, und die eine Vorschaufrage kommt bei Schritt 6.
Gate: STORYBOARD.md existiert, jeder Frame hat die erforderlichen narrativen Felder, SCRIPT.md existiert, wenn eine Erzählung benötigt wird, und der Benutzer hat den Frame-für-Frame-Plan genehmigt (autonom: die Zusammenfassung wurde als Vorankündigung gepostet).
Schritt 3.1: Audio
Ziel: Erzählung, Wortzeitsteuerung, Musik und Audio-Metadaten aus dem genehmigten Skript generieren.
Starte Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus und fahre dann mit Schritt 4 fort. (Der Anmeldestatus wurde bereits in Schritt 0 angezeigt; die Engine fällt automatisch zurück.)
Wähle die Erzählstimme aus der Anfrage des Benutzers, bevor du sie aufrufst. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Ton genannt hat, wähle eine passende Stimmen-ID und übergebe sie mit --voice <id>. Die Pipeline-Voreinstellung ist ansonsten Marcia (weiblich) auf HeyGen / am_michael auf Kokoro – eine Anfrage wie "eine männliche Stimme" wird also stillschweigend ignoriert, es sei denn, du übergibst das Flag. Stimmen-IDs sind anbieterabhängig; löse sie gegen den Anbieter auf, den der Anmeldestatus von Schritt 0 ausgewählt hat: HeyGen (angemeldet) über node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (oder GET /v3/voices?engine=starfish); Kokoro (offline) über die Stimmentabelle in <MEDIA_DIR>/audio/references/tts.md (Präfixe am_/bm_ männlich, af_/bf_ weiblich). Wenn der Benutzer keine Präferenz geäußert hat, falle auf die gespeicherte Stimme zurück (Briefvertrag § 2), bevor die Pipeline-Voreinstellung verwendet wird, und sage, welche du verwendet hast; lasse --voice nur weg, wenn keine eine nennt. Wenn der Benutzer in diesem Durchlauf explizit eine Stimme ausgewählt hat, zeichne sie auf (prefs.mjs record --key voice).
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
Das Audio-Skript übernimmt Erzählung, Wortzeitsteuerung, BGM-Suche aus der HeyGen-Musikbibliothek und Zeitsteuerungs-Metadaten. Die BGM-Stimmung stammt aus dem music:-Feld des Storyboards. Dies verwendet die HeyGen-Audio-API für den Abruf, nicht die Generierung, und dieselbe ~/.heygen-Anmeldeinformation wie TTS. Für Anbieterdetails lies ../media-use/audio/references/tts.md.
Wenn es keine Erzählung und kein SCRIPT.md gibt, überspringe die Sprachgenerierung. BGM kann trotzdem laufen, wenn das Storyboard eine Musikstimmung hat.
Der kanonische vollständige Stille-Marker (von den Workflows gemeinsam genutzt, die dieses Audio-Modell wiederverwenden): music: none im oberen YAML-Block von STORYBOARD.md und kein SCRIPT.md. Diese Kombination markiert das Projekt als still – keine Erzählung, kein BGM, keine SFX. audio.mjs erkennt dies und generiert nichts (es entfernt jede veraltete audio_meta.json; eine fehlende audio_meta.json wird von der Montage als still behandelt), daher ist dieser Schritt ein sauberer Übersprung. music: none mit Erzählung behält TTS und schaltet nur BGM aus. Verwende genau diese Schreibweise – improvisiere keine anderen Marker.
Gate: Audio-Job wurde gestartet, oder das Projekt ist als still markiert (music: none + kein SCRIPT.md).
Schritt 4: Visuelles Frame-Design
Ziel: Füge jedem Storyboard-Frame die visuelle Richtung, Layout-Absicht und Bewegungsentscheidungen hinzu.
Skizziere zuerst das Storyboard-Blatt (nur kollaborativ). Sobald der Plan genehmigt ist, führe den Skizzen-Durchlauf aus – ../hyperframes/references/review-loop.md § 2 (warte nicht auf Schritt 3.1; Skizzen verwenden keine Zeitsteuerung): Drahtgittermodelle jeden Frame selbst als Zelle von storyboard.html (../hyperframes/references/storyboard-format.md definiert die erforderlichen Felder des Frames, die Zellenbreite ...