Communitygithub.com

PR zu HyperFrames

Verwandle einen GitHub-Pull-Request (PR-URL wie github.com/<owner>/<repo>/pull/<N>, einen <owner>/<repo>#<N>-Ref oder 'diesen PR' in einem ausgecheckten Repository) in ein Erklärvideo für Codeänderungen von bis zu ca. 3 Minuten (ideal 30–90 Sekunden) — Changelog, Feature-Vorstellung, Fix- oder Refactoring-Walkthrough, erstellt aus dem Diff / den Commits / den Dateien. Die Eingabe ist eine CODEÄNDERUNG, die über die gh CLI gelesen wird; es gibt keine Website-Erfassung. Verwende diesen Skill für einen GitHub-PR. Verwende ihn nicht für eine Produkteinführung/Promo (verwende /product-launch-video), einen Rundgang durch eine echte Website (verwende /general-video), eine thematische Erklärung ohne PR (verwende /faceless-explainer), Untertitel auf vorhandenem Material (verwende /embedded-captions) oder eine kurze unkommentierte Bewegungsgrafik (verwende /motion-graphics). Falls die Absicht unklar ist, leite zuerst über /hyperframes weiter.

Was ist PR zu HyperFrames?

Dieser Skill ermöglicht die automatisierte Erstellung von Erklärvideos zu Codeänderungen, die direkt aus GitHub-Pull-Requests abgeleitet werden. Er ist ideal für Entwickler, die technische Änderungen wie Changelogs, Feature-Enthüllungen, Fehlerbehebungen oder Refactoring-Walkthroughs visuell und verständlich präsentieren möchten. Der Skill unterstützt den gesamten Workflow von der PR-Analyse über das Storyboard und Skript bis hin zur Generierung von HTML-Frames und dem finalen Video-Rendering. Er ist für Claude Code und andere KI-Agenten optimiert und nutzt die HyperFrames-Plattform zur Frame-Erstellung. Wichtig: Der Skill funktioniert ausschließlich mit Codeänderungen als Eingabe und erfasst keine echten Websites. Er bietet eine umfassende Struktur mit verschiedenen Schritten (Setup, PR-Import, Designsystem, Storyboard, Audio, visuelles Design, Frame-Erstellung und Rendering) und integriert Sicherheitsprüfungen (Gates) für jeden Schritt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EvovexAI/EvoFlow/tree/HEAD/skills/public/pr-to-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

media-use: Vor der Beschaffung von Audio/Quellmaterial rufe /media-use auf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führe zuerst --adopt aus, um vorhandene Assets zu registrieren. Siehe /media-use Skill.

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ößeEmpfohlene 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.html existiert
  • STORYBOARD.md hat jeden Frame als animated markiert

Gate für Schritt 6 vorhanden

  • ls renders/video.mp4

Fehlerbehebung

  1. gh nicht authentifiziert oder PR nicht gefunden: fetch-pr.mjs wird mit 1 beendet. Melde die stderr-Ausgabe und stoppe. Erfinde keine PR-Inhalte.
  2. ingest.mjs fehlgeschlagen: Normalerweise eine fehlerhafte pr.json. Lies stderr, behebe den Fehler und führe erneut aus.
  3. Asset-Registrierung fehlgeschlagen: Überprüfe, ob die Blueprint-ID einen Bindestrich verwendet (z.B. code-diff) und nicht zusammenhängend ist.
  4. Frame-Worker fehlgeschlagen: Überprüfe den Worker-Exit-Code und die Ausgabe; stelle sicher, dass ANIM_DIR aufgelöst wird.
  5. 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.

Individual skills in this repo

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

EvovexAI/EvoFlow

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

EvovexAI/EvoFlow

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

EvovexAI/EvoFlow

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

EvovexAI/EvoFlow

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

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`.

EvovexAI/EvoFlow

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

EvovexAI/EvoFlow

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

EvovexAI/EvoFlow

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

EvovexAI/EvoFlow

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (general-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

EvovexAI/EvoFlow

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

EvovexAI/EvoFlow

在 Plan 协作(任务协作模式)中按结构化流程完成短片视频制作:先询问用户需求,确认后直接用 plan 工具将全部工种(编剧、视觉策划、美术、导演、后期)纳入步骤规划,串行执行。

EvovexAI/EvoFlow

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

EvovexAI/EvoFlow

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

EvovexAI/EvoFlow

本地文字转语音,使用sherpa-onnx(离线,无需云端)。当需要离线语音合成时使用。

Verwandte Skills