Communitygithub.com

cskwork/motion-graphics-skill

Erstelle codegesteuerte Bewegtgrafik-Videos, die aus HTML gerendert werden, framegenau und reproduzierbar sind. Formate – Produkt-Launch- oder Feature-Ankündigungsvideos aus echten Aufnahmen der laufenden App des Benutzers (Apple/Google-Keynote-Stil, SaaS-Launches auf X) sowie vertikale Kurzformate für YouTube Shorts, Reels oder TikTok (Hook-zentriert, loopfähig). Verwende es bei Anfragen nach Launch-Videos, Promotion, App-Trailern, Shorts oder anderen Bewegtgrafik-Videos.

Was ist motion-graphics-skill?

Diese Fähigkeit ermöglicht die Erstellung von codebasierten Bewegtgrafik-Videos, die aus einer einzigen HTML-Seite bestehen. Jedes Pixel ist eine reine Funktion der Zeit `t`, wird Frame für Frame in einem Headless-Chromium gerendert und mit ffmpeg codiert. Das Ziel ist die Qualität eines professionellen Motion-Design-Showreels – keine Diashow. Der Skill unterscheidet zwei Hauptformate: Launch-Videos für echte Produkte (Keynote-Stil) und vertikale Kurzfilme für Plattformen wie YouTube Shorts, Reels oder TikTok. Jede Produktion erhält ein eigenes Konzept, Drehbuch und Design – frische Ideen pro Durchlauf, ohne Rückgriff auf frühere Arbeiten. Der Workflow umfasst das Erstellen eines Arbeitsordners mit strukturierten Dateien (Brief, Beat-Sheet, Assets, Komposition), die Nutzung einer Engine mit Playwright und ffmpeg, sowie eine detaillierte Kompositionsanleitung mit Hilfsfunktionen für Szenen, Tweening und Determinismus. Nach dem Rendern folgt eine strenge Qualitätssicherung mit Checks auf Dauer, Größe, Bildrate und fehlerfreie Frames. Abschließend wird das finale MP4 mit Audio gemischt und geliefert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cskwork/motion-graphics-skill/tree/HEAD/skills/motion-graphics

In Ihrer bevorzugten KI fragen

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

Dokumentation

motion-graphics

Ein Video ist eine HTML-Seite, deren jedes Pixel eine reine Funktion der Zeit t ist, die Frame für Frame in Headless-Chromium gerendert und mit ffmpeg codiert wird. Das Ziel ist das Showreel eines erfahrenen Motion-Designers, niemals eine Diashow.

1. Wähle das Format

AnfrageLese
Launch, Promotion, Werbung, Feature-Reel, App-Trailer für ein echtes Produktformats/launch-video.md
Shorts, Reels, TikTok, vertikaler Erklärfilm oder Storyformats/shorts.md

Folge der Formatdatei für das Briefing, die Inhaltsschritte und die Beat-Struktur. Diese Datei verweist für den Bau wieder hierher zurück. Lies auch references/pitfalls.md, bevor du die Komposition schreibst.

Jedes Mal ein neues Konzept. Jedes Video erhält seine eigene Idee, sein eigenes Skript und Aussehen. Wenn der Benutzer sagt, dass frühere Arbeiten nicht angesehen werden sollen, lasse frühere Videos und Kompositionen im Arbeitsbereich ungeöffnet.

2. Arbeitsordner

Erstelle <slug>-<YYYYMMDD>/ dort, wo der Benutzer es wünscht (Standard: das aktuelle Verzeichnis):

brief.md          Parameter aus der Briefing-Tabelle des Formats
beats.md          Der Beat-Sheet (Zeit, Text, Asset, Bewegung, Übergang, Akzent-Hit)
assets/           Aufnahmen, Bilder, Schriftarten, Audio
assets/manifest.md  Eine Zeile pro Asset-Datei: Quelle, Lizenz oder "aufgenommen von <Oberfläche>", was es zeigt
motion.html       Die Komposition
motion.json       {"size": [W, H], "fps": 60, "duration": 30, "stills": [Beat-Zeiten], "captions": []}
engine/           Kopiert aus dem engine/-Ordner dieser Fähigkeit
out/              Standbilder, Renderings, Kontaktbogen

Richte die Engine einmal pro Ordner ein:

cp -R <diese-faehigkeit>/engine engine && (cd engine && npm install && npx playwright install chromium)

3. Komponieren

motion.html lädt engine/runtime.css und engine/runtime.js, erstellt sein DOM, registriert Szenen und ruft dann MG.ready() auf.

