Communitygithub.com

1345AbhishekKumar/starter-supabase

Füge einem Talking-Head-Video Untertitel hinzu. Ein Katalog (CATALOG.md) mit 32 visuellen Identitäten, gestützt auf zwei Engines: Column-Flow (Untertitel IN die Szene komponiert – Matte-Occlusion + Mix-Blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) und thematische Verfassungen (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 – z. B. ein Glyphen-Dekodierungs-Höhepunkt, ein Neon-Schild, das Strich für Strich GESCHRIEBEN wird, oder die ruhige `anchor`-Rail als Standard). Routen nach Identität, nie nach Modus. Auslöser: „captions/subtitles“, „embed/cinematic captions“, „VFX captions“, „炸/特效/酷炫字幕“, ein benannter Identitätsname oder Anfragen auf Top-Level-Motion-Design-Niveau. Jedes Wort einzubetten ist für die meisten Talking-Head-Inhalte falsch – `anchor` ist der wortgetreue Standard. Pipeline: Transkription → Hyperframes Remove-Background-Matting → HTML-Rendering → ffmpeg-Overlay. Erfordert Hyperframes und ein Clip mit einer einzelnen Person.

Was ist starter-supabase?

Diese Fähigkeit für KI-Agenten (kompatibel mit Claude Code, Cursor, Codex und ähnlichen Plattformen) erstellt automatisch Untertitel für Talking-Head-Videos, die je nach gewünschtem Stil von einfachen, sauberen Textbalken bis hin zu aufwändigen, kinoreifen Motion-Design-Layouts reichen. Anstatt den Benutzer zwischen allgemeinen Modi wie „Standard“ oder „Kinomodus“ wählen zu lassen, basiert die Fähigkeit auf einem Katalog mit 32 visuellen Identitäten (z. B. anchor, terminal, neonsign), die jeweils einen festgelegten visuellen Stil, eine Kompilierungs-Engine und ein Designmuster definieren. Der Workflow ist stark automatisiert: Nachdem der Agent eine Identität basierend auf dem Videoinhalt und den Benutzerwünschen ausgewählt hat, führt er einen deterministischen, mehrstufigen Pipeline-Prozess aus, der Transkription, Freistellung des Hintergrunds (Matting), HTML-Rendering der Untertitel und ffmpeg-Overlay umfasst. Die Fähigkeit verwendet ein ausgeklügeltes Untertitelmodell, das zwischen Drop (Füllwörtern, die nicht angezeigt werden), Rail (wortgetreuer unterer Bildschirmbalken für den Großteil des Textes) und Embed (ein oder wenige hervorgehobene Schlüsselwörter, die HINTER der Person in die Szene eingebettet werden) unterscheidet. Dies verhindert den häufigen Fehler, jedes Wort einzubetten, und sorgt stattdessen dafür, dass visuelle Höhepunkte sparsam und wirkungsvoll eingesetzt werden. Der gesamte Prozess ist auf Geschwindigkeit optimiert: Er bietet eine visuelle Vorschau mit etwa 2 Sekunden pro Frame, bevor ein aufwändigerer endgültiger Render gestartet wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/embedded-captions

In Ihrer bevorzugten KI fragen

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

Dokumentation

Eingebettete Untertitel (Embedded Captions)

Ein Katalog, vorab ausgewählt (CATALOG.md – 17 Identitäten; die drei dahinterliegenden Engines sind Backend-Details). Standard (Standard) erstellt eine saubere, wortgetreue Rail (einen unteren Bilddrittel-Untertitel, der den Großteil des Textes trägt) + einen Embed-Höhepunkt, der am Höhepunkt in die Szene hinter der Person komponiert wird. Cinematic (Kino) ist reines Embed – keine Rail, jeder Untertitel wird hinter der Person komponiert (heroische Typografie, Akkumulation, Verdeckung als Effekt). Theme (Thema) ist eine vollständige thematische Verfassung – Körperparadigma × heroisches Bühnenbild × vordere Effekte × Plattenreaktion, zusammengesetzt aus Registern (themes/README.md): ordnance terminal neonsign stardust stomp anchor. Die meisten Erklär- / Voiceover-Videos verwenden Standard; Embed ist der seltene, verdiente Höhepunkt – jedes Wort einzubetten ist der häufige Fehler; Theme ist für VFX-Anfragen gedacht („炸“, „特效“, „cool wie in AE“).


