Plugin-Installation: Befolgen Sie vor der Einrichtung oder Aktualisierung die Plugin-Ausführungsregeln, wenn dieser Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen bleiben die unten stehenden Aktualisierungshinweise gültig.
Halten Sie diesen Skill zunächst aktuell – Fragen Sie den Benutzer, bevor Sie Folgendes ausführen:
npx hyperframes skills update faceless-explainer. Eine schnelle Aktion ohne Änderungen, wenn alles auf dem neuesten Stand ist; andernfalls wird dieser Skill zusammen mit den abhängigen Kern-Skills aktualisiert, bevor Sie darauf vertrauen.
media-use: Bevor Sie Audio/Logos/Bilder beschaffen, rufen Sie
/media-useauf, um Hintergrundmusik/Soundeffekte/Bilder aus dem HeyGen-Katalog und Markenlogos aus offiziellen Quellen zu beziehen. Führen Sie zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe Skill/media-use.
Erklärvideo ohne Gesichter zu HyperFrames
Nutzen Sie diesen Skill, um einen Textkörper in ein Erklärvideo zu verwandeln: Wählen Sie ein Designsystem, planen Sie eine Lehrgeschichte und bauen Sie diese Frame für Frame in HyperFrames auf. Ohne Gesichter bedeutet, dass jedes Bild nachgelagert erfunden wird – es gibt keinen Aufnahmeschritt und kein reales Asset-Inventar.
Der Einstieg ist
/hyperframes. Sie sind der Orchestrator. Führen Sie jeden Schritt aus, überprüfen Sie sein Tor und fahren Sie erst dann fort. Dieser Skill dient der Erklärung eines Themas aus einem Text, ohne Produkt und ohne aufzunehmende Website. Bei jeder anderen Absicht, einem bloßen „Video erstellen“ oder bei Unsicherheit → lesen Sie zuerst/hyperframes– die Absichtsebene entscheidet über die Route, und eine neue Kreation, die ohneBRIEF.mdhier ankommt, durchläuft sie ohnehin (Eröffnungsregel von Script).
Sie sind der Orchestrator. Arbeiten Sie in videos/<Projekt>/. Führen Sie die Schritte in der Reihenfolge aus und passieren Sie jedes Tor, bevor Sie fortfahren. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Lesen Sie ../hyperframes/references/brief-contract.md vor Schritt 0 – es definiert die Tortypen und wie BRIEF.md's flow/storyboard den Modus ableiten, der die Tore der Schritte 3/4/6 steuert. Führen Sie jeden Schritt selbst aus, außer Schritt 5, bei dem Sie einen Unteragenten pro Frame entsenden. Legen Sie hier keine Design- oder Bewegungsregeln fest; diese leben im Frame-Worker-Unteragenten, den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ dieses Skills und hyperframes-creative.
Workflow: Schritt 0 Einrichtung → 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 Finaler Render → renders/video.mp4.
Schritt 0: Einrichtung
Ziel: Mit einem bestätigten Brief beginnen, das HyperFrames-Projekt erstellen und den Brief dauerhaft machen.
Der Brief wird von der Absichtsebene bestätigt, nicht durch hier gestellte Fragen. Eröffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lesen Sie es und fragen Sie nichts – der Brief ist abgeschlossen, und sein flow/storyboard leiten den Modus ab (Briefvertrag § 1). (2) Kein BRIEF.md vorhanden, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf der Festplatte) → setzen Sie vom Frontmatter des Storyboards und den aufgezeichneten Präferenzen fort fort; fragen Sie ein halbfertiges Projekt niemals erneut ab. (3) Weder noch – eine frische Erstellungsanfrage, die direkt hier ankommt → lesen Sie /hyperframes und führen Sie dessen Absichtsebene 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 dies alles – führen Sie die Bearbeitung durch.
Initialisieren Sie nur, wenn hyperframes.json fehlt. Benennen Sie <Projekt> nach dem Thema in Kebab-Schreibweise, z. B. zinseszins-erklaert; verwenden Sie niemals den Arbeitsbereichsnamen oder einen Zeitstempel.
npx hyperframes init "videos/<Projekt>" --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 <PROJEKT_ROOT> gleich videos/<Projekt> und führen Sie jeden nachfolgenden relativen Pfadbefehl mit diesem Verzeichnis als Arbeitsverzeichnis aus. In den Befehlen unten bedeutet . <PROJEKT_ROOT>; schreiben Sie niemals .media, capture oder Ausgabedateien in das Aufruferverzeichnis.
Schreiben Sie BRIEF.md unmittelbar nach der Initialisierung (niemals davor – init lehnt ein nicht leeres Verzeichnis ab): der gesperrte Brief der Absichtsebene, formatiert gemäß ../hyperframes/references/brief-format.md. Lösen Sie <MEDIA_DIR> als das installierte /media-use-Skill-Verzeichnis auf. Zeichnen Sie dann jede präferenzgestützte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md nennt die Teilmenge). Wenn die Absichtsebene ein Rezept übernommen hat, führen Sie 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 ausgehen. Ein Rezept füllt Antworten, nicht Genehmigungen; die Überprüfungstore laufen trotzdem.
Zeigen Sie den Anmeldestatus an, bevor Sie über die Einrichtung hinausgehen – führen Sie npx hyperframes auth status aus und geben Sie dessen Ausgabe wörtlich wieder. Es meldet, ob Sprachausgabe/Hintergrundmusik HeyGen oder lokale Engines verwendet und, wenn abgemeldet, wie man sich anmeldet. Wenden Sie einen Zweig an:
- Kollaborativ: Warten Sie, bis der Benutzer sich anmeldet oder explizit
offline/gowählt. - Autonom: Geben Sie den Status an und fahren Sie über die verfügbaren lokalen Engines fort.
Übersehen Sie nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter existiert; machen Sie den Block sichtbar. Falten Sie diese Entscheidung nicht in eine andere Frage und schreiben Sie keine Schlüssel in ein pro-Repo .env. Eigentum der Authentifizierung und Offline-Fallbacks: /media-use references/setup-providers.md § Anbieter.
Tor: hyperframes.json und BRIEF.md existieren; die präferenzgestützten Antworten wurden aufgezeichnet (Briefvertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet oder Offline-Fortsetzung).
Schritt 1: Brief (keine Aufnahme)
Ziel: Den Text des Benutzers als Informationsquelle in das Projekt einbinden. Es gibt keine Website-Aufnahme und keine echten Assets – dies ist ein Erklärvideo ohne Gesichter.
Speichern Sie die vollständige Eingabe des Benutzers wörtlich und erstellen Sie dann das synthetische Aufnahmepaket von Hand:
capture/extracted/visible-text.txt– der vollständige Artikel / die Notizen / das Thema / der Brief, wörtlich. Dies ist die Informationsquelle, keine Story-Vorlage (Schritt 3 formt sie um).capture/extracted/tokens.json–{ "title": "", "description": "", "colors": [], "fonts": [] }. Füllen Sietitle/descriptionaus dem Brief. Lassen Siecolors/fontsleer, es sei denn, der Benutzer hat explizit Markenfarben oder -schriftarten angegeben – dann fügen Sie sie hinzu (die Designvorgabe liefert ohnehin eine vollständige Palette).
Falls der Benutzer ein Skript eingefügt hat oder wünscht, dass sein Wortlaut erhalten bleibt, speichern Sie es wörtlich als user_script.txt; VO_MODE (wörtlich oder umstrukturiert) stammt aus BRIEF.md – die Absichtsebene fragt danach, wenn ein Skript eintrifft. Fragen Sie hier nur einmal, wenn es dem Brief fehlt, und speichern Sie die Antwort für Schritt 3.
Führen Sie nicht npx hyperframes capture aus (es gibt keine URL). Erstellen Sie kein asset-descriptions.md oder befüllen Sie capture/assets/ – Bilder ohne Gesichter werden in den Schritten 4-5 erfunden, nicht aufgenommen. Die einzige Ausnahme: Wenn der Benutzer ein echtes Bild bereitgestellt hat, legen Sie es unter public/<Basisname> ab und notieren Sie es für Schritt 3.
Tor: capture/extracted/visible-text.txt und capture/extracted/tokens.json existieren; Sie können das Thema und die Zielgruppe des Erklärvideos in einem klaren Satz nennen.
Schritt 2: Designsystem
Ziel: Ein ausgeliefertes Frame-Preset auswählen; ein Skript verwandelt es in frame.md + Untertitel-Skin dieses Videos.
Wenn BRIEF.md einen style_preset nennt – der Benutzer hat ihn anhand der Präsentationen auf der Absichtsebene ausgewählt – verwenden Sie ihn; die Entscheidung liegt nur bei Ihnen, wenn der Brief schweigt. Dann treffen Sie die eine Entscheidung – welches Preset: Lesen Sie ../hyperframes-creative/references/design-spec.md und durchsuchen Sie ../hyperframes-creative/frame-presets/; wählen Sie das Preset, dessen Look am besten zum Thema, Ton und Zielgruppe passt. Führen Sie dann aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <Name> --hyperframes .
Das Skript erledigt den Rest deterministisch: Es kopiert das FRAME.md des Presets → frame.md und remixt es auf alle Marken-Token in capture/extracted/tokens.json (Markenfarben werden nach Rolle auf die Farbschlüssel des Presets abgebildet; die Anzeige- + Textschriftarten des Presets werden gegen die der Marke ausgetauscht), kopiert den Untertitel-Skin des Presets nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit 1 bei einer fehlerhaften Zuordnung). Fahren Sie fort, sobald es mit 0 beendet ist – keine manuelle Bearbeitung der Spezifikation.
Ein Erklärvideo ohne Gesichter hat normalerweise keine Markenfarben/-schriftarten (tokens.json Farben/Schriftarten leer) → das Skript behält die eigene Palette des Presets, ein vollständiges, versandfähiges Design. Nur wenn der Benutzer Markenfarben/-schriftarten genannt hat, fügen Sie sie vor der Ausführung zu tokens.json hinzu und passen Sie frame.md nur dann von Hand an, wenn eine Zuordnung dies wirklich erfordert.
Tor: build-frame.mjs wurde mit 0 beendet – frame.md existiert von einem benannten Preset, und (wenn das Preset eines ausliefert) .hyperframes/caption-skin.html existiert als Quelle des Untertitel-Skins; das gewählte Preset wurde als Präferenz aufgezeichnet (--key style_preset --workflow <dieser Workflow>, Briefvertrag § 2).
Schritt 3: Storyboard und Skript
Ziel: Den Text in einen genehmigten Frame-für-Frame-Lehrplan verwandeln.
Lesen Sie ../hyperframes-creative/references/story-spine.md (Aufhängersprache, Wert-vor-Beweis, Storyboard-als-Vorschlag, quellennachvollziehbare Bilder), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md und ../hyperframes/references/script-format.md. Verwenden Sie sie, um STORYBOARD.md und, wenn eine Erzählung benötigt wird, SCRIPT.md zu schreiben. Setzen Sie die Frontmatter duration: aus der length des Briefs – eine grobe Erwartung; der Zusammenbau berichtet, wo der Schnitt im Vergleich dazu landet.
Verwenden Sie story-design.md für die Erklärstruktur (Konzept / Anleitung / Liste / Geschichte), Aufhängungsstrategie, Klarheitstechniken, emotionale Beats, die Typ-Aufzählungszuordnung und VO_MODE. Die Abfolge des Videos stammt aus dem narrativen Design, nicht aus der Absatzreihenfolge des Eingabetextes – neu anordnen, zusammenführen, weglassen, komprimieren. Als weichen Leitfaden konsultieren Sie die Rollen-zu-Blueprint-Menü in ../hyperframes-animation/blueprints-index.md: Schreiben Sie für jeden Beat die Voiceover in der Form, die sein Kandidaten-Blueprint impliziert, und markieren Sie diesen Kandidaten mit blueprint: id, wenn einer passt. Die Lehrwahrheit entscheidet dennoch, welche Beats existieren – erzwingen Sie niemals einen Beat, um in ein Blueprint zu passen, und erfinden Sie keinen Beat nur, weil eine bewährte Form verfügbar ist. Bilder ohne Gesichter werden nachgelagert erfunden, daher tragen Frames kein Asset-Inventar: Lassen Sie asset_candidates leer, es sei denn, der Benutzer hat ein echtes public/<Basisname>-Bild bereitgestellt. Verwenden Sie die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.
Führen Sie nach dem Entwurf den Planungsdurchlauf der Überprüfungsschleife aus – ../hyperframes/references/review-loop.md § 1: Präsentieren Sie den Plan als Vorschlag und stellen Sie die beiden Fragen – genehmigen oder ändern, und Skizzen zuerst (empfohlen) oder überspringen. Feedback kommt als Chat-Antwort; Schleife, bis genehmigt. Dies ist ein Kontrollpunkttor (Briefvertrag § 1): Im autonomen Modus gibt es nichts zu fragen – veröffentlichen Sie dieselbe Zusammenfassung als Hinweis und fahren Sie fort; Skizzen fallen in den Build, und die endgültige Vorschau mit ihrer einen Frage kommt in Schritt 6.
Tor: 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 Hinweis veröffentlicht).
Schritt 3.1: Audio
Ziel: Erzählung, Wortzeitsteuerung, Musik und Audio-Metadaten aus dem genehmigten Skript generieren.
Starten Sie Audio nach der Genehmigung von Schritt 3. Führen Sie es im Hintergrund aus, fahren Sie dann mit Schritt 4 fort. (Der Anmeldestatus wurde bereits in Schritt 0 angezeigt; die Engine fällt automatisch zurück.)
Wählen Sie die Erzählstimme basierend auf der Anfrage des Benutzers, bevor Sie aufrufen. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Ton genannt hat, wählen Sie eine passende Stimmen-ID und übergeben Sie sie mit --voice <ID>. Der Pipeline-Standard ist ansonsten Marcia (weiblich) auf HeyGen / am_michael auf Kokoro – daher wird eine Anfrage wie „eine männliche Stimme“ stillschweigend ignoriert, es sei denn, Sie übergeben das Flag. Stimmen-IDs sind anbieterspezifisch; lösen Sie gegen den Anbieter auf, den der Anmeldestatus von Schritt 0 ausgewählt hat: HeyGen (angemeldet) via node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (oder GET /v3/voices?engine=starfish); Kokoro (offline) via der 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, fallen Sie auf die gespeicherte Stimme zurück (Briefvertrag § 2), bevor Sie den Pipeline-Standard verwenden, und sagen Sie, welche Sie verwendet haben; lassen Sie --voice nur weg, wenn keiner eine nennt. Wenn der Benutzer in diesem Durchlauf explizit eine Stimme ausgewählt hat, zeichnen Sie 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 <Stimmen-ID> &
Das Audio-Skript behandelt Erzählung, Wortzeitsteuerung, Hintergrundmusik-Suche aus der HeyGen-Musikbibliothek und Timing-Metadaten. Die Hintergrundmusik-Stimmung stammt aus dem music:-Feld des Storyboards. Dies verwendet die HeyGen Audio API für den Abruf, nicht für die Generierung, und dieselbe ~/.heygen-Anmeldeinformation wie TTS. Für Anbieterdetails lesen Sie ../media-use/audio/references/tts.md.
Wenn es keine Erzählung und kein SCRIPT.md gibt, überspringen Sie die Spracherzeugung. Hintergrundmusik kann trotzdem laufen, wenn das Storyboard eine Musikstimmung hat.
Der kanonische vollständig-stille Marker (gemeinsam über die Workflows, die dieses Audiomodell wiederverwenden): music: none im oberen YAML-Block von STORYBOARD.md und kein SCRIPT.md. Diese Kombination markiert das Projekt als still – keine Erzählung, keine Hintergrundmusik, keine Soundeffekte. audio.mjs erkennt es und generiert nichts (es entfernt ein veraltetes audio_meta.json; ein fehlendes audio_meta.json wird vom Zusammenbau als still behandelt), daher ist dieser Schritt ein sauberer Übersprung. music: none mit Erzählung behält TTS und schaltet nur Hintergrundmusik aus. Verwenden Sie genau diese Schreibweise – improvisieren Sie keine anderen Marker.
Tor: Audio-Job wurde gestartet, oder das Projekt ist als still markiert (music: none + kein SCRIPT.md).
Schritt 4: Visuelles Framedesign
Ziel: Die visuelle Ausrichtung, Layout-Absicht und Bewegungsauswahl zu jedem Storyboard-Frame hinzufügen.
Skizzieren Sie das Storyboard-Blatt...
[weitere Schritte hier fortgesetzt...]