Communitygithub.com

1345AbhishekKumar/starter-supabase

Verwenden, wenn der Benutzer eine kurze, designorientierte Bewegungsgrafik wünscht, bei der die Bewegung die Botschaft ist: kinetische Typografie, Statistik- oder Zahlen-Hochzählung, Diagramm/Datenvisualisierungs-Hit, Logo-Sting, Brand-Lockup, Lower-Third, Callout, Social-Overlay, animierte Schlagzeile/Tweet/News-Item, Motion-Poster oder eine kurze hervorgehobene Seiten-Darstellung. Normalerweise unter 10 s und bis zu ~30 s, ohne Erzählbogen, Voice-Over oder Live-Action-Subjekt. Kann in MP4 oder als transparente Overlay-Datei gerendert werden. Nicht geeignet für längere, mehrteilige, erzählte oder Brand-Reel-Stücke (→ allgemeines Video), erzählte Website-Videos (Website-zu-Video), Themen-Erklärvideos (faceless-explainer), Produkt-Promos (product-launch-video), PR-Videos (pr-to-video) oder Untertitel auf vorhandenem Filmmaterial (embedded-captions). Bei Unsicherheit, ob es sich um ein schnelles, bewegungsorientiertes Stück oder eine längere/erzählte Behandlung handelt, siehe /hyperframes.

Was ist starter-supabase?

Diese Fähigkeit (Skill) ermöglicht die Erstellung kurzer, designgetriebener Bewegungsgrafiken, bei denen die Bewegung die Hauptbotschaft trägt. Sie eignet sich für Formate wie kinetische Typografie, Zahlen-Hochzählungen, Diagramm-/Datenvisualisierungen, Logo-Stings oder Social-Overlays. Die Ausgabe erfolgt als MP4 oder transparentes Overlay. Der Skill ist für Szenarien unter 10 s bis maximal ~30 s optimiert, ohne Voice-Over oder Live-Action, und verwendet einen Asset-zuerst-Ansatz: Zunächst wird die Asset-Strategie festgelegt, dann das Design um die verfügbaren Assets herum entwickelt und schließlich durch Wiederverwendung von Katalog-Komponenten umgesetzt. Der Workflow umfasst initiale Einrichtung, Planung, Asset-Quellen (nur bei Bedarf), Design, Build, Rendering und Verifikation. Die Fähigkeit unterstützt sowohl formularbasierte Kategorien (keine Suche, der Benutzer liefert den Inhalt) wie kinetische Typografie, Statistiken, Diagramme, Logo-Reveals und Lower-Thirds, als auch suchgetriebene Kategorien (Webseiten, Nachrichten, Tweets, Asset-Fusion), die zuerst eine Suche durchführen und dann den Inhalt animieren. Der Build-Prozess priorisiert die Wiederverwendung von Katalogblöcken über 'npx hyperframes add' und die Anwendung der Animationsregeln von 'hyperframes-animation', um Konsistenz und Effizienz zu gewährleisten. Der Skill ist für macOS Apple Silicon oder Linux x64 ausgelegt und benötigt Node.js, ffmpeg und eine initiale Ausführung von 'npx hyperframes doctor'.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

motion-graphics — Dispatch-Eintrag

Route vor Schritt 0 bestätigen. Dieser Skill erstellt eine kurze, designorientierte, unerzählte Bewegungsgrafik (Bewegung ist die Botschaft; ~unter 10 s, kein Voice-Over). Eine längere, mehrteilige oder erzählte Behandlung → /general-video; ein erzähltes Video einer Website → /website-to-video; ein Themen-Erklärvideo → /faceless-explainer; eine Produkt-Promo → /product-launch-video; Untertitel auf vorhandenem Filmmaterial → /embedded-captions. Außerhalb des Geltungsbereichs: Live-/Renderzeit-Daten oder Filmmaterial, das nicht erfasst werden kann. Unsicher, ob bewegungsorientiert oder erzählt? Zuerst /hyperframes lesen.

