Communitygithub.com

remotion-motion-design

Entwirft und implementiert Kompositionen, Zeitachsen, Szenensysteme, 2D/3D-Animationen, Typografie, Übergänge und wiederverwendbare Komponenten mit Remotion.

Was ist remotion-motion-design?

Diese Fähigkeit befähigt KI-Agenten wie Claude Code, Cursor oder Codex, hochwertige Videos mit Remotion zu erstellen. Sie bietet eine umfassende Anleitung für deterministische Animationen mithilfe von `useCurrentFrame()`, `interpolate()` und `spring()` und stellt sicher, dass Bewegungen reibungslos und berechenbar sind. Der Skill behandelt wichtige Konzepte wie das Timeline-Engineering mit zentralisierten Konfigurationen, das korrekte Verhalten von `Sequence` und `Series.Sequence` (ein häufiger Fehler), sowie eine klare Szenenstruktur und Medienintegration. Zudem werden spezielle Bereiche wie 2D-Animation, Pixel-Art und Stickman-Animation sowie 3D-Motion mit Three.js und Remotion abgedeckt. Die Fähigkeiten schließen mit einer Qualitätssicherungs-Checkliste, die Kompositions-ID, Metadaten, Frame-Bereiche und Asset-Lizenzen überprüft.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/main/.claude/skills/remotion-motion-design

In Ihrer bevorzugten KI fragen

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

Dokumentation

REMOTION MOTION DESIGN — Implementierungsfähigkeit

1. Überprüfung vor dem Codieren

  • Lies CLAUDE.md, MASTER_PROMPT.md und die Architekturdokumente.
  • Überprüfe die tatsächlichen Remotion/React/TypeScript-Versionen und den Paketmanager.
  • Finde den bestehenden Einstiegspunkt und das Kompositionsregister.
  • Folge den Konventionen des Repositorys; wechsle Abhängigkeiten nicht ohne Grund aus.
  • Verwende die Ausgabe von beyond-video, das Skript, das Storyboard und die Style-Bibel als Produktionsspezifikation.
  • Überprüfe die von dir verwendeten APIs anhand der Remotion-Quelle der installierten Version (z. B. packages/core/src in einem Referenz-Klon), bevor du dich auf das Gedächtnis verlässt.

2. Kompositionsprofil

Standardwerte:

  • width: 1080
  • height: 1920
  • fps: 60
  • aspect: 9:16
  • duration: positive ganze Zahl in Frames

Jede Komposition benötigt eine eindeutige ID und explizite Metadaten. Speichere keine unterschiedlichen FPS-Werte in mehreren Layern ohne Grund.

<Composition> akzeptiert id, fps, width, height, durationInFrames, defaultProps und optional calculateMetadata (dynamische Dauer/Metadaten von Props) und schema. durationInFrames muss positiv sein.

3. Timeline-Engineering

  • Halte Dauern und Startframes in zentralisierten Daten/Konfigurationen.
  • Verwende eine Frame-Intervall-Konvention; [start, end) wird empfohlen.
  • Die durationInFrames einer Szene muss positiv sein.
  • Stelle sicher, dass die Gesamtdauer der Komposition jede Szene sowie den Abspann/Ende umfasst.
  • Überprüfe Überschneidungen und Lücken; Überschneidungen sind nur erlaubt, wenn sie für einen Übergang/eine Compositing beabsichtigt sind.
  • Verlasse dich für die endgültige Framegrenze nicht auf Fließkommazahlen.

4. Deterministische Animation — Zeit/Frame-APIs (Remotion 4.x)

Zeitquellen:

  • useCurrentFrame() — der aktuelle Frame, 0-basiert. Nur innerhalb einer Kompositionskomponente verwendbar; außerhalb einer Komposition wird ein Fehler geworfen.
  • useVideoConfig() — gibt {width, height, fps, durationInFrames, id, defaultProps, defaultVideoImageFormat, ...} zurück; wirft einen Fehler außerhalb einer Komposition.

Interpolation und Spring:

  • interpolate(input, inputRange, outputRange, options?) — Überladungen für Zahl, String, Boolean und Array-Ausgabe. Optionen: easing, extrapolateLeft / extrapolateRight ('extend' | 'identity' | 'clamp' | 'wrap'), output, outputType, posterize. Verwende Clamp-Extrapolation, wenn Bewegung nicht über den Bereich hinauslaufen darf.
  • spring({frame, fps, config?, from=0, to=1, durationInFrames?, durationRestThreshold?, delay=0, reverse=false}). SpringConfig: damping (Standard 10), mass (1), stiffness (100), overshootClamping (false). damping <= 0 lässt die Animation nie zur Ruhe kommen (Endlosschleifen-Fehler).
  • measureSpring({fps, config?, threshold=0.005}) — Anzahl der Frames, bis die Feder zur Ruhe kommt; threshold=0 ergibt Infinity.

