Communitygithub.com

1999AZZAR/designer-mcp

Verwandle einen GitHub-Pull-Request (eine PR-URL, owner/repo#N oder „diesen PR“ in einem ausgecheckten Repository) in ein Erklärvideo zu Code-Änderungen – mit Changelog, Feature-Enthüllung, Fix- oder Refaktorisierungs-Walkthrough, erstellt aus dem Diff, den Commits und den Dateien. Die Eingabe ist eine Code-Änderung, keine Website.

Was ist designer-mcp?

Dieses Skill für Claude Code (MCP) wandelt einen GitHub-Pull-Request in ein professionelles Erklärvideo um, das den Zweck und die Details der Code-Änderung visuell aufbereitet. Es analysiert den PR über die GitHub-CLI (`gh`), extrahiert das Diff, die Commits und die beteiligten Personen und erstellt daraus ein Storyboard, ein Skript, Sprachausgabe und animierte Frames im Stil eines Code-Editors („code-editorial“). Der Schwerpunkt liegt auf der narrativen Erklärung der Änderung, nicht auf dem einfachen Ablesen des Diffs. Es eignet sich für PRs, die einen Changelog-Eintrag, eine Feature-Enthüllung, eine Fix-Erklärung oder eine Refaktorisierungs-Erläuterung darstellen. Das Skill ist vollständig in eine lokale HyperFrames-Umgebung integriert und arbeitet in einem externen Projektverzeichnis, um das Repository des Aufrufers nicht zu beeinträchtigen. Es umfasst Schritte wie Setup, PR-Import, Design-System-Erstellung, Storyboard- und Skripterstellung, Audiogenerierung (mit Optionen für HeyGen oder lokale TTS-Engines), Framebau und finale Videorendering. Das Skill erwartet, dass der Anwender das HyperFrames-CLI installiert hat und gegebenenfalls mit HeyGen authentifiziert ist. Es bietet explizite Prüfpunkte in den Schritten 0, 3 und 6 für Benutzerfeedback.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video/engine/pr-to-video

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

First, keep this skill fresh — confirm with the user before running: npx hyperframes skills update pr-to-video. Ein schneller No-Op, wenn alles aktuell ist; andernfalls wird dieses Skill zusammen mit den Kern-Domain-Skills aktualisiert, bevor du dich auf sie verlässt.

media-use: Bevor du Audio/Bilder/Logos beschaffst, rufe /media-use auf, um BGM/SFX/Bilder aus dem HeyGen-Katalog und Markenlogos von ihren offiziellen Quellen zu beziehen. Führe zuerst --adopt aus, um vorhandene Assets zu registrieren. Siehe /media-use-Skill.

PR zu HyperFrames

Verwende dieses Skill, um einen GitHub-Pull-Request zu erfassen, die Änderung zu verstehen, ein Erklärvideo für Code-Änderungen zu planen und es Frame für Frame in HyperFrames zu erstellen. Die Eingabe ist eine Code-Änderung (gelesen über gh), keine Website – es gibt keinen Capture-Schritt und keine echten Assets außer den Avataren der Beitragenden.

Die Eingangstür ist /hyperframes. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Tor und fahre erst dann fort. Dieses Skill ist für einen GitHub-Pull-Request (eine Code-Änderung). Bei jeder anderen Absicht, einem einfachen „ein Video erstellen“ oder bei Unsicherheit → lies zuerst /hyperframes – die Intentionsebene besitzt jede Routenentscheidung, und eine frische Erstellung, die hier ohne BRIEF.md ankommt, durchläuft sie trotzdem (Eröffnungsregel von Setup).

Du bist der Orchestrator. Arbeite im aufgelösten externen PROJECT_DIR, niemals standardmäßig im aufrufenden Repository. Führe die Schritte der Reihe nach aus und passiere jedes Tor, bevor du fortfährst. Vom Benutzer gesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Lese ../hyperframes/references/brief-contract.md vor Schritt 0 – es definiert die Tortypen und wie der flow/storyboard in BRIEF.md den Modus ableiten, der die Tore von Schritt 3/4/6 bestimmt. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen begrenzten Pool von Frame-Workern entsendest. Lege keine Design- oder Bewegungsregeln hier fest; diese leben im Frame-Worker-Unteragenten, den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ und hyperframes-creative.

Workflow: Schritt 0 Setup → hyperframes.json; Schritt 1 Erfassen → 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 → angereicherte 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 Brief starten – einschließlich der PR-Referenz (eine vollständige URL, eine <owner>/<repo>#<N>-Referenz oder „diesen PR“ in einem ausgecheckten Repository) – das HyperFrames-Projekt erstellen und den Brief dauerhaft machen. Der Stil ist immer code-editorial (in Schritt 2 festgelegt, niemals abgefragt).

Der Brief wird von der Intentionsebene bestätigt, nicht durch hier gestellte Fragen. Eröffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lese sie 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 mit dem Frontmatter des Storyboards und den aufgezeichneten Einstellungen fort; befrage ein halbfertiges Projekt nie erneut. (3) Weder noch – eine frische Erstellungsanfrage, die direkt hier ankommt → lese /hyperframes und führe seine Intentionsebene aus (references/intent-interview.md): sie überprüft Rezepte und gespeicherte Standardeinstellungen und führt die Fragen dieser Route durch – einschließlich der PR-Größe-zu-Längen-Doktrin, die vollständig in ../hyperframes/references/routes/pr-to-video.md lebt – und gibt dann den gesperrten Brief zurück. Bearbeitungsanfragen überspringen das alles – gehe hin und bearbeite.

Löse das Projektverzeichnis auf, bevor du andere Arbeiten erledigst. Behalte ein vom Benutzer angegebenes Projektverzeichnis bei; verwende andernfalls den dauerhaften externen Cache-Speicherort, der vom Resolver ausgegeben wird. Erstelle niemals videos/ im aufrufenden Repository:

PR="<url | owner/repo#N>"
if [ -n "${EXPLICIT_PROJECT_DIR:-}" ]; then
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR" --project-dir "$EXPLICIT_PROJECT_DIR")"
else
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR")"
fi
echo "PR-to-video project: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs

Der Capability-Preflight wird vor dem Fetch, der Story-Arbeit, dem Audio oder dem Frame-Dispatch ausgeführt. Wenn die installierte CLI den von diesem Skill benötigten Validierungsbefehl nicht ausführen kann, stoppe mit der Upgrade-Anleitung, anstatt zuerst den Kontext des Laufs zu verbrauchen.

Initialisiere nur, wenn $PROJECT_DIR/hyperframes.json fehlt. Sein Basisname leitet sich vom PR ab, z. B. acme-sdk-pr-1842; verwende niemals den Workspace-Namen oder einen Zeitstempel.

npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video – init überprüft die installierten Skills mit den neuesten auf GitHub und aktualisiert die globale Menge, wenn welche veraltet sind.

Jeder relative Pfadbefehl unten wird mit $PROJECT_DIR als Arbeitsverzeichnis ausgeführt. Beispiele ohne explizite Subshell bedeuten (cd "$PROJECT_DIR" && …); ändere niemals den Arbeitsbaum des aufrufenden Repositorys.

Schreibe BRIEF.md sofort nach dem init (niemals davor – init verweigert ein nicht leeres Verzeichnis): den gesperrten Brief der Intentionsebene, 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 benennt die Teilmenge). Wenn die Intentionsebene 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 Gerüste zurück, aus denen Schritt 3-Entwürfe erstellt werden. Ein Rezept füllt Antworten, nicht Genehmigungen; die Überprüfungstore 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 die Stimme/BGM HeyGen oder lokale Engines verwendet und, wenn abgemeldet, wie man sich anmelden kann. Wende einen Zweig an:

  • Kollaborativ: warte, bis sich der Benutzer anmeldet oder explizit offline / go wä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-Repositorium .env. Auth-Eigentum und Offline-Fallbacks: /media-use references/setup-providers.md § Providers.

Tor: hyperframes.json und BRIEF.md existieren; die PR-Referenz ist im Brief erfasst; die präferenzgestützten Antworten wurden aufgezeichnet (Briefvertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet oder offline fortfahrend).


Schritt 1: PR erfassen (kein Capture)

Ziel: Die Fakten des PRs abrufen und als Informationsquelle in das Projekt einfließen lassen. Es gibt keinen Website-Capture. 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). Für ZUSAMMENGEFÜHRTE PRs löst es auch eine bestmögliche shipped_version (+ version_source) in pr.json auf, sodass die Endkarte eine echte Version anstelle einer erfundenen zitieren kann. Dann faltet ingest.mjs dies offline in das synthetische Capture-Paket.

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 "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)

