Communitygithub.com

Ministry-of-Technology-AU/next-platform

Best Practices für Remotion – Videoerstellung in React

Was ist next-platform?

Diese Skill bietet umfassende Best-Practice-Richtlinien für die Arbeit mit Remotion, einer React-basierten Bibliothek zur programmatischen Videogenerierung. Sie deckt den gesamten Workflow ab: vom Einrichten neuer Projekte über das Design animierter Szenen bis zur Integration von Medien (Bilder, Videos, Audio), Captions, visuellen Effekten und 3D-Inhalten. Die Skill erklärt zentrale Konzepte wie `useCurrentFrame()`, `interpolate()` und `Sequence` und gibt klare Regeln vor, etwa den Vorzug von `interpolate()` vor `spring()` und die Verwendung individueller CSS-Transform-Eigenschaften. Sie verweist auf zahlreiche Sub-Regeln zu Spezialthemen wie Google Fonts, Lottie-Animationen, TailwindCSS, Übergängen, Transparenz, Parameterisierung und Voiceover. Die Skill eignet sich für Entwickler, die in Claude Code, Cursor oder Codex arbeiten und qualitativ hochwertige, performante Remotion-Videos erstellen möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/remotion-best-practices

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

Dokumentation

Wann verwenden

Verwende diese Skill, wenn du mit Remotion-Code arbeitest, um domänenspezifisches Wissen zu erhalten.

Neues Projekt einrichten

Wenn du dich in einem leeren Ordner oder Workspace ohne bestehendes Remotion-Projekt befindest, erstelle eines mit:

npx create-video@latest --yes --blank --no-tailwind my-video

Ersetze my-video durch einen passenden Projektnamen.

Ein Video gestalten

Bevor du visuelle Szenen, Layouts, Promos, Bewegungsgrafiken oder textlastige Videos entwirfst, lade rules/video-layout.md für video-first Layout- und Textgrößen-Richtlinien.

Animierte Eigenschaften werden mit useCurrentFrame() und interpolate() erstellt. Bevorzuge interpolate() gegenüber spring(), es sei denn, ein physikbasierter Bewegungsablauf wird explizit benötigt. Verwende Easing.bezier(), um Timing-Abläufe anzupassen, einschließlich sprunghafter oder überschwingender Bewegungen.

Für Animationen, die im Remotion Studio bearbeitet werden sollen, behalte den interpolate()-Aufruf inline im style-Prop bei und verwende individuelle CSS-Transform-Eigenschaften (scale, translate, rotate) anstatt einen transform-String zu erstellen.

import { useCurrentFrame, Easing, interpolate, useVideoConfig } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Hello World!</div>;
};

Bevorzuge:

style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

Statt:

const scale = interpolate(frame, [0, 100], [0, 1]);

style={{
  transform: `scale(${scale})`,
}}

CSS-Übergänge oder -Animationen sind VERBOTEN – sie werden nicht korrekt gerendert. Tailwind-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.

Lege Assets im public/-Ordner auf deiner Projektebene ab.

Verwende staticFile(), um auf Dateien im public/-Ordner zu verweisen.

Füge Bilder mit der <Img>-Komponente hinzu:

import { Img, staticFile } from "remotion";

export const MyComposition = () => {
  return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};

Füge Videos mit der <Video>-Komponente aus @remotion/media hinzu:

import { Video } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};

Füge Audio mit der <Audio>-Komponente aus @remotion/media hinzu:

import { Audio } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Audio src={staticFile("audio.mp3")} />;
};

Assets können auch als entfernte URLs referenziert werden:

import { Video } from "@remotion/media";

export const MyComposition = () => {
  return <Video src="https://remotion.media/video.mp4" />
};

Um Inhalt zu verzögern, umschließe ihn mit <Sequence> und verwende from. Um die Dauer eines Elements zu begrenzen, verwende durationInFrames von <Sequence>. <Sequence> hat standardmäßig eine absolute Füllung. Für Inline-Inhalte verwende layout="none".

import { Sequence } from "remotion";

export const Title = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Title</div>;
};

export const Subtitle = () => {
  return <div>Subtitle</div>;
};

const Main = () => {
  const {fps} = useVideoConfig();

  return (
    <AbsoluteFill>
      <Sequence>
        <Background />
      </Sequence>
      <Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
        <Title />
      </Sequence>
      <Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
        <Subtitle />
      </Sequence>
    </AbsoluteFill>
  );
}

Breite, Höhe, fps und Dauer eines Videos werden in src/Root.tsx definiert:

import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      durationInFrames={100}
      fps={30}
      width={1080}
      height={1080}
    />
  );
};

Metadaten können auch dynamisch berechnet werden:

import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";

const calculateMetadata: CalculateMetadataFunction<
  MyCompositionProps
> = async ({ props, abortSignal }) => {
  const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
    signal: abortSignal,
  }).then((res) => res.json());

  return {
    durationInFrames: Math.ceil(data.duration * 30),
    props: {
      ...props,
      videoUrl: data.url,
    },
    width: 1080,
    height: 1080,
  };
};

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      fps={30}
      width={1080}
      height={1080}
      defaultProps={{ videoId: "abc123" }}
      calculateMetadata={calculateMetadata}
    />
  );
};

Vorschau starten

Starte das Remotion Studio, um eine Vorschau des Videos zu sehen:

npx remotion studio

Optional: Einzelbild-Rendering-Prüfung

Du kannst ein einzelnes Bild mit der CLI rendern, um Layout, Farben oder Timing zu überprüfen. Überspringe dies bei trivialen Änderungen, reinen Refactorings oder wenn du bereits genügend Vertrauen aus dem Studio oder vorherigen Rendering hast.

npx remotion still [composition-id] --scale=0.25 --frame=30