Eine kurze, designorientierte Bewegungsgrafik. Asset-zuerst: Entscheide die Asset-Strategie und beschaffe echtes Material, bevor du die Einstellung designst, gestalte dann die Einstellung um das Vorhandene herum und komponiere durch Wiederverwendung von Katalogfähigkeiten. Alle Artefakte gehen nach PROJECT_DIR = videos/<Projektname>/ (erstellt in Schritt 0); alle Pfade unten sind relativ dazu.

PhaseAusführungPrimäre ArtefaktDetaillierter Ablauf
initBashhyperframes.jsonSchritt 0
planSubagent — Suche entscheiden? + klassifizieren + Asset-Strategieshot-plan.json (Entwurf: Kategorie, asset_needs-Abfragen, Brief)agents/director.md (Teil 1)
source ◇Bash — Medien-Nutzung auflösen (überspringen, wenn asset_needs leer ist)assets/ + assets/index.mdphases/source/guide.md
designSubagent — Einstellungsdesign um aufgelöste Assets herumshot-plan.json (final: Block(s) + Layout + Bewegung + Positionen)agents/director.md (Teil 2)
buildSubagent — Wiederverwendungs-erste Kompositioncompositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, oder --format webm/mov für Overlay)renders/video.mp4Schritt 5
verifyBash — lint / inspect -> Reparatur-Subagent bei Fehlschlag(Korrekturen an Ort und Stelle)agents/finalize.md

◇ source läuft nur, wenn die gewählte Kategorie Assets deklariert. Reine Code/Text-Kategorien (z.B. kinetic-type, die meisten charts/stat) haben asset_needs: [] und springen direkt vom Plan zum Design.

Kategorien — geteilt durch die Such-Entscheidung

Die erste Entscheidung von plan ist: Braucht dies eine Suche? Diese Gabelung teilt die Kategorien in zwei Gruppen; dann wird die spezifische Kategorie ausgewählt — bei suchgetriebenem nach der Art des Inhalts, den die Suche zurückgibt. Jede Kategorie ist ein categories/<id>/module.md (ihre Planungs- und Build-Regeln); das gemeinsame Bewegungsvokabular lebt in references/motion-vocabulary.md (→ hyperframes-animation Regeln/Blueprints + Registry-Blöcke).

Formular-Kategorien — keine Suche; der Benutzer liefert den Inhalt:

KategorieAbsichtStützt sich auf
kinetic-typePrägnante Zeile / Zitat / Titel, bewegungsorientierter Textcaption-* Blöcke + Animationsregeln
statEinzelne Heldenzahl / Count-up + Ringapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsBalken / Linie / Kreis / Rennen / % aus Datendata-chart Block
logo-revealLogo-Sting / Brand-Lockup (Benutzerlogo)logo-outro / rules/svg-path-draw
lower-thirdsNamens-/Titel-Balken, Callouts, Social-Overlayscaption-* + Registry-Overlay-Blöcke

Suchgetriebene Kategorien — zuerst suchen, dann nach Inhaltstyp animieren (der RWA-Pfad):

Zurückgegebener InhaltKategorieAnimation
Webseite / LinkwebpageWebseiten-/UI-Animation (Scrollen, Einblenden, Cursor, Callouts)
NachrichtenartikelnewsSchlagzeilen-Einblendung + Quellenkarte + Schlüsselfakt-Callouts
TweettweetAnimierte Tweet-Karte
Bild / Entitätasset-fusionDie Geometrie des Assets wird zum Diagramm (RWA diegetische Fusion)

Build-Reihenfolge: eins nach dem anderen, Abdeckung zuerst (Roh ist in Ordnung). kinetic-type aus dem Prototyp portiert; die anderen folgen.

Voraussetzungen

macOS Apple Silicon oder Linux x64. System-Tools: brew install node ffmpeg. npx hyperframes doctor einmal ausführen. macOS GPU-Rendering: export PRODUCER_BROWSER_GPU_MODE=hardware.

