Communitygithub.com

laviedezidane/hyperframes-skill

Verwandle einen GitHub-Pull-Request (PR-URL, owner/repo#N oder 'dieser PR' in einem ausgecheckten Repository) in ein Erklärvideo zur Code-Änderung – Changelog, Feature-Enthüllung, Fix oder Refaktorisierung, erstellt aus Diff, Commits und Dateien.

Was ist hyperframes-skill?

Diese Fähigkeit wandelt einen GitHub-Pull-Request in ein erklärendes Video um, das die Code-Änderung erläutert. Sie ist für Entwickler und KI-Agenten gedacht, die Code-Reviews in visuelle Zusammenfassungen oder Tutorials umwandeln möchten. Der Skill arbeitet mit HyperFrames und unterstützt die Plattformen HeyGen und Kokoro für Sprachausgabe, Musik und Soundeffekte. Der gesamte Workflow ist in Schritte unterteilt: Einrichtung (Schritt 0), Aufnahme der PR-Daten (Schritt 1), Design-System (Schritt 2), Storyboard/Text (Schritt 3), Audio (Schritt 3.1), visuelles Design (Schritt 4), Frame-Erstellung (Schritt 5) und finaler Render (Schritt 6). Der Benutzer muss die PR-Referenz angeben, und der Skill erstellt automatisch ein Projektverzeichnis, lädt die PR-Daten mit `gh`, generiert eine Code-Editorial-Vorlage und erstellt ein Storyboard. Die Überprüfung der Benutzereingabe erfolgt in den Schritten 0, 3 und 6.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/pr-to-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Plugin-Installation: Vor der Einrichtung oder Aktualisierung folgen Sie den Plugin-Ausführungsregeln, wenn dieser Skill in einem HyperFrames-Plugin enthalten ist. Eigenständige Installationen behalten die folgenden Update-Anweisungen bei.

Halten Sie diesen Skill zunächst frisch – bestätigen Sie mit dem Benutzer vor der Ausführung: npx hyperframes skills update pr-to-video. Ein schneller No-Op, wenn alles aktuell ist; ansonsten aktualisiert es diesen Skill sowie die Kern-Skills, von denen er abhängt, bevor Sie sie verwenden.

media-use: Bevor Sie Audio/Bilder/Logos beziehen, rufen Sie /media-use auf, um BGM/SFX/Bilder aus dem HeyGen-Katalog und Markenlogos aus offiziellen Quellen zu beziehen. Führen Sie zuerst --adopt aus, um vorhandene Assets zu registrieren. Siehe /media-use Skill. Wenn die Host-App eigene Musik- oder Soundeffekt-Tools bereitstellt, verwenden Sie diese für Musik und Soundeffekte.

PR zu HyperFrames

Verwenden Sie diesen Skill, um einen GitHub-Pull-Request zu erfassen, die Änderung zu verstehen, einen Erklärplan zu erstellen und diesen Frame für Frame in HyperFrames aufzubauen. Die Eingabe ist eine Code-Änderung (gelesen über gh), keine Website – es gibt keinen Erfassungsschritt und keine echten Assets außer den Avataren der Beitragenden.

Die Eingangstür ist /hyperframes. Sie sind der Orchestrator. Führen Sie jeden Schritt aus, überprüfen Sie dessen Tor, und fahren Sie nur dann fort. Dieser Skill ist für einen GitHub-Pull-Request (eine Code-Änderung). Jede andere Absicht, ein bloßes „Video erstellen“ oder Unsicherheit → lesen Sie zuerst /hyperframes – die Intentionsebene besitzt alle Routenentscheidungen, und eine neue Erstellung, die hier ohne BRIEF.md ankommt, durchläuft sie trotzdem (Eröffnungsregel der Einrichtung).

Sie sind der Orchestrator. Arbeiten Sie im aufgelösten externen PROJECT_DIR, niemals standardmäßig im Aufrufer-Repository. Führen Sie die Schritte in Reihenfolge aus und bestehen 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 flow/storyboard in BRIEF.md den Modus ableiten, der die Tore der Schritte 3/4/6 bestimmt. Führen Sie jeden Schritt selbst aus, außer Schritt 5, wo Sie einen begrenzten Pool von Frame-Arbeitern entsenden. Fügen Sie hier keine Design- oder Bewegungsregeln ein; diese leben im Frame-Worker-Sub-Agenten, in den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ und hyperframes-creative dieses Skills.

Workflow: Schritt 0 Einrichtung → 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 Finaler Render → renders/video.mp4.


Schritt 0: Einrichtung

Ziel: Mit einem bestätigten Brief einsteigen – einschließlich der PR-Referenz (eine vollständige URL, eine <owner>/<repo>#<N>-Referenz oder „dieser PR“ in einem ausgecheckten Repository) – das HyperFrames-Projekt erstellen und den Brief dauerhaft machen. Der Stil ist immer Code-redaktionell (festgelegt in Schritt 2, nie gefragt).

Der Brief wird von der Intentionsebene bestätigt, nicht durch hier gestellte Fragen. Öffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lesen und nichts fragen – der Brief ist festgelegt, und sein flow/storyboard leiten den Modus ab (Briefvertrag § 1). (2) Kein BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf Disk) → fortsetzen vom Frontmatter des Storyboards und den aufgezeichneten Präferenzen; ein halbfertiges Projekt nie erneut befragen. (3) Weder – eine frische Erstellungsanfrage, die direkt hier angekommen ist → /hyperframes lesen und dessen Intentionsebene (references/intent-interview.md) ausführen: es überprüft Rezepte und gespeicherte Standardwerte und führt die Fragen dieser Route durch – einschließlich der PR-Größe → 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 dies vollständig – gehen Sie zur Bearbeitung.

Lösen Sie das Projektverzeichnis auf, bevor Sie andere Arbeiten ausführen. Bewahren Sie ein vom Benutzer bereitgestelltes Projektverzeichnis; verwenden Sie andernfalls den dauerhaften externen Cachespeicherort, den der Auflöser ausgibt. Erstellen Sie niemals videos/ im Aufrufer-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-Projekt: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs

Die Fähigkeitsvorprüfung läuft vor dem Abrufen, der Story-Arbeit, dem Audio oder der Frame-Verteilung. Wenn die installierte CLI den für diesen Skill erforderlichen Validierungsbefehl nicht ausführen kann, stoppen Sie mit der Upgrade-Anweisung, anstatt den Kontext dieser Ausführung zuerst zu verbrauchen.

Nur initialisieren, wenn $PROJECT_DIR/hyperframes.json fehlt. Sein Basisname stammt von der PR, z. B. acme-sdk-pr-1842; niemals den Arbeitsbereichsnamen oder einen Zeitstempel verwenden.

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

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

Schreiben Sie BRIEF.md sofort nach der Initialisierung (niemals davor – init lehnt ein nicht leeres Verzeichnis ab): den gesperrten Brief der Intentionsebene, Form gemäß ../hyperframes/references/brief-format.md. Lösen Sie <MEDIA_DIR> als das installierte /media-use Skill-Verzeichnis auf. Zeichnen Sie dann jede präferenzgesicherte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md nennt die Teilmenge). Wenn die Intentionsebene 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 Skelettentwürfe zurück, die Schritt 3 erstellt. Ein Rezept füllt Antworten, keine Genehmigungen; die Überprüfungstore laufen trotzdem.