HilfsfunktionVerwendung
MG.scene(start, end, fn, el)fn(local, t, dur) wird ausgeführt, während start <= t < end; el ist außerhalb versteckt. Setze jede animierte Eigenschaft bei jedem Aufruf.
MG.always(fn)Wird bei jedem Frame ausgeführt: Hintergründe, Körnung, Fortschrittsbalken.
MG.prog(t, a, b, ease)Eased 0..1 Fortschritt. Eases: MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) oder jede Funktion.
MG.tween(t, [[t0, v0], [t1, v1, ease], …])Keyframes; Werte können Arrays sein.
MG.spring(t, {stiffness, damping})Physikalischer 0 → 1 mit Überschwingen.
`MG.split(el, "grapheme""word")`
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css})Ein Aufruf pro Element pro Frame.
MG.clip(videoEl, start, rate)Spielt eine Bildschirmaufnahme framegenau ab start ab.
MG.rng(seed), MG.noise(x, seed)Deterministische Zufälligkeit und Wackeln.
MG.fmt(n, {decimals})Formatierung von Zahlen für Zähler (lokalisiert).
MG.captions()Zeichnet motion.json-Untertitel oberhalb des unteren UI-Blocks.

Determinismus: Kein Date, performance.now(), requestAnimationFrame oder Math.random in der Renderlogik. CSS @keyframes sind erlaubt; die Laufzeit pausiert sie bei t, also zeitlich mit animation-delay. Verwende nur Schriftarten und Bilder, die im Manifest aufgeführt sind.

Vorschau eines Frames: open "motion.html?w=1920&h=1080&t=3.2&guides=1" (Guides zeigen sichere Zonen). Echtzeit: ?play=1. Untertitel werden nur in Renderings angezeigt.

4. Handwerksniveau

  • Frame 0 ist bereits in Bewegung. Kein Einblenden aus Schwarz, kein Logo-Intro.
  • Alle 0,8–2 s ändert sich etwas Sinnvolles: Layout, Skalierung, Farbe, Zahl oder Kamera.
  • Eintritte verwenden Federn oder ease-out-expo mit leichtem Überschwingen; 30–60 ms Staffelungen; linear nur für Ticker.
  • Bewegungsunschärfe nur bei schnellen Bewegungen; ein langsamer Zoom (Skalierung 1 → 1,04) bei gehaltenen Aufnahmen; Parallaxe über 2–3 Tiefenebenen.
  • Eine Hintergrundfamilie, eine Textfarbe, ein Akzent. Füge Körnung oder Gradient-Rauschen hinzu, damit einfache Flächen nach dem Hochladen nicht streifen.
  • Text bleibt lange genug auf dem Bildschirm, um zweimal gelesen zu werden; Schlüsseltext bleibt innerhalb der sicheren Zonen.
  • Beats landen auf Ton: ein Whoosh, Hit oder Musikbeat bei jeder Änderung.

5. Rendern

node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4

Lege zuerst das Layout mit Standbildern fest: eines pro Beat, eines innerhalb jedes Tweens, eines an jedem Überschwing-Peak einer Feder. Führe jeweils ein vollständiges Rendering durch (etwa 10 Minuten für 25 s bei 1080p60 mit 4 Workern).

6. Audio

Verwende nur Musik und Soundeffekte, die im Manifest mit einer für die Nutzung geeigneten Lizenz aufgeführt sind, oder Dateien, die der Benutzer bereitstellt. Ohne diese liefere stumm aus und sag es. Mische Cues, dann multiplexe:

ffmpeg -i music.wav -i whoosh.wav -filter_complex \
  "[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
  -af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"

Ziel ist etwa −14 LUFS integriert und True Peak bei oder unter −1 dBFS. Soundeffekte liegen etwa bei −6 bis −14 dB, Musik bei −14 bis −18 dB. Musik unter Texteinblendungen ist instrumental.

7. Qualitätssicherung

  1. ffprobe-Dauer, -Größe und -Bildrate entsprechen dem Brief.
  2. Kontaktbogen: ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. Betrachte ihn und ein Vollbild-Frame bei jedem Beat-Wechsel (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png).
  3. Jeder Frame: nichts an den Rändern abgeschnitten, keine leeren oder halb ausgeblendeten Frames, keine überflüssigen Hilfslinien, keine Tippfehler oder Platzhaltertexte, nichts länger als 2 s statisch.
  4. Die eigenen Prüfungen der Formatdatei.

Behebe und rendere erneut, bis alle Prüfungen bestanden sind. Füge jede neue Erkenntnis als datum · video · lektion in references/pitfalls.md in der Fähigkeit hinzu.

Lieferung

Melde den endgültigen MP4-Pfad, Länge, Größe und Bildrate, was es zeigt, Audio-Status mit erforderlichen Credits und die Neurender-Befehle. Behalte den Arbeitsordner. Lade hoch oder veröffentliche nur, wenn der Benutzer danach fragt.

Verwandte Skills