Communitygithub.com

echoleesong/claude-skills-plugin

Bewährte Vorgehensweisen für Remotion – Videoerstellung in React.

Was ist claude-skills-plugin?

Dieses Skill enthält gebündeltes Domänenwissen und Best Practices für die Arbeit mit Remotion, einer React-basierten Bibliothek zur programmatischen Videoproduktion. Es richtet sich an Entwickler, die Videoclips, Animationen oder komplette Filme mit Hilfe von React-Komponenten und -APIs erstellen möchten. Das Skill behandelt die Einrichtung neuer Projekte, die Gestaltung von Animationen mit `useCurrentFrame()` und `interpolate()`, die korrekte Einbindung von Assets (Bilder, Videos, Audio) sowie die zeitliche Ablaufsteuerung mit `<Sequence>`. Es unterstützt die Arbeit mit Untertiteln, FFmpeg, Audio-Visualisierung, Lottie-Animationen, TailwindCSS, dynamischen Metadaten, Schriftarten, GIFs, Karteninhalten, Sprachausgabe und vielen weiteren Spezialthemen. Der Fokus liegt stets auf Remotion-konformen Lösungen – CSS-Transformationen oder Tailwind-Animationen sind nicht erlaubt, da sie nicht korrekt rendern. Entwickler erhalten klare, sofort umsetzbare Codebeispiele und Querverweise auf vertiefende Regelwerke für fortgeschrittene Szenarien. Unterstützt wird die Nutzung in der Remotion Studio Preview und über die CLI (z. B. für Einzelbild-Renderings).

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/echoleesong/claude-skills-plugin/tree/HEAD/skills/remotion

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

Verwenden Sie dieses Skill immer dann, wenn Sie mit Remotion-Code arbeiten, um das domänenspezifische Wissen zu erhalten.

Neues Projekt einrichten

Wenn Sie sich in einem leeren Ordner oder Workspace ohne bestehendes Remotion-Projekt befinden, richten Sie eines mit folgendem Befehl ein:

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

Ersetzen Sie my-video durch einen passenden Projektnamen.

Ein Video gestalten

Animieren Sie Eigenschaften mit useCurrentFrame() und interpolate(). Verwenden Sie Easing, um das Timing der Animation anzupassen.

import { useCurrentFrame, Easing } 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>;
};

CSS-Transitionen oder -Animationen sind VERBOTEN – sie werden nicht korrekt rendern. Tailwind-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt rendern.

Legen Sie Assets im public/-Ordner im Projektstammverzeichnis ab.

Verwenden Sie staticFile(), um Dateien aus dem public/-Ordner zu referenzieren.

Fügen Sie 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ügen Sie 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ügen Sie 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 Remote-URLs referenziert werden:

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

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

Um Inhalte zeitlich zu verschieben, umschließen Sie sie mit <Sequence> und verwenden Sie from. Um die Dauer eines Elements zu begrenzen, verwenden Sie durationInFrames von <Sequence>. <Sequence> ist standardmäßig ein absolutes Füllelement. Für Inline-Inhalte verwenden Sie 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

Starten Sie das Remotion Studio, um eine Vorschau eines Videos zu sehen:

npx remotion studio

Optional: Einzelbild-Renderprüfung

Sie können mit der CLI ein einzelnes Bild rendern, um Layout, Farben oder Timing zu überprüfen. Überspringen Sie dies bei trivialen Änderungen, reinen Refactorings oder wenn Sie bereits ausreichend Vertrauen aus dem Studio oder früheren Renderings haben.

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 Sie mit Untertiteln oder Bildschirmtexten arbeiten, laden Sie die Datei ./rules/subtitles.md für weitere Informationen.

FFmpeg verwenden

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

Stille-Erkennung

Wenn stille Segmente in Video- oder Audiodateien erkannt und getrimmt werden müssen, laden Sie die Datei ./rules/silence-detection.md.

Audio-Visualisierung

Wenn Audio visualisiert werden soll (Spektrumbalken, Wellenformen, bassreaktive Effekte), laden Sie die Datei ./rules/audio-visualization.md für weitere Informationen.

Soundeffekte

Wenn Soundeffekte verwendet werden sollen, laden Sie die Datei ./rules/sfx.md für weitere Informationen.

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 Audiofunktionen wie Trimmen, Lautstärke, Geschwindigkeit und Tonhöhe.

Dynamische Dauer, Abmessungen und Daten

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

Erweiterte Kompositionen

Siehe rules/compositions.md für die Definition von Standbildern, Ordnern, Standardeigenschaften und 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 für das Laden lokaler Schriftarten.

Audiodauer ermitteln

Siehe rules/get-audio-duration.md für die Ermittlung der Dauer einer Audiodatei in Sekunden mit Mediabunny.

Videoabmessungen ermitteln

Siehe rules/get-video-dimensions.md für die Ermittlung der Breite und Höhe einer Videodatei mit Mediabunny.

Videodauer ermitteln

Siehe rules/get-video-duration.md für die Ermittlung der Dauer einer Videodatei in Sekunden mit Mediabunny.

GIFs

Siehe rules/gifs.md für die Darstellung von GIFs synchronisiert mit der Remotion-Zeitleiste.

Erweiterte Bilder

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

Lichtlecks

Siehe rules/light-leaks.md für Lichtleck-Überlagerungseffekte mit @remotion/light-leaks.

Lottie-Animationen

Siehe rules/lottie.md für das Einbetten von Lottie-Animationen in Remotion.

HTML im Canvas

Siehe rules/html-in-canvas.md, wenn Sie HTML in ein <canvas> rendern müssen, um 2D- oder WebGL-Effekte über <HtmlInCanvas> anzuwenden.

DOM-Knoten messen

Siehe rules/measuring-dom-nodes.md für das Messen von DOM-Elementabmessungen in Remotion.

Text messen

Siehe rules/measuring-text.md für das Messen von Textabmessungen, das Anpassen von Text an Container und die Überlaufprüfung.

Erweiterte Sequenzierung

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

TailwindCSS

Siehe rules/tailwind.md für die 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 Bezier-Easing sowie Federn.

Übergänge

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

Transparente Videos

Siehe rules/transparent-videos.md für das Rendern eines Videos mit Transparenz.

Trimmen

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

Erweiterte Videos

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

Parametrisierte Videos

Siehe rules/parameters.md für die Parametrisierung einer Komposition durch Hinzufügen eines Zod-Schemas.

Karten

Für einfache Karten mit wenigen Überflügen sollten Sie statische Kartenbilder in Betracht ziehen. Für komplexe Karten mit animierten Routen oder Überflügen laden Sie die Kartenregel: rules/maplibre.md

Sprachausgabe

Siehe rules/voiceover.md für das Hinzufügen von KI-generierter Sprachausgabe zu Remotion-Kompositionen mit ElevenLabs TTS.

Verwandte Skills