Regeln:

  • Bewegung muss eine Funktion von Frame und Props sein.
  • Verwende gesetzte Startwerte für Partikel/Rauschen/Zufallswerte.
  • Vermeide setInterval, setTimeout, requestAnimationFrame, Date.now() und selbstlaufende CSS-Keyframes als Hauptquelle für Videobewegung.
  • Lade keine Netzwerkdaten während die Komposition rendert.
  • Binde kein Audio/Video von instabilen URLs oder URLs, die eine Anmeldung erfordern, ein.
  • delayRender(label?, options?) hält den Renderprozess an, bis continueRender(handle) aufgerufen wird (z. B. asynchrone Assets); sein Timeout wird mit dem CLI --timeout gesetzt.

5. Sequence, Series und lokale vs. globale Frames

Dies ist die Regel, die am häufigsten falsch verstanden wird — es gab tatsächlich einen Fehler, weil eine Komponente den globalen Frame innerhalb einer Series.Sequence berechnet hat:

  • Innerhalb einer <Sequence> gibt useCurrentFrame() den Frame RELATIV zum Start der Sequence zurück: (frame - (cumulatedFrom + relativeFrom)) * playbackRate. Komponenten innerhalb einer Sequence sehen NICHT den globalen Frame.
  • <Sequence>-Props: from?, name?, durationInFrames? (muss positiv sein; erforderlich bei Verwendung von loop), layout ('absolute-fill' | 'none'), premountFor, loop und Crop-Props (nur mit layout="absolute-fill").
  • <Series.Sequence> darf NUR innerhalb von <Series> verwendet werden; eine Series.Sequence außerhalb von <Series> wirft „This component must be inside a <Series /> component."
  • Zwei gültige Routing-Muster — wähle eines aus und bleibe konsistent:
    • Globaler Frame-Router (im Videoprojekt verwendet): Eine Router-Komponente verwendet den globalen useCurrentFrame() und wählt den Beat anhand seines [start, end)-Bereichs aus; Beat-Komponenten berechnen aus dem globalen Frame.
    • Series: Jede Series.Sequence enthält einen Beat; Beat-Komponenten berechnen aus dem lokalen Frame (0 am Start der Sequence).
  • Mische beide Muster nicht ohne expliziten Grund in einer Komposition.

6. Szenen-/Komponentenstruktur

  • Eine Szene hat eine narrative/visuelle Verantwortung.
  • Szenen-Props sind in TypeScript definiert.
  • Wiederverwendbare Komponenten lösen eine klare visuelle Aufgabe.
  • Vermeide eine einzige Datei, die das gesamte Video enthält.
  • Trenne Inhaltskonfiguration, Renderer, Style-Tokens und Asset-Referenzen.
  • Füge entworfene Fallbacks für optionale Assets hinzu; verstecke niemals ein fehlendes kritisches Asset.

7. Medienkomponenten und Assets

  • <Img src> — ein Bild, das ohne onError nicht geladen werden kann, bricht den Render ab (cancelRender). Gib immer onError für kritische Assets an oder stelle sicher, dass das Asset vor dem Rendern existiert.
  • staticFile(path) — bildet eine Datei in public/ ab; verwende es für jedes lokale Asset (Bilder, Audio, Video).
  • <Audio> — siehe sound-design für die Zuordnung einer Cue-Sheet zu Props (trimBefore/After — älterer Alias startFrom/endAt — volume, playbackRate). Die Position eines Cues auf der Timeline wird durch <Sequence from> gesetzt; die Trim-Props schneiden nur den Teil der Datei, der abgespielt wird. <Audio> hat kein muted-Prop; Stummschaltung ist ein CLI-Flag (--muted).
  • <Video> / <OffthreadVideo> und <Still> folgen denselben Frame-Regeln; die Mediendauer muss anhand von Frames geplant werden, nicht anhand von Dateimetadaten.

8. 2D-Bewegung

Verwende SVG/Formen/CSS/Raster nach Bedarf. Achte auf Ankerpunkte, Transformationsursprünge, Anti-Aliasing, Schichtung, Clipping und den sicheren Bereich. Jede Transformation muss frame-gesteuert sein.

9. Pixel- und Strichmännchen-Unterstützung

Pixel-Art:

  • Sperre die logische Leinwand und den Pixelmaßstab;
  • verwende Nearest-Neighbor beim Skalieren von Sprites;
  • raste Positionen bei Bedarf auf das Raster ein;
  • sperre die Palette und die Sprite-Abmessungen;
  • vermeide Unschärfe und Subpixel-Flimmern.