Bei 30 fps ist --frame=30 die Ein-Sekunden-Marke (--frame ist nullbasiert).

Untertitel

Wenn du mit Untertiteln arbeitest, lade die Datei ./rules/subtitles.md für weitere Informationen.

FFmpeg verwenden

Für einige Videooperationen, wie das Trimmen von Videos oder die Stille-Erkennung, sollte FFmpeg verwendet werden. Lade die Datei ./rules/ffmpeg.md für weitere Informationen.

Stille-Erkennung

Wenn du stille Abschnitte in Video- oder Audiodateien erkennen und trimmen musst, lade die Datei ./rules/silence-detection.md.

Audio-Visualisierung

Wenn du Audio visualisieren musst (Spektrumbalken, Wellenformen, bassreaktive Effekte), lade die Datei ./rules/audio-visualization.md für weitere Informationen.

Soundeffekte

Wenn du Soundeffekte benötigst, lade die Datei ./rules/sfx.md für weitere Informationen.

Visuelle und Pixeleffekte

Wenn du einen visuellen Effekt erstellst, bevorzuge: 1. normale Remotion/HTML/CSS/SVG/Filter/Blend/Mask-Animation, 2. einen gelisteten Effekt über rules/effects.md, auch bei HTML, das über <HtmlInCanvas> gerendert wird, 3. einen benutzerdefinierten createEffect() über rules/effects.md, wenn der Benutzer einen wiederverwendbaren/projektspezifischen Effekt wünscht, 4. benutzerdefiniertes <HtmlInCanvas onPaint> über rules/html-in-canvas.md nur, wenn kein Effekt passt.

Für Lichtlecks-Overlays siehe rules/light-leaks.md. Dokumentation: https://www.remotion.dev/docs/effects

Verfügbare Effekte: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), thermalVision(), blur(), linearProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().

3D-Inhalte

Siehe rules/3d.md für 3D-Inhalte in Remotion mit Three.js und React Three Fiber.

Erweitertes Audio

Siehe rules/audio.md für erweiterte Audio-Funktionen wie Trimmen, Lautstärke, Geschwindigkeit, Tonhöhe.

Dynamische Dauer, Abmessungen und Daten

Siehe rules/calculate-metadata.md für dynamisch gesetzte Kompositionsdauer, Abmessungen und Props.

Erweiterte Kompositionen

Siehe rules/compositions.md für die Definition von Standbildern, Ordnern, Standard-Props und für die Verschachtelung von Kompositionen.

Google Fonts

Ist der empfohlene Weg, um Schriftarten in Remotion zu laden. Siehe rules/google-fonts.md für das Laden von Google Fonts.

Lokale Schriftarten

Siehe rules/local-fonts.md zum Laden lokaler Schriftarten.

Audiodauer ermitteln

Siehe rules/get-audio-duration.md zum Ermitteln der Dauer einer Audiodatei in Sekunden mit Mediabunny.

Videoabmessungen ermitteln

Siehe rules/get-video-dimensions.md zum Ermitteln der Breite und Höhe einer Videodatei mit Mediabunny.

Videodauer ermitteln

Siehe rules/get-video-duration.md zum Ermitteln der Dauer einer Videodatei in Sekunden mit Mediabunny.

GIFs

Siehe rules/gifs.md für die Anzeige von GIFs synchronisiert mit Remotions Zeitleiste.

Erweiterte Bilder

Siehe rules/images.md für Größenanpassung und Positionierung von Bildern, dynamische Bildpfade und Ermittlung von Bildabmessungen.

Lottie-Animationen

Siehe rules/lottie.md zum Einbetten von Lottie-Animationen in Remotion.

DOM-Knoten messen

Siehe rules/measuring-dom-nodes.md zum Messen von DOM-Elementabmessungen in Remotion.

Text messen

Siehe rules/measuring-text.md zum Messen von Textabmessungen, Anpassen von Text an Behälter und Überprüfen von Überläufen.

Erweiterte Sequenzierung

Siehe rules/sequencing.md für weitere Sequenzierungsmuster – Verzögerung, Trimmen, Begrenzung der Dauer von Elementen.

TailwindCSS

Siehe rules/tailwind.md zur Verwendung von TailwindCSS in Remotion.

Textanimationen

Siehe rules/text-animations.md für Typografie- und Textanimationsmuster.

Erweitertes Timing

Siehe rules/timing.md für erweitertes Timing mit interpolate und Bézier-Easing sowie Federn.

Übergänge

Siehe rules/transitions.md für Szenenübergangsmuster.

Transparente Videos

Siehe rules/transparent-videos.md zum Rendern eines Videos mit Transparenz.

Trimmen

Siehe rules/trimming.md für Trimm-Muster – Abschneiden des Anfangs oder Endes von Animationen.

Erweiterte Videos

Siehe rules/videos.md für fortgeschrittenes Wissen zum Einbetten von Videos – Trimmen, Lautstärke, Geschwindigkeit, Schleifen, Tonhöhe.

Parametrisierte Videos

Siehe rules/parameters.md zum Parametrisieren einer Komposition durch Hinzufügen eines Zod-Schemas.

Karten

Für einfache Karten mit wenigen Überflügen, ziehe statische Kartenbilder in Betracht. Für komplexe Karten mit animierten Routen oder Überflügen lade die Kartenregel: rules/maplibre.md

Voiceover

Siehe rules/voiceover.md zum Hinzufügen von KI-generiertem Voiceover zu Remotion-Kompositionen mit ElevenLabs TTS.

Individual skills in this repo

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

Ministry-of-Technology-AU/next-platform

Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer perspectives with context-aware weighting.

Ministry-of-Technology-AU/next-platform

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Ministry-of-Technology-AU/next-platform

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

Verwandte Skills