Communitygithub.com

1345AbhishekKumar/starter-nextjs

Verwenden Sie dies, wenn der Benutzer eine kurze, designorientierte Bewegungsgrafik wünscht, bei der die Bewegung die Botschaft ist: Kinetische Typografie, Statistik- oder Zahlenanimation, Chart-/Datenvisualisierung, Logo-Sting, Marken-Lockup, Lower-Third, Callout, Social-Overlay, animierte Schlagzeile/Tweet/News, Bewegungsplakat oder schnelle Seitenausschnitt-Hervorhebung. Normalerweise unter 10s und bis zu ~30s, ohne Erzählbogen, Voice-Over oder Live-Action-Subjekt. Kann als MP4 oder transparentes Overlay gerendert werden. Nicht für längere, mehrszenige, erzählte oder Markenreel-Stücke (verwenden Sie general-video), erzählte Website-Videos (website-to-video), Themen-Erklärvideos (faceless-explainer), Produkt-Promos (product-launch-video), PR-Videos (pr-to-video) oder Untertitel auf vorhandenem Filmmaterial (embedded-captions). Wenn Sie sich unsicher sind, ob es sich um ein schnelles bewegungsorientiertes Stück oder eine längere/erzählte Behandlung handelt, lesen Sie /hyperframes.

Was ist starter-nextjs?

Das Skill "motion-graphics" ist ein Dispatch-Eintrag für die Erstellung kurzer, designorientierter Bewegungsgrafiken ohne Voice-Over, typischerweise unter 10s oder bis zu ~30s. Es zielt auf Formate wie kinetische Typografie, Statistik-Zahlenanimation, Chart-Animationen, Logo-Stings, Lower-Third-Einblendungen, Social-Overlays, animierte Schlagzeilen und Bewegungsplakate ab. Der Workflow ist asset-orientiert: Zuerst wird die Asset-Strategie festgelegt, dann die Einstellung um die verfügbaren Assets herum gestaltet und schließlich durch Wiederverwendung von Katalog-Bausteinen komponiert. Das Skill läuft auf macOS Apple Silicon oder Linux x64 und nutzt Tools wie `npx hyperframes` für Initialisierung, Rendern (MP4, WebM oder MOV) und Verifikation. Es bietet eine detaillierte Pipeline mit Phasen für Planung, Asset-Beschaffung, Design, Build, Rendern und Verifikation und verwendet Subagenten für Design- und Build-Aufgaben. Für längere, mehrszenige oder erzählte Inhalte verweist es auf andere Skills wie `/general-video`.

Funktioniert mit~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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

Bestätigen Sie die Route vor Schritt 0. Dieses Skill erstellt eine kurze, designorientierte, unerzählte Bewegungsgrafik (Bewegung ist die Botschaft; ~unter 10s, kein Voice-Over). Eine längere, mehrszenige 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. Nicht im Rahmen: Live-/Renderzeit-Daten oder Filmmaterial, das es nicht erfassen kann. Unsicher, ob Bewegungsgrafik vs. erzählt? Lesen Sie zuerst /hyperframes.

Eine kurze designorientierte Bewegungsgrafik. Asset-zuerst: Entscheiden Sie die Asset-Strategie und beschaffen Sie echtes Material bevor Sie die Einstellung entwerfen, dann entwerfen Sie die Einstellung um das, was Sie haben, und komponieren Sie durch Wiederverwendung von Katalog-Fähigkeiten. Alle Artefakte gehen nach PROJECT_DIR = videos/<project-name>/ (erstellt in Schritt 0); alle Pfade unten sind relativ dazu.

PhaseAusführungPrimäres 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 — Media-Use 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 — Wiederverwendungsorientierte 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 überspringen direkt von der Planung zum Design.

Kategorien — aufgeteilt nach der Such-Entscheidung

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

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

KategorieAbsichtStützt sich auf
kinetic-typeeindringliche 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 / Marken-Lockup (Benutzer-Logo)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, Enthüllen, Cursor, Callouts)
NachrichtenartikelnewsSchlagzeilen-Enthüllung + Quellenkarte + wichtige-Fakten-Callouts
TweettweetAnimierte Tweet-Karte
Bild / Entitätasset-fusiondie Geometrie des Assets wird zum Diagramm (RWA diegetische Fusion)

Build-Reihenfolge: einzeln, abdeckungsorientiert (Grobentwurf ist in Ordnung). kinetic-type portiert aus dem Prototyp; der Rest folgt.

Voraussetzungen

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

Optionale Schlüssel (lokale Fallbacks, falls nicht gesetzt) — werden nur von Kategorien benötigt, die Assets über Media-Use beschaffen/generieren:

SchlüsselVerwendet fürFallback
GEMINI_API_KEY / GOOGLE_API_KEYBildgenerierung (Media-Use auflösen)Generierung überspringen / nur-Suche
(asset_scout / Suchanbieter)webpage/news/tweet + asset-fusion echte-Asset-SucheKategorie degradiert zu assetfrei

Ablauf