Strichmännchen:

  • Halte Proportionen und Drehpunkte konsistent;
  • verwende eine Pose/Rig-Bibliothek, wenn der Projektumfang dies rechtfertigt;
  • animiere Silhouette und Geste, sodass sie lesbar sind;
  • synchronisiere Ausdrücke/Posen mit Story-Beats.

Für Gehzyklen, Durchschwingen und Ruhebewegungen siehe character-animation.

10. 3D-Bewegung

  • Füge 3D nur hinzu, wenn es einen kreativen Mehrwert bringt.
  • Überprüfe die Versionen von three, @react-three/fiber, @remotion/three und deren Dokumentation.
  • Für die Remotion ThreeCanvas-Integration folge dem frame-gesteuerten Ansatz der installierten API-Version; gehe nicht davon aus, dass Echtzeit-R3F-Muster automatisch deterministisch sind.
  • Steuere Kamera, Transformationen, Materialien, Beleuchtung und Partikel über den Frame.
  • Berücksichtige Renderer-/Headless-Kompatibilität, Texturgröße, Geometrie und Rechenaufwand.
  • Trenne die 3D-Ebene von 2D-Typografie/Overlays, wenn dies die Lesbarkeit und Wartbarkeit verbessert.
  • Für die detaillierte Regie von 3D-Szenen siehe 3d-scene-director.

11. Typografie und Übergänge

  • Priorisiere Hierarchie und Lesbarkeit.
  • Decke niemals wichtige Kopie mit einem Übergang ab.
  • Jeder Übergang verbindet zwei Beats; füge keine Effekte ohne Funktion hinzu.
  • Halte Bewegungskurven und -intensität durch die Style-Bibel hindurch konsistent.
  • Passe die Textdauer an die Leseanforderungen an.

12. Abschluss-Implementierung

Implementiere das Abschluss-Logo + CTA gemäß dem beyond-video-Arbeitsblatt. Das Logo muss von einem offiziellen Asset oder einem genehmigten Platzhalter stammen. Text, Timing, Motiv und Compositing müssen sich wie für das jeweilige Video maßgeschneidert anfühlen.

13. Qualitätssicherung vor der Übergabe

Überprüfe Kompositions-ID, Metadaten, Frame-Bereiche, Importe, Typen, statische Assets, Schriftarten, Stilkonsistenz, sicheren Bereich, Abschluss und Asset-Lizenzen. Führe die verfügbaren Lint/Typprüfung/Tests aus. Rendere kein MP4. Committe/Pushe nicht.

Ausgabeformat

  • Kompositionsregister: ID, 1080×1920, 60 FPS, durationInFrames, Szenenliste + Frame-Bereiche.
  • Verwendete APIs: API-Name + relevante Signatur + wo sie überprüft wurde (installierte Remotion-Version).
  • Frame-Routing-Muster: global oder Series — eine Wahl, konsistent über die Komposition hinweg.
  • Asset-Register: Datei, staticFile, Fallback/onError pro kritischem Asset.
  • Qualitätssicherungs-Checkliste + Typprüfung/Lint-Ergebnisse.

Mini-Beispiel

Globaler Frame-Router (Videoprojekt-Muster):

const frame = useCurrentFrame();
const beat = BEATS.find((b) => frame >= b.start && frame < b.end);
return (
  <AbsoluteFill>
    {beat?.id === 'S01-B01' && <Hook />}
    {beat?.id === 'S01-B02' && <Problem />}
  </AbsoluteFill>
);

Spring mit gemessener Dauer:

const settle = measureSpring({fps, config: {damping: 12}});
const progress = spring({frame, fps, config: {damping: 12}});

Fehlermodi

  • Eine Komponente innerhalb von Series.Sequence berechnet den globalen Frame → falscher Beat, Szenen erscheinen zur falschen Zeit. Behebung: Berechne aus dem lokalen Frame oder wechsle zu einem globalen Frame-Router.
  • Series.Sequence ohne <Series> verwendet → wirft einen Fehler beim Rendern. Wickle es in <Series> ein oder verwende <Sequence> direkt (nicht Series.Sequence).
  • spring mit damping <= 0 → die Animation kommt nie zur Ruhe. Halte damping > 0.
  • Fehlendes Bild ohne onError → der Render wird abgebrochen. Füge onError hinzu oder stelle sicher, dass das Asset vor dem Rendern existiert.
  • useCurrentFrame()/useVideoConfig() außerhalb einer Komposition → wirft einen Fehler. Rufe sie nur innerhalb von Kompositionskomponenten auf.

Individual skills in this repo

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

Verwandte Skills