Ablauf (Kurzfassung)

Der handwerkliche Text unten ist lang; die Pipeline selbst ist kurz – und alles, was deterministisch ist, wird berechnet oder kompiliert, niemals von Hand geschrieben:

  1. Entscheidungsgate (schlechte Clips ablehnen) → eine Identität aus CATALOG.md auswählen (17 Identitäten; Engine/Kompilierer per Nachschlagewerk bestimmt – niemals eine Mode/Kategorie-Frage stellen)
  2. hyperframes init (überspringen, wenn das Projektverzeichnis mit dem Video bereits existiert – matte.cjs/transcribe.cjs übernehmen jedes Video im Verzeichnis als source.mp4) → bash scripts/prepare.sh <project> (matte ∥ transcribe ∥ audio-envelope parallel, dann safe-zones v2 mit Szenenpalette/Optik/Beleuchtung – ein Befehl, nichts vergessen)
  3. ein kleines JSON mit kreativen Entscheidungen erstellen (zuerst safe-zones.json lesen): Cinematic → plan.json → fill-timings.cjs → fit-fonts.cjs → make-composition.cjs; Theme → theme.json → make-theme.cjs (Rail/Panel/Poem/Takeover-Paradigmen; anchor ist die ruhige Rail-Voreinstellung)
  4. Visuelle Qualitätskontrolle: node scripts/preview-frames.cjs <project> → originalgetue Vorschaubilder in ~2s/Frame (kein Render). § Visuelle Qualitätskontrolle prüfen, bevor man für einen Render bezahlt.
  5. render-and-composite.sh → Gates (Timing / Occlusion+Hero / Überlauf / Übergabe) → final.mp4

Wichtige Regeln, die oft übersehen werden:

  • Rail (Standard) + Embed (Beförderung). drop (Füllmaterial, wird nicht gezeigt) / rail (wortgetreuer unterer Bilddrittel-Untertitel, im Vordergrund, trägt den meisten Text) / embed (ein Höhepunkt-Wort, das hinter der Person eingebettet wird). Der Standard-Modus macht beides und bettet nur den/die Höhepunkte ein. Siehe § Untertitel-Modell.
  • Das Video wird UNBERÜHRT ausgeliefert (Standard/Cinematic; das PLATE-Budget des Theme-Modus ist die einzig erlaubte Ausnahme – registrierte Reaktionsbewegungen (Ladungsabdunklung, Stoß, Erschütterung, Körnung), die pro Themen-DNA definiert und NACH der Matte-Komposition angewendet werden, sodass Person+Text+Platte sich als ein Bild bewegen) – Untertitel sind das Einzige, was hinzugefügt wird; die Matte lässt die Person lediglich die eingebettete Spur verdecken. Niemals das Filmmaterial abtönen/nachfärben/abtasten.
  • Zwei Regelwerke: Rail → references/rail.md (dünn), Embed-Handwerk → references/composition-craft.md (umfangreich, nur Embed). Nach Bedarf überfliegen.

Untertitel-Modell – Rail + Embed

Jede gesprochene Phrase ist eines von drei Dingen:

WasWie es dargestellt wird
dropFüllmaterial – ähm/öhm, Stottern, Selbstkorrekturenwird nicht gezeigt
railder Standard – gewöhnlicher gesprochener Inhalt (wörtlich)sauberer unterer Bilddrittel-Untertitel, im Vordergrund, lesbar. Ein betontes Wort kann eine emphasis-Hervorhebung erhalten (Akzentfarbe / aktives Wort-Hervorhebung) – es bleibt auf der Rail.
embedein beförderter Höhepunkt – der wichtigste Satzteilein großes Wort, das hinter der Person eingebettet wird (Matte-Occlusion), gestalteter Ein- und Ausgang

Die Rail trägt den Großteil des Textes; Embed ist der seltene, verdiente Höhepunkt. Knappheit bezieht sich auf jede Phrase/jeden Block, nicht auf den gesamten Clip: ≤1 Held pro Block (Gedanke), niemals zwei gleichzeitig sichtbar, mindestens ein Schlag Luft zwischen Heldenfenstern (der Compiler warnt unter 0,6 s). Ein kurzer Clip → normalerweise 1–2; ein langes Erklärvideo → ~einer pro Abschnitt. Bei mehreren Helden ist der größte erstellte der APEX (nur er erhält das volle Lockup-Embed + Breitenanpassung); kleinere sind MINOR-Helden, die in ihrer Spalte als überdimensionierte Betonungszeilen fahren (Vordergrund, gedämpfte Bewegung) – nicht jeder Schlag braucht die Matte-Präsentation, und genau das macht den Apex zu einem Ereignis. Jedes Wort einzubetten ist immer noch der häufige Fehler.