Optionale Schlüssel (lokale Fallbacks, falls nicht gesetzt) — nur benötigt von Kategorien, die Assets über Medien-Nutzung beziehen/generieren:

SchlüsselVerwendet fürFallback
GEMINI_API_KEY / GOOGLE_API_KEYBildgenerierung (Medien-Nutzung auflösen)Generierung überspringen / nur Suche
(Asset-Scouter / Suchanbieter)webpage/news/tweet + asset-fusion echte Asset-SucheKategorie deaktiviert sich zu asset-frei

Ablauf

Schritt 0 — Initialisieren

Arbeitsverzeichnis ist der Agenten-Workspace-Root; schreibe alle Artefakte unter PROJECT_DIR = videos/<Projektname>/. <Projektname>: Verwende das vom Benutzer angegebene Verzeichnis, ansonsten einen kurzen Kebab-Case-Namen aus der Absicht (<Subjekt>-motion). Nicht den Workspace-Basisnamen oder einen Zeitstempel.

Nur wenn $PROJECT_DIR/hyperframes.json fehlt:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<Projektname>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

init überprüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert den globalen Satz, falls welche veraltet sind.

Einschränkungen: Niemals hyperframes init im Workspace-Root ausführen; niemals ein weiteres hyperframes/ innerhalb von PROJECT_DIR verschachteln; jeder Bash-Befehl (Master + Subagenten) ist eine (cd "$PROJECT_DIR" && ...) Subshell — niemals ein nacktes cd.

Schritt 1 — Planen (Subagent: Director Teil 1)

Einen Subagenten starten. Prompt = vollständiges agents/director.md + ## Dispatch-Kontext (SKILL_DIR / PROJECT_DIR / die Anfrage des Benutzers / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Er muss:

  1. Entscheiden: Braucht dies eine Suche? (die erste Gabelung)
    • Nein → eine Formular-Kategorie auswählen (kinetic-type / stat / charts / logo-reveal / lower-thirds); Inhalt wird vom Benutzer geliefert; asset_needs: [].
    • Ja → einen Suchplan in asset_needs[] ausgeben (news / web / tweet / image; zweipolige Abfragen). Die spezifische suchgetriebene Kategorie (webpage / news / tweet / asset-fusion) wird durch den in Schritt 2 zurückgegebenen Inhaltstyp bestätigt und in Schritt 3 finalisiert.
  2. Einen Entwurf shot-plan.json schreiben (Hülle + gewählte Formular-Kategorie oder Suchabsicht + asset_needs + ein einleitender Einstellungs-Brief). Schema: references/shot-plan-ir.md.

Validierung: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo fehlt.

Schritt 2 — Quellen ◇ (Bash: Medien-Nutzung, bedingt)

Wenn shot-plan.json.asset_needs nicht leer ist, Assets auflösen (Suche / Generierung / Abruf → eingefrorene projektlokale Pfade + Ledger). Siehe phases/source/guide.md (wrapper für media-use resolve; die suchgetriebenen Kategorien verwenden die news/web/tweet/image-Suche). Wenn asset_needs leer ist, zu Schritt 3 springen.

# illustrativ — siehe phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

Anmutig zurückfallen: Wenn ein Suchanbieter/Provider nicht verfügbar ist, fällt die Kategorie auf asset-frei zurück (notieren in context.log).

Schritt 3 — Design (Subagent: Director Teil 2)

Einen Subagenten starten (Prompt = agents/director.md Teil 2 + Dispatch-Kontext einschließlich des aufgelösten assets/index.md, falls Schritt 2 ausgeführt wurde + catalog-map.md). Er gestaltet die Einstellung um die verfügbaren Assets herum: den/die Katalogblock(blöcke) + die hyperframes-animation Regeln/Blueprints auswählen, das Layout, die Bewegung, die Beats und (für asset-fusion) die element_positions + Pipetten-Palette. Finalisiert shot-plan.json (content.block + content.customize + kategoriespezifischer Inhalt).