Zeigen Sie den Anmeldestatus an, bevor Sie die Einrichtung verlassen – führen Sie npx hyperframes auth status aus und geben Sie seine Ausgabe wörtlich weiter. Es meldet, ob Sprach/BGM 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 / go wählt.
  • Autonom: Teilen Sie den Status mit und fahren Sie über die verfügbaren lokalen Engines fort.

Übergehen Sie nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter existiert; machen Sie den Blockierer sichtbar. Falten Sie diese Entscheidung nicht in eine andere Frage oder schreiben Sie Schlüssel in ein Pro-Repo .env. Auth-Eigentum und Offline-Fallback: /media-use references/setup-providers.md § Anbieter.

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


Schritt 1: Erfassen des PR (keine Aufnahme)

Ziel: Die Fakten des PR abrufen und als Informationsquelle in das Projekt einbinden. Es gibt keine Website-Aufnahme. fetch-pr.mjs führt gh deterministisch aus – vervollständigt die Dateiliste über paginierte gh api, damit ein großer PR nicht bei ~100 Dateien abgeschnitten wird, und schreibt nur capture/pr.json + capture/diff.patch (kein Scratch-Verzeichnis). Bei MERGED-PRs wird auch eine Best-Effort-shipped_version (+ version_source) in pr.json aufgelöst, damit die Endkarte eine echte Version zitieren kann, anstatt eine zu erfinden. Dann faltet ingest.mjs dies offline in das synthetische Erfassungspaket.

PR="<url | owner/repo#N | N>"

# 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 Exit 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 der Personenfront – lade den GitHub-Avatar jedes Beitragenden herunter zu
# assets/<login>.png für den Credits-Abspann. Best-Effort; immer Exit 0.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
  --people ./capture/extracted/people.json)

Wenn fetch-pr.mjs mit Exit 1 beendet (gh auth / not found / private), melden Sie seinen stderr und stoppen Sie – fälschen Sie keine PR-Inhalte. Wenn ingest.mjs mit Exit 1 beendet, lesen Sie seinen stderr (normalerweise eine fehlerhafte pr.json), beheben Sie es und führen Sie es erneut aus (deterministisch). fetch-people-avatars.mjs endet immer mit Exit 0; fehlende Avatare bedeuten nur keinen Credits-Abspann zum Autor.

