Communitygithub.com

remotion-motion

Mit dieser Skill werden Motion-Graphics-Videos mit Remotion professionell umgesetzt: Rhythmus im Tempogitter, Lesbarkeit, glaubwürdige Kamerafahrten, artefaktfreier Bewegungsunschärfe, bandingfreie Verläufe und Glanzlichter auf dunklen Hintergründen, farbechtes Rendering, gemastertes Audio, größenoptimierte Kodierung und bildgenaue Qualitätssicherung.

Was ist remotion-motion?

remotion-motion ist eine spezialisierte Skill für KI-Assistenten (z. B. Claude Code, Cursor, Codex), die Videos mit der React-Bibliothek Remotion erstellen. Sie kümmert sich nicht um das „Was“ oder „Wie“ der Gestaltung, sondern stellt sicher, dass das Endprodukt technisch einwandfrei ist – ohne typische Fehler wie Banding, Flimmern, Farbstiche, Doppelkonturen bei Unschärfe, verrauschtes Audio oder übermäßige Dateigrößen. Die Skill basiert auf einem umfassenden Satz von Referenzdokumenten (Motion, Bild, Unschärfe, Audio, Auslieferung), Vorlagen und Skripten. Sie definiert einen klaren Arbeitsablauf: vom Briefing und Storyboard über den schrittweisen Aufbau einzelner Kapitel, Iteration ohne Unschärfe, einer gründlichen manuellen Prüfung mittels Kontaktabzügen und übersteigerter Bilduntersuchung, bis hin zur finalen Master-Erstellung mit extern gemitteltem Bewegungsunschärfe (`scripts/blur.sh`) und der Auslieferung mit Audiomastering, MP4/WebM-Kodierung und QA (`scripts/deliver.sh`). Die Skill erzwingt kritische Regeln: Zeit muss als reine Funktion von frame (auch Bruchzahlen) definiert sein, Schnitte und Akzente müssen auf dem Tempogitter liegen, Text darf sich beim Eintippen nicht verschieben, Kamerabewegungen benötigen echten Parallax-Effekt, und Verläufe auf dunklen Hintergründen müssen mit Dithering (glow.py) erzeugt werden, um Banding zu vermeiden. Zudem wird strikt auf korrekte Farbräume (BT.709) und Audio-Pegel (−14 LUFS) geachtet. Zusammengefasst: remotion-motion ist der Garant für ein professionelles, fehlerfreies Remotion-Video. Es automatisiert die häufigsten Fallstricke und gibt dem KI-Agenten eine klare Checkliste mit, sodass Nutzer (z. B. Agenturmitarbeiter, Motion Designer) ein sauberes, kundenfertiges Ergebnis erhalten – ohne technische Überraschungen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GerardKampos/remotion-motion/tree/main

In Ihrer bevorzugten KI fragen

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

Dokumentation

Remotion mit professionellem Finish

Diese Skill kümmert sich nicht darum, was erzählt wird oder wie es aussieht – sie sorgt dafür, dass das Endergebnis sauber ist. Fast alle Mängel, die ein Kunde bemerkt („Abriss im Hintergrund“, „komische Halos“, „der Text zittert“, „klingt wie ein YouTube-Tutorial“) haben fünf Ursachen: Das Timing, der 8-Bit-Browser, die Komprimierung, das Audio und die Tatsache, dass das Ergebnis nicht wirklich angesehen wurde.

Referenzen (lies sie, wenn du an den entsprechenden Teilen arbeitest):

Voraussetzungen

Node 18+ mit Remotion 4, ffmpeg mit libx264, libvpx-vp9 und libopus, ImageMagick 7 (magick) und Python 3 mit numpy, scipy, soundfile und pillow. Skripte sind unter Linux getestet und auch für macOS ausgelegt (bash 3.2, ohne df, nproc oder mktemp -p).

Bausteine

Kopiere sie in dein Projekt und passe sie an. <skill> ist das Verzeichnis dieser Skill.