# Offline-Transformation → capture/extracted/{tokens.json (colors:[] → code-editorial-Palette),
# visible-text.txt (der Brief), people.json (Beitragende, Bot-gefiltert, name+login,
# avatarFile=assets/<login>.png)}.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
  --pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)

# Der eine Netzwerkschritt für die Personen – lade den GitHub-Avatar jedes Beitragenden herunter nach
# assets/<login>.png für den Credits-Abspann. Best-Effort; immer mit 0 beendet.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
  --people ./capture/extracted/people.json)

Wenn fetch-pr.mjs mit 1 beendet wird (gh auth / not found / private), melde seinen stderr und stoppe – erfinde keine PR-Inhalte. Wenn ingest.mjs mit 1 beendet wird, lies seinen stderr (normalerweise ein fehlerhaftes pr.json), korrigiere und führe erneut aus (deterministisch). fetch-people-avatars.mjs wird immer mit 0 beendet; fehlende Avatare bedeuten nur, dass es keinen Credits-Abspann für den Autor gibt.

people.json enthält einen name für die Beitragenden, die gh bereits benannt hat (der PR-Autor, Commit-Autoren, mergedBy) – null für den Rest (Reviewer/Kommentatoren/Assignees, die gh pr view nur als bloßen login liefert). Bevor du den Credits-Abspann in Schritt 3 schreibst, löse für die 1–6 Personen, die tatsächlich auf diesem Frame erscheinen werden, selbst einen null-Namen auf: gh api users/<login> --jq .name (du hast bereits gh – kein Skript nötig). Wenn GitHub auch für diesen Benutzer keinen öffentlichen Namen hat, falle auf den Login auf dem Bildschirm zurück und entferne diese Person aus der gesprochenen Zeile (siehe den Credits-Abschnitt in story-design.md – der Voiceover muss dennoch Namen sagen, niemals rohe Handles).