people.json führt einen name für die Beitragenden, die gh bereits benannt hat (PR-Autor, Commit-Autoren, mergedBy) – null für den Rest (Reviewer/Kommentatoren/Zugewiesene, die gh pr view nur als bloßen login liefert). Bevor Sie den Credits-Abspann in Schritt 3 schreiben, lösen Sie selbst null-Namen für die 1-6 Personen auf, die tatsächlich auf diesem Frame erscheinen: gh api users/<login> --jq .name (Sie haben bereits gh – kein Skript erforderlich). Wenn GitHub auch keinen öffentlichen Namen für diesen Benutzer hat, fallen Sie auf den Login auf dem Bildschirm zurück und lassen Sie diese Person aus der gesprochenen Zeile fallen (siehe story-design.md Abschnitt Credits – 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; Sie können die Änderung des PR in einem klaren Satz angeben. assets/<login>.png ist Best-Effort – seine Abwesenheit ist kein Fehler.


Schritt 2: Designsystem

Ziel: Die Code-editorial-Frame-Voreinstellung übernehmen; ein Skript wandelt sie in das frame.md + Caption-Skin dieses Videos um.

Der Stil ist festgelegt – Code-editorial (warm redaktionell; eine marineblaue Code-Oberfläche für Diffs gebaut). Führen Sie aus:

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

Das Skript kopiert die FRAME.md der Code-editorial-Voreinstellung → frame.md, vermischt sie mit etwaigen Markentoken in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält die eigene Palette der Code-editorial-Einstellung, ein vollständiges Design), kopiert das Caption-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (Exit 1 bei einer fehlerhaften Zuordnung). Fahren Sie fort, sobald es mit Exit 0 beendet – keine manuelle Bearbeitung.

Tor: build-frame.mjs wurde mit Exit 0 beendet – frame.md existiert von der Code-editorial-Voreinstellung, 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ärplan verwandeln.

Lesen Sie ../hyperframes-creative/references/story-spine.md (Hooks-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag, quellennachvollziehbare Visuals), 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 das Frontmatter duration: aus der length des Briefes – eine grobe Erwartung; der Zusammenbau berichtet, wo der Schnitt dagegen landet.

Verwenden Sie story-design.md für den PR-Archetyp (Changelog / Feature-Enthüllung / Fix-Erklärung / Refaktorisierungs-Walkthrough), die PR-nativen Frame-Typen, Hook, persuasion, Beats, das Pro-Frame-Wortbudget und den Credits-Abspann. Die Reihenfolge kommt aus dem narrativen Design, nicht der Dateireihenfolge des Diffs – erklären Sie die Änderung, lesen Sie das Diff nicht laut vor. Als weiche Richtlinie konsultieren Sie die Rollen→Blueprint-Menü in ../hyperframes-animation/blueprints-index.md: Schreiben Sie für jeden Beat den Voiceover in der Form, die sein Kandidat-Blueprint impliziert, und taggen Sie diesen Kandidaten mit blueprint: id, wenn einer passt (die Story-Wahrheit entscheidet dennoch, welche Beats existieren – erzwingen Sie niemals einen Beat, um in eine Form zu passen). Zeigen Sie 2–4 echte Diff-Hunks (aus capture/diff.patch), jedes ein kleines lesbares Snippet; nennen Sie den code-*-Block, den jeder im scene des Frames möchte. Frames tragen keine asset_candidates außer dem credits-Abspann (1–6 assets/<login>.png-Avatare). Verwenden Sie die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.

Nach dem Entwurf führen Sie den Plan-Durchlauf der Überprüfungsschleife – ../hyperframes/references/review-loop.md § 1: präsentieren Sie den Plan als Vorschlag und stellen Sie die zwei Fragen – genehmigen oder ändern, und Skizzen zuerst (empfohlen) oder überspringen. Feedback kommt als Chat-Antwort; wiederholen Sie die Schleife bis zur Genehmigung. Dies ist ein Kontrollpunkt-Tor (Briefvertrag § 1): im autonomen Modus gibt es nichts zu fragen – posten Sie dieselbe Zusammenfassung als Vorabinformation und fahren Sie fort; Skizzen werden in den Bau integriert, 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 Plan genehmigt (autonom: die Zusammenfassung wurde als Vorabinformation gepostet).


Schritt 3.1: Audio

Ziel: Erzählung, Wort-Zeitsteuerung, 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.

Wählen Sie die Erzählstimme aus der Anfrage des Benutzers vor dem Aufruf. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Tonfall 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 – eine Anfrage wie „eine männliche Stimme“ wird also stillschweigend ignoriert, es sei denn, Sie übergeben das Flag. Stimmen-IDs sind anbieterspezifisch; lösen Sie sie gegen den Anbieter auf, den der Anmeldestatus von Schritt 0 ausgewählt hat: HeyGen (angemeldet) über node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (oder GET /v3/voices?engine=starfish); Kokoro (offline) über die Stimmentabelle in <MEDIA_DIR>/audio/references/tts.md (Präfixe am_/bm_ männlich, af_/bf_ weiblich). Wenn

Individual skills in this repo

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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, history, clean, 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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and 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`.

laviedezidane/hyperframes-skill

Agent Media OS for 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. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

Verwandte Skills