Schritt 0 — Initialisieren

cwd ist das Agent-Workspace-Root; schreiben Sie alle Artefakte unter PROJECT_DIR = videos/<project-name>/. <project-name>: Verwenden Sie das vom Benutzer angegebene Verzeichnis, sonst einen kurzen Kebab-Case-Namen aus der Absicht (<betreff>-motion). Nicht den Workspace-Basename oder einen Zeitstempel.

Nur wenn $PROJECT_DIR/hyperframes.json nicht vorhanden ist:

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

init prüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert das globale Set, wenn eines veraltet ist.

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

Schritt 1 — Planen (Subagent: Director Teil 1)

Einen Subagenten auslösen. 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: Benötigt dies eine Suche? (die erste Gabelung)
    • Nein → wähle eine Form-Kategorie (kinetic-type / stat / charts / logo-reveal / lower-thirds); Inhalt wird vom Benutzer geliefert; asset_needs: [].
    • Ja → gib einen Suchplan in asset_needs[] aus (news / web / tweet / image; Zweipol-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 Form-Kategorie oder Suchabsicht + asset_needs + ein einzeiliger Einstellungs-Brief). Schema: references/shot-plan-ir.md.

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

Schritt 2 — Beschaffen ◇ (Bash: Media-Use, bedingt)

Wenn shot-plan.json.asset_needs nicht leer ist, lösen Sie Assets auf (Suche / Generierung / Abruf → eingefrorene projektlokale Pfade + Hauptbuch). Siehe phases/source/guide.md (umhüllt media-use resolve; die suchgetriebenen Kategorien verwenden die News/Web/Tweet/Bild-Suche). Wenn asset_needs leer ist, überspringen Sie zu Schritt 3.

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

Fehlertolerant: wenn ein Such-/Anbieter nicht verfügbar ist, fällt die Kategorie auf assetfrei zurück (Notieren Sie es in context.log).

Schritt 3 — Design (Subagent: Director Teil 2)

Einen Subagenten auslösen (Prompt = agents/director.md Teil 2 + Dispatch-Kontext einschließlich des aufgelösten assets/index.md, wenn Schritt 2 lief + catalog-map.md). Er entwirft die Einstellung um die verfügbaren Assets herum: wähle den/die Katalog-Block(s) + die hyperframes-animation-Regeln/Blueprint, das Layout, die Bewegung, Beats, und (für asset-fusion) die element_positions + Eyedropper-Palette. Finalisiert shot-plan.json (content.block + content.customize + pro-Kategorie-Inhalt).

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

Einen Subagenten auslösen. 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> + Anpassung an Ort und Stelle; nur Lücken + die Asset-Fusion-Affordance von Hand autorisieren. Ausgabe compositions/index.html unter Einhaltung des HF-Vertrags (pausierte GSAP-Timeline auf 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 auslösen (agents/finalize.md: Snapshot-QA + eine Korrekturrunde an Ort und Stelle + erneutes Rendern). Niemals eine festgelegte Dauer während der Reparatur ändern.

Bericht + optionales Vorschaubild

Berichten Sie das endgültige Ausgabe (renders/video.mp4, oder die .webm / .mov Overlay-Variante) + Dauer. Öffnen Sie während des Laufs keine Vorschau. Bieten Sie eine nur auf Anfrage an, nach dem Rendern gestartet, damit sie die endgültige Datei bedient:

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

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

Fortsetzungstabelle

ZustandFortfahren 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 + Stopp

Designnotizen (Betreuer — die Ausführung liest dies nicht)

  • Asset-zuerst Begründung: Die Beschaffung wird vorgelagert und informiert das Einstellungsdesign (der RWA-Fluss: analysieren → suchen → prüfen → komponieren). Die suchgetriebenen Kategorien (webpage/news/tweet) und asset-fusion stützen sich beide auf die Media-Use-Suche (News/Web/Tweet/Bild), die die dokumentierte RWA-Abstammung von Media-Use ist.
  • Wiederverwendung zuerst: Das Ökosystem-Analogon zu LLM-generierten Vorlagen ist "Katalog-Blöcke + hyperframes-animation-Regeln komponieren". HFs pausierte GSAP-Timeline ≙ Remotions useCurrentFrame.
  • Kategorie-Modul-Vertrag: Ein categories/<id>/module.md (Planung + Build), teilt references/motion-vocabulary.md (+ optionales eval). Eine Kategorie hinzufügen = Ordner ablegen + ihre Klassifikatorzeile in agents/director.md registrieren + ihre Zeile in catalog-map.md; die Phasen-Pipeline bleibt unberührt.
  • Verzeichnisstruktur:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # das IR (Director-Ausgabe)
      assets/  assets/index.md  # Media-Use-Ausgabe (falls beschafft)
      compositions/index.html   # Builder-Ausgabe
      renders/video.mp4
    
  • Registrierung: im hyperframes-Router — die "designorientierte kurze Bewegungsgrafik"-Absicht + 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-nextjs

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

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

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

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

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

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

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

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

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

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

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

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

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