media-use: Vor der Beschaffung von Audio/Quellmaterial rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill.
Was macht PR zu HyperFrames?
Verwende diesen Skill, um einen GitHub-Pull-Request zu erfassen, die Änderung zu verstehen, einen Codeänderungs-Erklärer zu planen und ihn Frame für Frame in HyperFrames zu erstellen. Die Eingabe ist eine Codeänderung (gelesen über gh), keine Website – es gibt keinen Erfassungsschritt und keine echten Assets außer den Avataren der Mitwirkenden.
Bestätige den Pfad vor Schritt 0. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Gate und fahre erst dann fort. Dieser Skill ist für einen GitHub-Pull-Request (eine Codeänderung). Leite andere Absichten anderweitig weiter: eine Produkteinführung/Promo →
/product-launch-video; ein allgemeiner Website-Rundgang →/general-video; eine thematische Erklärung ohne PR →/faceless-explainer; Untertitel auf vorhandenem Material →/embedded-captions; eine kurze unkommentierte Bewegungsgrafik →/motion-graphics; ein Walkthrough zu einem gesamten Repository oder mehreren PRs →/general-video. Nicht im Umfang: Live-/Renderzeit-Daten – PR-Fakten werden einmalig zum Zeitpunkt der Erstellung gelesen und fest eingebaut. Wenn der Benutzer nur "mach ein Video" sagt oder der Pfad unsicher ist, lies zuerst/hyperframes.
Du bist der Orchestrator. Arbeite in videos/<project>/. Führe die Schritte in der Reihenfolge aus und passe jedes Gate bevor du fortfährst. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Führe jeden Schritt selbst aus, außer Schritt 5, bei dem du einen Unter-Agenten pro Frame entsendest. Platziere hier keine Design- oder Bewegungsregeln; diese leben im Frame-Worker-Unter-Agenten, hyperframes-creative und hyperframes-animation.
Workflow: Schritt 0 Setup → hyperframes.json; Schritt 1 Erfassung → capture/extracted/ + assets/<login>.png; 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 Rendering → renders/video.mp4.
Schritt 0: Setup und Briefing
Ziel: Den PR-Referenz und das Kern-Video-Briefing festlegen und das HyperFrames-Projekt erstellen, falls nötig.
Hole die PR-Referenz (eine vollständige URL, einen <owner>/<repo>#<N>-Ref oder "diesen PR" in einem ausgecheckten Repository) und bestätige in einer Nachricht das Briefing – zeige für jedes Feld eine empfohlene Standardeinstellung an und fülle alles vor, was /hyperframes bereits gesetzt hat: Winkel (Changelog / Feature-Enthüllung / Fehlerbehebungs-Erklärer / Refactoring-Walkthrough – Standard: aus dem PR ableiten), Zielgruppe (Standard: Entwickler), Länge (Standard: an die Änderungsgröße des PRs anpassen – siehe unten), Seitenverhältnis (Standard 16:9), Sprache. Der Stil ist immer claude. Fahre erst fort, nachdem der Benutzer geantwortet hat; ein "los" akzeptiert die Standardeinstellungen.
Empfehle die Länge basierend auf der Änderungsgröße des PRs, nicht auf einer festen Schätzung. Bevor du das Briefing bestätigst, wirf einen lesenden Blick auf den PR – ein schreibgeschützter Aufruf, der auch den Winkel untermauert (Schritt 1 führt immer noch den vollständigen deterministischen Abruf durch):
gh pr view <PR_REF> --json title,additions,deletions,changedFiles
Wähle die Stufe aus additions + deletions (nach oben korrigiert durch changedFiles) und präsentiere sie als Standard (der Benutzer kann überschreiben; harte Obergrenze ca. 3 Minuten):
| PR-Änderungsgröße | Empfohlene Länge |
|---|---|
| trivial (≲ 50 Zeilen geändert) | ~20–40s |
| fokussiert (~50–200 Zeilen) | ~40–70s |
| umfangreich (~200–600 Zeilen) | ~70–110s |
| groß (≳ 600 Zeilen, oder 25+ Dateien) | ~110–180s |
Gib die Grundlage in einem Satz an, wenn du sie vorschlägst (z.B. "~40s – kleine Änderung, +44/−13 in 12 Dateien"). Ein riesiger PR bedeutet nicht zwangsläufig ein langes Video – wenn die Geschichte eine einzige Hauptänderung ist, halte es knapp und sage dies.
Initialisiere nur, wenn hyperframes.json fehlt. Benenne <project> aus dem PR in Kebab-Schreibweise, z.B. acme-sdk-pr-1842; verwende niemals den Arbeitsbereichsnamen oder einen Zeitstempel.
npx hyperframes init "videos/<project>" --non-interactive --example=blank – init überprüft die installierten Skills mit den neuesten auf GitHub und aktualisiert den globalen Satz, falls welche veraltet sind.
Zeige den Anmeldestatus vor dem Briefing an – führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es meldet, ob Sprach-/BGM-Audio die HeyGen- oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPP und warte auf die Wahl des Benutzers – anmelden, oder "los"/"offline" sagen, um mit lokalen Engines fortzufahren – bevor du nach dem Briefing oder irgendetwas anderem fragst. Behandle es als echten Entscheidungspunkt, nicht als beiläufige Notiz; falte die Wahl nicht in die Briefing-Frage ein und schreibe keine Schlüssel in eine .env-Datei pro Repository. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Gate: hyperframes.json existiert; die PR-Referenz ist erfasst; Winkel, Länge, Seitenverhältnis und Sprache sind festgelegt; der Anmeldestatus wurde angezeigt (angemeldet, oder Fortsetzung offline).
Schritt 1: PR erfassen (kein Capture)
Ziel: Die Fakten des PRs abrufen und sie als Informationsquelle in das Projekt einbinden. Es gibt keine Website-Erfassung. fetch-pr.mjs führt gh deterministisch aus – vervollständigt die Dateiliste über paginierte gh api, sodass ein großer PR nicht bei ~100 Dateien abgeschnitten wird, und schreibt nur capture/pr.json + capture/diff.patch (kein Scratch-Verzeichnis). Dann fügt ingest.mjs das offline in das synthetische Capture-Paket ein.
PR="<url | owner/repo#N | N>"
# Den PR deterministisch abrufen: führt gh aus, vervollständigt die Dateiliste über paginierte
# gh api (damit ein großer PR nicht bei ~100 Dateien abgeschnitten wird), schreibt nur capture/pr.json +
# capture/diff.patch – kein Scratch-Verzeichnis. gh auth / not-found / private-Fehler beenden mit 1 hier.
(cd "videos/<project>" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# Offline-Transformation → capture/extracted/{tokens.json (colors:[] → claude palette),
# visible-text.txt (das Briefing), people.json (Mitwirkende, bot-gefiltert, avatarFile=assets/<login>.png)}.
(cd "videos/<project>" && node <SKILL_DIR>/scripts/ingest.mjs \
--pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)
# Der eine Netzwerkschritt des People-Frontends – lade den GitHub-Avatar jedes Mitwirkenden nach
# assets/<login>.png herunter für einen optionalen Credits-Abspann. Best-Effort; beendet immer mit 0.
(cd "videos/<project>" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
Wenn fetch-pr.mjs mit 1 beendet wird (gh auth / nicht gefunden / privat), melde seinen stderr und stoppe – erfinde keine PR-Inhalte. Wenn ingest.mjs mit 1 beendet wird, lies seinen stderr (normalerweise eine fehlerhafte pr.json), behebe und führe erneut aus (deterministisch). fetch-people-avatars.mjs beendet immer mit 0; fehlende Avatare bedeuten nur keinen Credits-Abspann für den Autor.
Gate: capture/pr.json, capture/diff.patch, capture/extracted/tokens.json, capture/extracted/visible-text.txt und capture/extracted/people.json existieren; du kannst die Änderung des PRs in einem klaren Satz angeben. assets/<login>.png ist Best-Effort – sein Fehlen ist kein Fehler.
Schritt 2: Designsystem
Ziel: Die claude Frame-Voreinstellung übernehmen; ein Skript verwandelt sie in frame.md + Untertitel-Skin dieses Videos.
Der Stil ist festgelegt – claude (warm-redaktionell; eine marineblaue Code-Oberfläche, gebaut für Diffs). Führe aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset claude --hyperframes .
Das Skript kopiert die claude-Voreinstellung FRAME.md → frame.md, remixt sie mit allen Marken-Token in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält claudes eigene Palette, ein vollständiges Design), kopiert den Untertitel-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit 1 bei einer defekten Zuordnung). Fahre fort, sobald es mit 0 beendet wurde – keine manuelle Bearbeitung.
Gate: build-frame.mjs wurde mit 0 beendet – frame.md existiert aus der claude-Voreinstellung, und .hyperframes/caption-skin.html existiert als Quelle des Untertitel-Skins.
Schritt 3: Storyboard und Skript
Ziel: Den PR in einen genehmigten Frame-für-Frame-Erklärungsplan umwandeln.
Lies references/story-design.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.
Verwende story-design.md für den PR-Architekturtyp (Changelog / Feature-Enthüllung / Fehlerbehebungs-Erklärer / Refactoring-Walkthrough), die PR-nativen Frame-Typen, Hook, Überzeugung, Beats, das Wortbudget pro Frame und den optionalen Credits-Abspann. Die Reihenfolge ergibt sich aus dem narrativen Design, nicht der Dateireihenfolge des Diffs – erkläre die Änderung, lies das Diff nicht vor. Zeige 2–4 echte Diff-Hunks (aus capture/diff.patch), jedes ein kleines lesbares Snippet; benenne den code-*-Block, den jedes in der scene des Frames haben soll. Frames tragen keine asset_candidates außer einem optionalen credits-Abspann (2–6 assets/<login>.png Avatare). Verwende die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.
Nach dem Entwurf zeige eine Frame-für-Frame-Zusammenfassung. Frage in derselben Nachricht den Benutzer (a) nach Genehmigung oder Änderungswünschen und (b), ob er eine Live-Vorschau des Storyboard-Gerüsts wünscht (npx hyperframes preview) – öffne es nur bei einem Ja. Iteriere bis zur Genehmigung; nimm die Vorschauentscheidung zu Schritt 6 mit.
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 Plan genehmigt.
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.
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 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 für die Generierung, und dieselbe ~/.heygen-Anmeldeinformation wie TTS. Für Details zum Anbieter lies ../hyperframes-media/references/tts.md.
Wenn keine Erzählung und kein SCRIPT.md vorhanden ist, überspringe die Sprachgenerierung. BGM kann trotzdem laufen, wenn das Storyboard eine Musikstimmung hat.
Gate: Audio-Job wurde gestartet, oder das Projekt ist als stumm markiert.
Schritt 4: Visuelles Frame-Design
Ziel: Die visuelle Richtung, Layout-Absicht und Bewegungsoptionen zu jedem Storyboard-Frame hinzufügen.
Bearbeite STORYBOARD.md direkt. Erstelle kein weiteres Storyboard. Verwende frame.md als Quelle der Wahrheit für Farbe, Typografie, Layout-Gefühl und Stil.
Lies references/visual-design.md, references/composition.md, references/motion-language.md, references/code-vocabulary.md und ../hyperframes-animation/. Verwende visual-design.md für die erforderlichen Frame-Felder und den erforderlichen ## Video direction-Block und dafür, wie ein Code-Beat einen code-*-Block als seinen focal benennt. Verwende code-vocabulary.md, um den richtigen Block pro Beat auszuwählen (diff = code-diff, refactor = code-morph, neuer Code = code-typing, …). Verwende composition.md für Layout/Hierarchie/Brennpunkte und motion-language.md + ../hyperframes-animation/ für gültige Effekt- und Blueprint-IDs. Erfinde keine Effektnamen oder Block-/Blueprint-IDs.
Füge für jeden Frame die erforderlichen visuellen und Bewegungsfelder hinzu, einschließlich effects und focal und/oder roles. Für einen Code-Beat benenne den code-*-Block als den focal und lasse effects die umgebende claude Code-Oberfläche choreografieren (nicht die Code-Animation, die der Block besitzt). Füge einen videoweiten ## Video direction-Block hinzu.
Ändere nicht die Geschichte, das Skript, transition_in, asset_candidates oder die PR-Quelle. Schreibe in diesem Schritt kein HTML. Es gibt keinen Asset-Staging-Schritt – die einzigen echten Assets sind die Credits-Avatare, bereits in assets/.
Gate: Jeder Frame hat effects plus focal und/oder roles; Code-Frames benennen einen code-*-Block; ## Video direction existiert.
Schritt 5: Frames erstellen
Ziel: Jeden Storyboard-Frame als HTML-Komposition erstellen und das abspielbare Video zusammenstellen.
Warte auf das Ende von Schritt 3.1 Audio, falls Audio gestartet wurde. Synchronisiere dann die Dauern und rufe SFX ab; ü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 .
Die Dauernsynchronisation ist mechanisch: die echte Sprachdauer gewinnt; stille Frames behalten Schätzungen; bearbeite synchronisierte Dauern niemals manuell.
Installiere vorab die Registrierungsblöcke, die in STORYBOARD.md genannt werden, einmal vor dem Versand, damit parallele Worker nicht um die Registrierung konkurrieren:
for b in <jeder im Storyboard genannte Registrierungsblock>; do npx hyperframes add "$b"; done
Lies vor dem Versand sub-agents/frame-worker.md und ../hyperframes-core/references/subagent-dispatch.md. Entsende einen Unter-Agenten pro Frame, wenn möglich parallel; andernfalls führe Worker in Wellen aus. Jeder Worker bekommt genau einen Frame. Der Kontext jedes Workers muss PROJECT_DIR, frame_id, Leinwandgröße, Untertitel-Status und Keep-Out-Bereich enthalten, wenn Untertitel aktiviert sind, ANIM_DIR (absoluter Pfad zu ../hyperframes-animation/) und den absoluten Pfad zu references/code-vocabulary.md. Jeder Worker liest frame.md, seinen eigenen ## Frame N-Block, den Rezepttext für jede zitierte Effekt-/Blueprint-ID und – für einen Code-Beat – code-vocabulary.md für die Eingaben des benannten Blocks. Jeder Worker schreibt nur compositions/frames/NN-*.html; Worker bearbeiten niemals STORYBOARD.md.
Sobald ein Worker zurückkommt, markiere diesen Frame als animated in STORYBOARD.md.
Nachdem Audio-Zeitsteuerungen existieren, erstelle Untertitel im Hintergrund und stelle den Index zusammen:
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 die .hyperframes/caption-skin.html des Projekts (claude, kopiert in Schritt 2) und injiziert Marken-Token aus frame.md; captions: skipped (<reason>) ist gültig (stumm, keine SCRIPT.md, worker err …). Ermittle den Grund und fahre fort.
assemble-index.mjs erstellt index.html durch Einlesen aller compositions/frames/NN-*.html, Anwendung von frame.md + STORYBOARD.md für die Sequenz und Verknüpfung mit hyperframes-player; siehe ../hyperframes-core/references/index-assembly.md.
Gate: index.html existiert, referenziert jeden Frame einmal in der richtigen Reihenfolge, jedes NN.html ist gültig (kein Parse-Fehler, alle verwendeten Blueprints sind installiert), caption_groups.json existiert beim ersten Frame mit Aktivierung (oder Grund zum Überspringen ist dokumentiert), STORYBOARD.md hat jeden Frame als animated markiert.
Schritt 6: Rendern und Abschluss
Ziel: Das Video rendern und die Ausgabe mit dem Benutzer teilen.
Wenn der Benutzer in Schritt 3 eine Vorschau wollte, starte die Vorschau jetzt neu, damit sie die fertigen Frames anzeigt, und warte auf einen endgültigen Render-Befehl:
npx hyperframes preview – mit offenem Link und den Worten "Frames sind fertig. Sag mir, wann ich rendern soll."
Wenn keine Vorschau gewünscht wurde oder der Benutzer zum Rendern auffordert:
npx hyperframes render --out renders/video.mp4
Teile danach den Link zu renders/video.mp4 und frage den Benutzer, ob er glücklich ist oder ob er etwas ändern möchte (iteriere, beginnend mit dem Schritt, der die Änderung betrifft). Wenn der Benutzer Änderungen wünscht, markiere das Projekt als modified und wiederhole die betroffenen Schritte. Wenn es abgeschlossen ist, beende den Skill mit einer Zusammenfassung dessen, was erstellt wurde.
Gate: renders/video.mp4 existiert, der Benutzer hat die endgültige Ausgabe genehmigt; der Skill gibt eine Abschlusszusammenfassung aus.
Anhang: Gate-Überprüfungen
Gate für Schritt 0 vorhanden
cat videos/<project>/hyperframes.json && echo "PR ref: <PR_REF>"
Gate für Schritt 1 vorhanden
ls -1 videos/<project>/capture/pr.json videos/<project>/capture/diff.patch videos/<project>/capture/extracted/tokens.json videos/<project>/capture/extracted/visible-text.txt videos/<project>/capture/extracted/people.json
Bestehe, wenn alle fünf Dateien existieren. Bestehe auch, wenn die Avatare fehlen (Best-Effort).
Gate für Schritt 2 vorhanden
ls -1 videos/<project>/frame.md videos/<project>/.hyperframes/caption-skin.html
Gate für Schritt 3 vorhanden
(siehe ../hyperframes-core/references/storyboard-format.md)
Jeder Frameeintrag muss haben:
- frame (Zahl, 1-basiert)
- scene (Aufzählung: narrative Phase)
- duration (Sekunden mit zwei Dezimalstellen, z.B. 8.50)
- type (main / transition / credits)
- narration (Text der Erzählung für diesen Frame)
- music (Stimmungsbezeichner oder "")
- transition_in (Effektname oder "none")
- asset_candidates (Array von Asset-Pfaden; nur gültige Assets)
Wenn Skript benötigt wird, muss die SCRIPT.md-Struktur scene, visual_direction und narration enthalten.
Gate für Schritt 4 vorhanden
(siehe references/visual-design.md)
Jeder Frameeintrag muss haben:
- Alle Schritt-3-Felder
- effects (Array)
- focal (String)
- roles (Objekt, optional)
Ein ## Video direction-Block muss am Ende des Dokumentes vorhanden sein (einmalig).
Gate für Schritt 5 vorhanden
ls compositions/frames/*.html(Anzahl = Frame-Anzahl)- Jede Datei ist gültiges HTML (kein Parse-Fehler)
- Alle verwendeten Blueprint-IDs sind registriert
index.htmlexistiertSTORYBOARD.mdhat jeden Frame alsanimatedmarkiert
Gate für Schritt 6 vorhanden
ls renders/video.mp4
Fehlerbehebung
- gh nicht authentifiziert oder PR nicht gefunden:
fetch-pr.mjswird mit 1 beendet. Melde die stderr-Ausgabe und stoppe. Erfinde keine PR-Inhalte. - ingest.mjs fehlgeschlagen: Normalerweise eine fehlerhafte
pr.json. Lies stderr, behebe den Fehler und führe erneut aus. - Asset-Registrierung fehlgeschlagen: Überprüfe, ob die Blueprint-ID einen Bindestrich verwendet (z.B.
code-diff) und nicht zusammenhängend ist. - Frame-Worker fehlgeschlagen: Überprüfe den Worker-Exit-Code und die Ausgabe; stelle sicher, dass
ANIM_DIRaufgelöst wird. - Vorschau-URL funktioniert nicht: Stelle sicher, dass der Vorschau-Server noch läuft.
Dieser Skill ist Teil der HyperFrames-Familie. Siehe ../README.md für die Gesamtstruktur.