BausteinWofür
templates/beat.tsfps, Tempo, PER_BEAT, CHAPTERS und TOTAL: die Zeit des Videos an einem Ort
templates/Main.tsx, templates/Root.tsxGrundgerüst mit einem Sequence pro Kapitel und den beiden Kompositionen (normal und für Einzelbilder)
templates/motion.tsKurven, ease, mix, keys, sample (Tabellen ohne Rundung), integrate, typed, seeded
templates/Typed.tsxGetippter Text, der nicht nachrutscht
templates/Subframes.tsxDie Komposition mit 24 Einzelbildern pro Frame für die Unschärfe
templates/Halo.tsxGlanzlicht, das Licht hinzufügt, ohne dunklen Hof
templates/Sfx.tsx<Sfx at name />, <Typing /> und <Words /> framegenau synchronisiert
scripts/sfx.pyBibliothek für synthetisierte Effekte → public/sfx/*.wav
scripts/glow.pyHalo mit Dithering → public/textures/glow.png
scripts/blur.shMaster mit Bewegungsunschärfe, gemittelt außerhalb von Chrome
scripts/deliver.shAudio auf −14 LUFS, Web-MP4 nach Größe, WebM, Standbild und Kontaktabzug
scripts/master.pyAudiomastering (wird von deliver.sh verwendet)
scripts/qa.sh, scripts/bgcheck.pyPrüfbögen und Hintergrundmessung

Typischer Start:

npx create-video@latest            # oder ein bestehendes Remotion-Projekt
cp <skill>/templates/*.ts* src/    # Root.tsx ersetzt die Vorlagenversion
mkdir -p scripts && cp <skill>/scripts/* scripts/
python3 scripts/sfx.py public/sfx
python3 scripts/glow.py public/textures/glow.png --color 133,149,191

Arbeitsablauf

  1. Briefing und Storyboard in Zeit. Dauer, Format, fps (Standard 30), Musik-Tempo und Kapitel in Frames, die auf Zeiten fallen (beat.ts). Schreibe das Storyboard in einer .md-Datei und halte es aktuell: Nur so kannst du etwas ändern, ohne den Rest zu beschädigen.
  2. Kapitelweise aufbauen, jedes Kapitel eine eigene Komponente mit lokalen Frames. Keine losen Zeiten: benannte Konstanten (MAIL_IN, fillAt(i), STAMP), die voneinander abgeleitet sind.
  3. Entwürfe ohne Unschärfe für schnelle Iteration. Rendere nur den veränderten Abschnitt (--frames=a-b) und zeige ihn dem Nutzer; das gesamte Video erst am Ende einer Runde.
  4. Prüfung mit eigenen Augen, bevor du etwas zeigst (siehe „Wirklich hinsehen“).
  5. Master mit scripts/blur.sh und Liefergegenstände mit scripts/deliver.sh. Endkontrolle anhand der komprimierten Datei, nicht des Renders.

Design-Feedback: Bei konzeptionellen Fragen schlage erst etwas vor, bevor du loslegst; technische Korrekturen wende ohne Nachfrage an. Wenn eine Idee nicht zweimal überzeugt, biete Alternativen mit Vorschau an, statt eine dritte Variante blind zu erstellen. Zeige jeden geänderten Teil isoliert; mache nichts neu, was bereits gefallen hat.

Finish-Regeln (die am häufigsten gebrochen werden)

Zeit

  • Alles ist eine reine Funktion von frame und akzeptiert gebrochene Frames. Kein Math.round und keine ganzzahligen Tabellen in Positionen oder Kameras (sample() interpoliert). Die Unschärfe tastet Zwischenbilder ab; wenn die Zeit gerundet wird, entstehen Doppelgänger.
  • Schnitte, Wort-Einblendungen, Schläge und Akzente auf dem Tempogitter. Synchronisieren ist nicht „pulsieren“: Nichts sollte mit der Musik mitwippen.
  • Immer nur eine Sache zum Lesen. Mindestens ~1,2 s für eine Überschrift und ~0,4 s pro zusätzlichem Wort. Wenn sich die Kamera bewegt, stoppt sie im Moment des Lesens.

Layout

  • Text, der getippt oder größer wird, darf nicht nachrutschen: Reserviere seine Breite (Typed). Ein zentrierter Text, der Buchstabe für Buchstabe neu zentriert wird, erscheint bei Unschärfe doppelt.
  • Nichts verdeckt das, was gelesen werden muss: Überprüfe Überlappungen in den Einblende-, Ausblende- und Kreuzungs-Frames, nicht nur im Ruhezustand.
  • Lesbar bei der tatsächlichen Anzeigebreite (z. B. 900 px im Web: ein 1080p-Video wird mit 47 % gesehen). Wichtiger Text ≥ 24 px bei 1080p; 18–20 px nur für Beschriftungen.

Kamera und Bewegung

  • Damit „die Kamera fährt“ und nicht die Objekte: Feste Welt und eine Kamera, die sich bewegt; jedes Element wird entsprechend seiner Tiefe projiziert. Nahes bewegt sich mehr: das ist Parallaxe.
  • Kurven mit Absicht (schnelles Herauszoomen für Einblendungen, In-Out für Fahrten, Beschleunigung für Ausblendungen). Nichts Linear außer Tippen und Scans.

Bild (Chrome malt mit 8 Bit)

  • Keine breiten Farbverläufe mit wenigen Stufen auf Dunklem (Vignetten, lange schwarze Schatten, riesige Halos): Sie brechen in Streifen und die Komprimierung verwandelt sie in Klötze. Einfache Hintergründe; kurze Schatten auf Dunklem.
  • Große Halos: Bild mit Dithering (glow.py), nicht filter: blur(). Licht-Highlights mit mix-blend-mode: plus-lighter (Halo), das keinen dunklen Hof hinterlässt.
  • Niemals Unschärfe innerhalb des Browsers für den Master (CameraMotionBlur oder Ebenen mit Deckkraft): Sie färbt Dunkles ein und verschiebt den Hintergrund bereichsweise. Siehe reference/blur.md.
  • Bilder mit <Img> von Remotion (wartet auf das Laden); niemals background-image in CSS.
  • Eigene SVG-Logos: Überprüfe sie vergrößert; ein gedrehter Pfad kann mit seiner Füllung nicht übereinstimmen.

Farbe und Ausgabe

  • BT.709 im Render markieren (--color-space=bt709) und bei jedem ffmpeg. Ohne Markierung interpretiert jeder Player die Farbe anders.
  • Master fast verlustfrei und nur eine starke Komprimierung bis zum Liefergegenstand. Das Web-MP4 in zwei Durchläufen mit der gewünschten Größe, aq-mode=3 für mehr Bits in dunklen Bereichen.

Audio

  • Ein Effekt pro visuellem Ereignis, framegenau. Tastatur, Wörter, Klicks und Sweeps unterscheidbar voneinander. Sweeps und Glanzlichter mit Tiefpass (~3 kHz): sonst klingen sie schrill.
  • Musik begleitet: 8–12 dB unter den Effekten und mit Ducking dort, wo getippt oder gelesen wird.
  • −14 LUFS integriert und −1 dBTP gemessen am finalen AAC.

Wirklich hinsehen

Ein schöner Einzelbild im Studio beweist nichts. Bevor du ein Ergebnis zeigst:

  1. Kontaktabzug (scripts/qa.sh sheet video.jpg sheet.jpg f1 f2 …): Komposition, Überlappungen, abgeschnittener Text, leere Momente.
  2. Übergangs-Frames, nicht nur Ruhebilder: Mitte jeder Einblendung, jedes Ausblendens und jedes Sweeps. Hier tauchen Stufenkopien, doppelter Text und Überlappungen auf.
  3. Übersteigerter Kontrast auf Dunklem (scripts/qa.sh boost …, Pegel 0–30 %): Zeigt Streifen, Rechtecke, Farbstiche und Klötze, die auf einem guten Monitor oder im Dunkeln sichtbar sind.
  4. Hintergrund messen mit scripts/bgcheck.py: ohne Referenz die Streuung des einfarbigen Hintergrunds; mit --ref, was die Komprimierung hinzugefügt hat. Referenz: der Master bei Bewegung (gleiche Unschärfe), ein remotion still nur bei Standbildern. Gut: ≤ 0,6 Stufen; zwischen 0,6 und 0,8 sieh dir die Überhöhung an (meist eine unsichtbare halbe Stufe); die Browser-Unschärfe ergab ~1 und war sichtbar.
  5. Unkomprimiert vs. komprimiert am selben Frame: Ist der Fehler in beiden, liegt es am Design oder am Render; nur im Komprimierten, am Encoder. Die Behebung ist unterschiedlich.

Dekodiere immer mit scale=in_color_matrix=bt709; sonst siehst du nicht vorhandene Farbstiche.

Umgebungsfallen

  • Lange Render im Hintergrund und vorher den Speicherplatz prüfen (blur.sh macht das). /tmp kann im RAM liegen: Das temporäre Verzeichnis von Remotion liegt dort, wo TMPDIR hinzeigt. ProRes HQ 1080p ≈ 170 KB pro Einzelbild, und das finale Zusammenfügen erstellt eine Kopie.
  • Um die endgültige Unschärfe in einem Abschnitt zu prüfen, ohne alles zu rendern: RANGE=a-b scripts/blur.sh ….
  • remotion render in H.264 unterstützt kein --crf=0; für verlustfreie Zwischenschritte ProRes oder PNG.
  • Um einen Render zu stoppen: pkill -f "[r]emotion render" (die eckigen Klammern verhindern, dass deine eigene Shell getötet wird).
  • Bei Einzelbildern darf keine Komponente fps von useVideoConfig() lesen: Es würde FPS·SUB gelten.
  • Zahlen im Video: Überprüfe sie (Summen, Gesamtbeträge) vor dem finalen Render. Eine falsch addierte Summe in einem Werbevideo ist schlimmer als jedes Banding.

Abgabeliste

  • Kontaktabzug und Übergangs-Frames geprüft; nichts überdeckt nichts; nichts rutscht nach.
  • Dunkle Hintergründe ohne Rechtecke, Farbstiche oder Klötze im finalen MP4 (Überhöhung + bgcheck).
  • Unschärfe kontinuierlich bei den schnellsten Bewegungen, ohne Stufenkopien.
  • Text in tatsächlicher Breite lesbar; jede Lesephase mit ausreichend Zeit.
  • Audio bei −14 LUFS ±0,5 und Spitze ≤ −1 dBTP; Effekte unterscheidbar; Musik darunter.
  • BT.709 in MP4 und WebM markiert; Größe innerhalb des Limits; +faststart.
  • Standbild und Kontaktabzug; Storyboard aktuell; Skripte, die alles regenerieren.
  • Dem Nutzer: Größen, Lautstärke und was illustrativ oder fiktiv ist. Die Freigabe liegt bei ihm.

Verwandte Skills