Schritt 4 — Build (Subagent: Builder, Wiederverwendung zuerst)

Einen Subagenten starten. Prompt = vollständiges agents/builder.md + Dispatch-Kontext (shot-plan.json, catalog-map.md, das module.md der Kategorie, references/motion-vocabulary.md, references/builder-contract.md). Wiederverwendung zuerst: npx hyperframes add <block> + anpassen an Ort und Stelle; nur Lücken + die asset-fusion-Affordance selbst verfassen. Ausgabe compositions/index.html gemäß dem HF-Vertrag (pausierte GSAP-Timeline bei window.__timelines, class="clip" + stabile IDs, tl.seek(0), deterministisch).

Schritt 5 — Rendern (Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# transparente Overlay-Variante: --format webm (oder mov)

Schritt 6 — Verifizieren (Bash → Reparatur-Subagent bei Fehlschlag)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → fertig. Bei Lint/Inspect-Fehlern den Reparatur-Subagenten starten (agents/finalize.md: Snapshot-QA + eine Korrektur an Ort und Stelle + erneutes Rendern). Niemals eine feste Dauer in der Reparatur ändern.

Bericht + optionale Vorschau

Den finalen Output (renders/video.mp4, oder die .webm/.mov Overlay-Variante) + Dauer melden. Keine Vorschau während des Laufs öffnen. Nur auf Anfrage anbieten, nach dem Rendern gestartet, damit die finale Datei ausgeliefert wird:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio-UI; oder `npx hyperframes play` für einen teilbaren Link

Flags leben im hyperframes-cli Skill (references/preview-render.md).

Fortsetzungstabelle

StatusFortsetzen ab
kein shot-plan.jsonSchritt 1 (plan)
shot-plan.json hat asset_needs, kein assets/Schritt 2 (source)
shot-plan.json final, kein compositions/index.htmlSchritt 3/4 (design+build)
compositions/index.html vorhanden, kein renders/video.mp4Schritt 5 (render) + Schritt 6
renders/video.mp4 vorhandenBericht + Stop

Design-Notizen (Maintainer — die Ausführung liest dies nicht)

  • Asset-zuerst-Begründung: Die Beschaffung ist vorgelagert und informiert das Einstellungsdesign (der RWA-Ablauf: analysieren → suchen → prüfen → komponieren). Die suchgetriebenen Kategorien (webpage/news/tweet) und asset-fusion stützen sich auf die Medien-Nutzung-Suche (news/web/tweet/image), die von media-use als dokumentierte RWA-Linie geführt wird.
  • Wiederverwendung zuerst: Das Ökosystem-Analogon zu LLM-generierten Vorlagen ist "Katalogblöcke + hyperframes-animation Regeln komponieren". HFs pausierte GSAP-Timeline entspricht Remotions useCurrentFrame.
  • Kategorie-Modul-Vertrag: Ein categories/<id>/module.md (Planung + Build), das references/motion-vocabulary.md teilt (+ optionales Eval). Hinzufügen einer Kategorie = den Ordner ablegen + seine Klassifikationszeile in agents/director.md registrieren + seine Zeile in catalog-map.md; die Phasen-Pipeline bleibt unberührt.
  • Verzeichnisstruktur:
    videos/<Projektname>/
      hyperframes.json  context.log
      shot-plan.json            # das IR (Director-Output)
      assets/  assets/index.md  # media-use-Output (falls bezogen)
      compositions/index.html   # Builder-Output
      renders/video.mp4
    
  • Registrierung: Im hyperframes Router — die Absicht "designorientierte kurze Bewegungsgrafik" + Workflow-Beschreibung hinzufügen; die motion-graphics-Trigger aus /general-video herausschneiden; umgekehrte DO-NOT-use-Kanten hinzufügen. Siehe motion-graphics-genre.md §5-7.

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

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.

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