Rail-Oberflächenidentitäten bauen genau das (Rail = rail.html, Embed = der Höhepunkt in index.html). Column-Flow-Identitäten entfernen die Rail und gestalten alles im Embed-Stil – empfehle sie nur für Stimmungs-/nicht-wortgetreue Anfragen, niemals für Erklär-/Voiceover-Videos, in denen die Worte lesbar sein müssen (CATALOG.md codiert dies pro Identität).


Schritt 0 – eine Identität aus dem KATALOG auswählen

Ein Frontend, drei Engines dahinter. Der Benutzer wählt eine IDENTITÄT aus CATALOG.md (17 Einträge: 12 klassische + 5 thematische); die Engine, der Compiler und die Autorendatei werden durch Nachschlagen in der Katalogzeile abgeleitet. Stelle niemals „Standard vs. Cinematic vs. Theme“ als Frage – das sind Backend-Namen (ein Produkt hat eine Benutzererfahrung, selbst mit mehreren Engines). Der Katalog codiert alles, was das Routing benötigt: Leseoberfläche, Stimme, Empfehlungsgrund, Szenenanforderungen, Angrenzungshinweise für die wirklich nahen Paare (loud↔ordnance, neon↔neonsign, cream↔stardust).

Vorgehensweise: Clip untersuchen → 2–3 Identitäten aus dem Katalog in die engere Wahl nehmen → eine Identität mit einer einzeiligen Begründung EMPFEHLEN → der Benutzer wählt aus → die Datei dieser Identität erstellen. Identitäten sind engine-gebunden (keine Querkombinationen; das Öffnen einer ist ein Validierungsereignis – siehe dna/README.md).

Präsentiere immer deine Empfehlung und lass den Benutzer wählen, bevor du die Datei erstellst. Nicht stillschweigend auf die Voreinstellung zurückfallen.

(Die vollständige Identitätstabelle befindet sich in CATALOG.md – die einzige Quelle der Wahrheit für das Routing. Die Engine-Dokumente unten beschreiben den Autorenvertrag jeder Backend-Engine.)

Empfehlungsheuristik: Verwende die „Kurzlisten-Heuristiken“ in CATALOG.md – sie sind identitätsbezogen (z. B. „炸“ wählt ordnance/stomp/terminal/loud in die engere Auswahl und wählt basierend darauf, WAS explodieren soll), niemals kategoriebezogen. Unsicher → anchor.

  • Cinematic → plan.json für eine feste Vorlage schreiben, kompiliert von make-composition.cjs.
  • Theme → themes/README.md lesen, theme.json erstellen, scripts/render-theme.sh ausführen (kompiliert + rendert + Plattenreaktion → final_fx.mp4).

Entscheidungsgate – ZUERST AUSFÜHREN

Das Video untersuchen und die Szene vor jedem Modus klassifizieren.

ffprobe <video.mp4>                    # Spezifikationen
ffmpeg -ss <t> -i <video.mp4> -vframes 1 sample.png   # bei 20/50/80%

Die Proben lesen. Ablehnen, wenn:

  • Mehrere Sprecher / harte Schnitte (jede Einstellung einzeln rendern oder ablehnen)
  • Kein menschliches Subjekt (diese Fähigkeit ist für Talking-Head-Videos)
  • Unter 3 Sekunden, keine Sprache, oder das Gesicht ist nie klar sichtbar – transcribe.cjs warnt, wenn Audio nahezu still ist (Whisper halluziniert Wörter wie „Thank you.“ über Stille); dies beachten und ablehnen, anstatt erfundene Wörter zu untertiteln
  • Quelle hat bereits eingebrannte Untertitel / schwere Textgrafiken – das Hinzufügen eines zweiten Untertitelsystems verursacht Konflikte, und das Filmmaterial wird unberührt ausgeliefert (kein Überdecken/Nachmalen). Eingebrannter Text erscheint oft erst mittendrin im Clip: ein 1fps-Kontaktabzug (ffmpeg -i in.mp4 -vf "fps=1,scale=160:-1,tile=10x5" sheet.png) als Stichprobe nehmen, sich nicht auf 3 einzelnen Frame-Proben verlassen.
  • Transkription ist Schrott – nicht-muttersprachliche/stark akzentbelastete Sprache kann in selbstbewussten Unsinn transkribiert werden. transcript.json vor dem Erstellen auf Lesbarkeit prüfen; wenn es sich nicht wie eine Sprache anhört, einmal WHISPER_MODEL=medium versuchen, sonst ablehnen (ein wortgetreue Balken mit erfundenen Wörtern ist schlimmer als gar keine Untertitel).
  • Hektische Handkamera mit schneller Bewegung (Matte flackert)