Tor: 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: Das Code-Editorial-Frame-Preset übernehmen; ein Skript wandelt es in das frame.md + Caption-Skin dieses Videos um.

Der Stil ist festgelegt – code-editorial (warm editorial; eine marineblaue Code-Oberfläche, die für Diffs gebaut ist). Führe aus:

node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .

Das Skript kopiert das FRAME.md des code-editorial-Presets → frame.md, mischt es mit allen Markentoken in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält die eigene Palette des code-editorial, ein vollständiges Design), kopiert das Caption-Skin des Presets nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit 1 bei einer defekten Zuordnung). Fahre fort, sobald es mit 0 beendet wird – keine manuelle Bearbeitung.

Tor: build-frame.mjs wurde mit 0 beendet – frame.md existiert vom code-editorial-Preset, und .hyperframes/caption-skin.html existiert als Caption-Skin-Quelle.


Schritt 3: Storyboard und Skript

Ziel: Den PR in einen genehmigten Frame-für-Frame-Erklärungsplan umwandeln.

Lese ../hyperframes-creative/references/story-spine.md (Hook-Sprache, 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 Assembly meldet, wo der Schnitt im Vergleich dazu landet.

Verwende story-design.md für den PR-Archetyp (Changelog / Feature-Enthüllung / Fix-Erklärung / Refaktorisierungs-Walkthrough), die PR-nativen Frametypen, Hook, Überzeugung, Beats, das Wortbudget pro Frame und den Credits-Abspann. Die Reihenfolge ergibt sich aus dem narrativen Design, nicht aus der Dateireihenfolge des Diffs – erkläre die Änderung, lies das Diff nicht vor. Als weiche Richtlinie konsultiere das Rollen→Blaupausen-Menü in ../hyperframes-animation/blueprints-index.md: schreibe für jeden Beat den Voiceover in der Form, die seine Kandidaten-Blaupause impliziert, und tagge diese Kandidaten-ID mit blueprint:, wenn eine passt (die Story-Wahrheit entscheidet immer noch, welche Beats existieren – erzwinge niemals einen Beat, um in eine Form zu passen). Zeige 2–4 echte Diff-Hunks (aus capture/diff.patch), jedes ein kleines lesbares Snippet; nenne den code-*-Block, den jeder in der scene des Frames haben soll. Frames tragen keine asset_candidates außer dem credits-Abschluss (1–6 assets/<login>.png-Avatare). 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 Skizzen zuerst (empfohlen) oder überspringen. Feedback kommt als Chat-Antwort; Schleife, bis genehmigt. Dies ist ein Checkpoint-Tor (Briefvertrag § 1): im autonomen Modus gibt es nichts zu fragen – poste dieselbe Zusammenfassung als Hinweis und fahre fort; Skizzen fallen in den Build, und die eine Vorschaufrage kommt bei 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 Plan genehmigt (autonom: die Zusammenfassung wurde als Hinweis gepostet).


Schritt 3.1: Audio

Ziel: Erzählung, Wortzeitsteuerungen, Musik und Audio-Metadaten aus dem genehmigten Skript generieren.

Starte das Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus und fahre dann mit Schritt 4 fort.

Wähle die Erzählstimme basierend auf der Anfrage des Benutzers aus, bevor du sie aufrufst. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Ton genannt hat, wähle eine passende Stimm-ID und übergebe sie mit --voice <id>. Die Standard-Pipeline ist ansonsten Marcia (weiblich) auf HeyGen / am_michael auf Kokoro – daher wird eine Anfrage wie „eine männliche Stimme“ stillschweigend ignoriert, es sei denn, du übergibst das Flag. Stimm-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 Stimm-Tabelle 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-Standardeinstellung greift, und sage, welche du verwendet hast; lasse --voice nur weg, wenn keiner eine nennt. Wenn der Benutzer in diesem Lauf 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 . --voice <voice-id> – führt TTS offline (oder über das HeyGen-API, wenn angemeldet), berechnet Wortzeitsteuerungen aus der erzeugten Audiodauer, wählt BGM basierend auf dem Stil und der Stimmung des Storyboards aus (über die anbietereigene Quelle des ausgewählten Anbieters: BGM aus dem Medien-Katalog von HeyGen vs. lokalem Bibliotheks-Mapping in <MEDIA_DIR>/audio/references/bgm.md) und schreibt audio_meta.json (hyperframes/references/audio-meta-format.md). Das Skript gibt den EE-Plan des Audios aus; lies ihn vor dem Start von Schritt 4.

Tor: audio_meta.json existiert und enthält das EE-Array des Audios (die stimmliche Aktionsgruppe und die BGM-Spur). Animationsentscheidungen, die von Stimme oder Takt getrieben werden, sind in Schritt 4 anerkannt und an die Frame-Worker weitergegeben. Der BGM-Titel ist aufgezeichnet.


Schritt 4: Visuelles Design

Ziel: Das Storyboard mit konkreten visuellen Entscheidungen anreichern.

Beginne das visuelle Design im Hintergrund, während Schritt 3.1 läuft, oder direkt, wenn das Audio abgeschlossen ist. Das Audio ist die kritische Bahn; das visuelle Design kann gleichzeitig mit der Audio-Generierung laufen. Lies die Design-Referenzen – ../hyperframes-animation/rules/code-motion.md, ../hyperframes-animation/rules/diff-highlighting.md, ../hyperframes-animation/rules/transition-beats.md, ../hyperframes-animation/references/tag-language.md und ../hyperframes-creative/references/visual-style.md – um jeden storyboard_frame mit visuellen Anweisungen zu versehen. Verwende die genauen Tag-Namen aus der visuellen Referenz. Kein Frame trägt asset_candidates außer dem Abspann (schon in Schritt 3).

Die angereicherte STORYBOARD.md überschreibt die vorherige. Der Frame-Build in Schritt 5 erwartet diese angereicherte Version.

Kein Tor – gehe direkt zu Schritt 5 über.


Schritt 5: Frames erstellen

Ziel: Jeden Frame als unabhängige HTML-Datei erstellen.

Dies ist der einzige Schritt, den du nicht selbst ausführst – entsende einen Pool von Frame-Workern. Der Frame-Worker ist ein Sub-Agent, der das Modell als Code-/Design-Assistenten nutzt. Er kennt den Stil des Projekts (frame.md, .hyperframes/caption-skin.html) und seine Animationsregeln, aber nicht den gesamten PR oder das Storyboard. Du teilst die Frames auf basierend auf der Gesamtanzahl der Frames für den Render. Jeder Worker erhält eine einzelne Anweisung mit:

  • Der angereicherten STORYBOARD.md (nur sein Rahmenbereich)
  • frame.md und .hyperframes/caption-skin.html
  • Dem Pfad zu seinem Ausgabeverzeichnis innerhalb des HyperFrames-Projekts
  • capture/diff.patch (nur die Hunks, die sein Frame benötigt)
  • Den Dateien aus capture/extracted/

Erwartetes Ergebnis: compositions/frames/NN-some-frame.html für jeden Frame (NN = zweistellige Nummer). Stelle sicher, dass compositions/index.html existiert; es orchestriert die zusammenhängende Wiedergabe. Erstelle compositions/ nach Bedarf.

Standard-Pool-Größe: 5. Verwende ab diesem Projekt einen Wert wie --workers=5. Du darfst 0 verwenden (kein Multitasking; serialisierte Reihenfolge), wenn die PR klein ist und die Kosten das primäre Anliegen sind. Erhöhe auf 10 bei PRs mit 12+ geschriebenen Frames (breite Änderungen, die narrative Diversität erfordern). Überschreite niemals 10, es sei denn, das Setup hat batch=true in den Präferenzen gesetzt (void: erwarte dann den Wert direkt). Passe --workers in Schritt 0 an, wenn eine Änderung vorgenommen wird (dann als Präferenz aufgezeichnet).

Frame-Worker werden vom Aufrufer des Skills orchestriert (du erstellst ihre Eingabe, entsendest sie, sammelst ihr Ergebnis). Stelle abgeschlossene Frames sofort in das HyperFrames-Projekt. Erstelle Frame N in der Reihenfolge vor Frame N+1, um eine reibungslose Übergabe an den Renderer zu gewährleisten.

Tor: Jede compositions/frames/NN-*.html-Datei existiert – kein leerer Frame. compositions/index.html existiert. Du hast bestätigt, dass jeder Frame aus dem Markup gerendert werden kann (führe eine verfügbare Kompilierung aus, wie npx hyperframes render html-test …).


Schritt 6: Finaler Render

Ziel: Die Frames in ein einzelnes, abspielbares Video rendern.

Tor-Typ: Genehmigungstor (Schritt 3 des Briefvertrags) – präsentiere das Video zur Genehmigung. Dies überschreibt alle vorherigen Tore. Du musst die Genehmigung des Benutzers einholen, bevor du renderst.

Der Render verwendet die lokale Rendering-Engine von HyperFrames oder die Cloud-basierte, je nachdem, was verfügbar ist. Zeige die Render-Fortschrittsmeldungen und die endgültige Ausgabe.

Nach dem Render wird das Video automatisch in renders/video.mp4 abgelegt. Die genaue Dauer wird nun in STORYBOARD.md aufgezeichnet.

Abschlussnachricht: Sage dem Benutzer, wo sich das Video befindet ($PROJECT_DIR/renders/video.mp4), seine Dauer und eine kurze Beschreibung des Inhalts.

cd "$PROJECT_DIR"
npx hyperframes render --input-dir ./compositions \
  --output-dir ./renders \
  --frame-md ./frame.md \
  --caption-skin ./.hyperframes/caption-skin.html \
  --audio-meta ./audio_meta.json

Tor: Der Benutzer hat das endgültige Video genehmigt. Wenn nicht, führe die Überarbeitungsschleife gemäß ../hyperframes/references/review-loop.md § 2 (Änderungen) aus.


Schritt 7: Bereinigung (optional)

Wenn der Benutzer nach Abschluss und Genehmigung explizit um eine Bereinigung bittet, lösche temporäre Build-Artefakte, wobei hyperframes.json, BRIEF.md, STORYBOARD.md, SCRIPT.md, audio_meta.json, renders/video.mp4 und assets/<login>.png erhalten bleiben (der eingefrorene Render ist die endgültige Ausgabe; der Bauplan könnte sich als nützlich für die Wiederverwendung erweisen).

node <SKILL_DIR>/scripts/cleanup.mjs --hyperframes "$PROJECT_DIR" – entfernt compositions/, capture/ (nicht capture/extracted/ oder capture/pr.json) zwischengespeicherte TTS-Audio-Chunks (audio/chunks/) und zwischengespeicherte BGM-Downloads (music/). Die Datei frame.md wird beibehalten, falls der Benutzer den Bauplan später überarbeiten möchte.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

1999AZZAR/designer-mcp

SOTA animation and physics heuristic guide using motion.dev

1999AZZAR/designer-mcp

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

1999AZZAR/designer-mcp

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

1999AZZAR/designer-mcp

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

1999AZZAR/designer-mcp

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

1999AZZAR/designer-mcp

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

1999AZZAR/designer-mcp

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

1999AZZAR/designer-mcp

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1999AZZAR/designer-mcp

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1999AZZAR/designer-mcp

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

1999AZZAR/designer-mcp

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1999AZZAR/designer-mcp

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

1999AZZAR/designer-mcp

Use when building or editing a HyperFrames project that people open in Studio: how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

1999AZZAR/designer-mcp

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

1999AZZAR/designer-mcp

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

1999AZZAR/designer-mcp

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

1999AZZAR/designer-mcp

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Verwandte Skills