Communitygithub.com

Enricrypto/cypher-claude-skills

Best Practices für Remotion – Videoerstellung in React

Was ist cypher-claude-skills?

Diese Sammlung von Skills und Regeln ist der umfassende Leitfaden für die Arbeit mit Remotion, einer Bibliothek zur Erstellung von Videos mit React. Sie bietet domain-spezifisches Wissen für Entwickler, die in Remotion-Projekten arbeiten, und deckt alles von der Einrichtung neuer Projekte bis zu fortgeschrittenen Animationen und Medienhandling ab. Die Skills unterstützen gängige KI-Agenten-Plattformen wie Claude Code, Cursor und Codex, indem sie klar strukturierte Markdown-Dateien bereitstellen. Enthalten sind Best Practices für Animationen mittels `useCurrentFrame()` und `interpolate()`, die Verwendung von `<Sequence>` zur zeitlichen Steuerung von Inhalten sowie die Integration von Assets wie Bildern, Videos und Audio. Darüber hinaus werden spezialisierte Themen behandelt: Untertitel, FFmpeg-Operationen, Audio-Visualisierung, 3D-Inhalte, Lottie-Animationen, Google Fonts, dynamische Metadaten und vieles mehr. Jeder Skill verweist auf dedizierte Regeln, die tiefgehende Implementierungsdetails bieten und so eine konsistente und effiziente Videoentwicklung mit Remotion sicherstellen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Enricrypto/cypher-claude-skills/tree/HEAD/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 Skills immer dann, wenn du mit Remotion-Code arbeitest, um domänenspezifisches Wissen zu erhalten.

Neue Projekteinrichtung

Wenn du einen leeren Ordner oder einen Arbeitsbereich ohne bestehendes Remotion-Projekt hast, richte ein neues mit folgendem Befehl ein:

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

Ersetze my-video mit einem passenden Projektnamen.

Entwerfen eines Videos

Animiere Eigenschaften mit useCurrentFrame() und interpolate(). Verwende 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 gerendert.
Tailwind-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.

Lege Assets im Ordner public/ im Stammverzeichnis deines Projekts ab.

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

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 Inhalte zu verzögern, umschließe sie mit <Sequence> und verwende from. Um die Dauer eines Elements zu begrenzen, verwende durationInFrames von <Sequence>. <Sequence> ist 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>
  );
}

Die 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 ein Video in der Vorschau anzusehen:

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 genug Vertrauen aus dem Studio oder vorherigen Renderings 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 (Captions)

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 Erkennung von Stille sollte FFmpeg verwendet werden. Lade die Datei ./rules/ffmpeg.md für weitere Informationen.

Stille-Erkennung (Silence detection)

Wenn du stille Segmente aus 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 verwenden musst, lade 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.

Fortgeschrittene Audio-Features

Siehe rules/audio.md für fortgeschrittene 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.

Fortgeschrittene Kompositionen

Siehe rules/compositions.md zur Definition von Standbildern, Ordnern, Standard-Props und zur Verschachtelung von Kompositionen.

Google Fonts

Ist die empfohlene Methode zum Laden von Schriftarten in Remotion. Siehe rules/google-fonts.md zum 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 zur Anzeige von GIFs synchronisiert mit der Zeitleiste von Remotion.

Fortgeschrittene Bilder

Siehe rules/images.md zur Größenanpassung und Positionierung von Bildern, dynamischen Bildpfaden und zum Ermitteln von Bildabmessungen.

Lichtlecks (Light leaks)

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

Lottie-Animationen

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

HTML in Canvas

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

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 Container und Überprüfen von Überläufen.

Fortgeschrittene 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.

Fortgeschrittenes Timing

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

Übergänge (Transitions)

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.

Fortgeschrittene Videos

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

Parametrisierte Videos

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

Karten

Für einfache Karten mit kleinen Überflügen (Flyovers) erwäge die Verwendung statischer Kartenbilder. 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 1 individual skill — each has its own dedicated page.

Verwandte Skills