Preflight-Prüfungen (kosten nichts, verhindern die schlimmsten Fehler)

  1. Einstellungs-Schnitt-Prüfung. Rahmenproben bei 20%, 50%, 80% nehmen. Wenn ein anderes Subjekt/Szene erscheint, den Clip vor dem Schnitt zuschneiden.
  2. Letterbox / Pillarbox-Prüfung. Schwarze Balken im ersten Frame? Rechteckigen, sicheren Inhaltsbereich berechnen und die Untertitelplatzierung darauf beschränken.
  3. Luminanz-Prüfung. Die durchschnittliche Luminanz des Untertitelbereichs messen – unter 60 → heller Text wird gelesen wie er ist, 60-180 → den Glyphen-Schleier hinzufügen, 180+ → deckender Text + Schleier (niemals nackten, hellen Text). Kinematografische Vorlagen sind cream+screen und GESPERRT – diese Prüfung verwenden, um eine passende Identität auszuwählen (helle Szenen → ink, oder die anchor-Themen-Rail mit deckendem Text), niemals um eine einzufärben.
  4. Identitätsempfehlung nach Ton (du empfiehlst; der Benutzer wählt – siehe Schritt 0 + CATALOG.md). Erklärvideo / Interview / Worte müssen lesbar sein → Rail/Panel-Oberflächenidentitäten; poetisch / sozial / „kinoreif“ → Column-Flow-Identitäten nach Register; „炸 / 特效 / VFX“ / benannte Welten → thematische Identitäten. Unsicher → anchor (Worte lesbar, Szene sicher) – aber eine Kurzliste präsentieren und den Benutzer wählen lassen.

Pipeline – 5 Schritte

1. hyperframes init <project> --non-interactive --video <video.mp4>
2. bash scripts/prepare.sh <project>       # matte ∥ transcribe (parallel) → safe-zones. Ein Befehl.
                                           #   → frames_fg/ transcript.json safe-zones.json
3. [AGENT-SCHRITT – der einzige kreative Schritt] ein kleines JSON erstellen; siehe unten nach Modus
   Cinematic: plan.json erstellen → node scripts/fill-timings.cjs → fit-fonts.cjs → make-composition.cjs
   Theme:     theme.json erstellen → bash scripts/render-theme.sh <project>   (kompiliert + rendert + Platten-FX)
4. node scripts/preview-frames.cjs <project>   # ~2s/Frame Composite-Vorschauen → § Visuelle Qualitätskontrolle (VOR dem Render)
5. bash scripts/render-and-composite.sh <project>  # Gates → final.mp4 + history/ snapshot
   (Theme-Modus: Schritte 3b/5 ÜBERSPRINGEN – render-theme.sh führt bereits compile + render-and-composite
    + _postfx.sh aus; das Ergebnis ist final_fx.mp4, final.mp4 ist vor der Plattenreaktion)

Das init in Schritt 1 prüft die installierten Fähigkeiten gegen die neuesten auf GitHub und aktualisiert den globalen Satz, wenn welche veraltet sind.

Schritt 3 unterscheidet sich je nach Modus:

Schritt 3 – Cinematic-Modus (reines Embed)

  1. Zuerst safe-zones.json lesen. Erzählebenen kommen in zones.hugLeft/hugRight – saubere Streifen, die an die SILHOUETTE angrenzen (Text fern vom Körper wirkt schwebend, nicht eingebettet; ferne Ecken sind die Notlösung, nicht die Standardeinstellung). Der Held verwendet standardmäßig heroAnchor/heroBands.best (zentriert AUF dem Subjekt, ~30–55% verdeckt). recommendation:"fg" verschiebt die ERZÄHLUNG in den Vordergrund für Lesbarkeit; der Held bleibt eingebettet, wann immer heroBands.feasible – Held im Vordergrund ist die letzte Option.
  2. Die DNA ist die Identität, die du in Schritt 0 ausgewählt hast (CATALOG.md) – diese Wahl hier nicht erneut öffnen. Prüfe sie gegen die Szene (helle Heldenband-Luma > 150 will ink; vollständige Auswahlhilfe findest du im Katalog, der alle zehn inkl. neon / glitch / chrome / velocity abdeckt). Gib deine Wahl + Begründung an; der Benutzer entscheidet. Die DNA sperrt Typ/Palette/Mischung/Bewegung + Helden-Dreialt; safe-zones v2 (palette/optics/lighting) parametrisiert sie automatisch für DIESE Szene.
  3. <project>/cinematic.json erstellen – "dna": "<name>" + Gedanken-BLÖCKE, nicht rohe Gruppen: jeder Block = Wortzeilen (gruppiert 2–5 an Satzgrenzen) + die Ebene, in der er gestapelt wird + pro-Zeile css (nur Größe/Gewicht/Stil – keine Positionen) + höchstens EINE Zeile mit "hero": true (das beförderte Wort; "text" für die Anzeigeform). Schema: scripts/make-cinematic.cjs Kopfzeile.
  4. Kompilieren: node scripts/make-cinematic.cjs <project> – senkt Blöcke → plan.json → index.html. Für dich generiert: transkriptionssequenzierte Zeitsteuerungen, Akkumulieren innerhalb des Blocks, Seitenwechsel zwischen Blöcken, das HELDEN-LOCKUP (ein Heldenblock-Vorkontext, HELD und Nachkontext stapeln sich als EINE verbundene Komposition, zentriert auf dem Subjekt – Lesereihenfolge oben→unten = Sprechreihenfolge durch Konstruktion; Kontext schwebt im VORDERGRUND, während der Held im HINTERGRUND eingebettet ist = das Tiefensandwich; eine Massenregel hält den Helden dominant über seinen Kontext), APEX/Minor-Held-Aufteilung, Lesereihenfolge durch Konstruktion, Vordergrund-Notlösung pro safe-zones. Dann laufen die Gates wie gewohnt. (Das direkte Erstellen von plan.json bleibt für Designs möglich, die Blöcke nicht ausdrücken können – dann fill-timings.cjs + fit-fonts.cjs + make-composition.cjs selbst ausführen.)

Schritt 3 – Theme-Modus (thematische Verfassung)

Zuerst themes/README.md lesen – Paradigmen-/Setpiece-Register, Verknüpfungen, harte Regeln und das genaue theme.json-Schema.

  1. Eine Themen-DNA nach Inhaltsregister auswählen (jedes themes/<name>.json hat voice + when). Gib deine Wahl + Begründung an; der Benutzer entscheidet.
  2. <project>/theme.json erstellen – dna, lines (wörtlich, Transkriptionsreihenfolge; 1–5 Wörter pro Zeile – für takeover ist jede Zeile eine KARTE), minors (Betonungswörter), hero:{match} (das Höhepunkt-Wort/der Höhepunkt-Satz; für Embed-Setpieces aus lines HERAUSLASSEN, für Inline-Setpieces und panel+redact DRIN LASSEN).
  3. Rendern: bash scripts/render-theme.sh <project> – kompiliert (Worttreue-Gate zur Kompilierungszeit), rendert beide Ebenen, erstellt Composite, wendet die Plattenreaktion an → final_fx.mp4. Verwende preview-frames.cjs zwischen Kompilierung und Render für die visuelle Qualitätskontrolle.

Visuelle Qualitätskontrolle – Vorschau VOR dem Rendern

node scripts/preview-frames.cjs <project> [t…] erstellt originalgetreue Vorschaubilder in ~2s pro Stück (Untertitelebenen zum Suchzeitpunkt gescreenshotet + echtes Videobild + Matte-Occlusion + Rail-Overlay = wie das endgültige Composite zu diesem Zeitpunkt aussehen wird). Standardproben = jede Gruppe/jedes Höhepunktfenster. Ein vollständiger Render dauert Minuten – verwende ihn niemals, um Layout-Probleme zu entdecken.

Überprüfe die Vorschauen (<project>/preview/sheet.png) gegen folgende Kriterien:

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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

1345AbhishekKumar/starter-supabase

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 (website-to-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.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Verwandte Skills