Communitygithub.com

AbdelrhmanAlquran/claude-skills

Erstellen, debuggen und rendern Sie Videos programmatisch mit Remotion (React-basiertes Video-Framework).

Was ist claude-skills?

Diese Fertigkeit befähigt einen KI-Agenten, Videos mit Remotion zu erstellen, zu debuggen und zu rendern – einem React-basierten Framework, das React-Komponenten in MP4-Dateien umwandelt. Sie ist ideal für Entwickler, die programmatische, datengetriebene oder animierte Videos erstellen möchten, und deckt die Einrichtung von Kompositionen, Animationsmuster (interpolate, spring), Layoutkomponenten (Sequence, AbsoluteFill), Audio/Video/Image-Komponenten, die Studio-Vorschau sowie die Ausgabe über die CLI, @remotion/renderer oder Lambda ab. Die Fertigkeit enthält eine vollständige Referenz zu Kernkonzepten, Animationen, Rendering und Medien, sodass der Agent den Benutzer von der Projekterstellung über die Entwicklung bis hin zum finalen Rendering begleiten kann. Sie unterscheidet klar zwischen Remotion und KI-Videogenerierung (Veo, Sora usw.) und leitet die Benutzer bei Nicht-Remotion-Aufgaben an die entsprechende Fertigkeit weiter.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Remotion

Remotion verwandelt React-Komponenten in Videos. Sie schreiben JSX, Remotion ruft Ihre Komponente einmal pro Frame mit einer festen fps auf, und die resultierenden Frames werden zu einem MP4 (oder einem anderen Format) zusammengesetzt.

Gedankliches Kernmodell

Remotion gibt Ihnen eine Frames-Nummer und eine leere Leinwand. Ihre React-Komponente entscheidet, was in diesem Frame gerendert wird.

Es gibt keine Animations-Timeline im imperativen Sinne. Zeit ist eine Zahl (frame), und Ihre Komponente ist eine reine Funktion dieser Zahl plus Props. Deshalb müssen Animationen mit useCurrentFrame() gesteuert werden – CSS-Übergänge und setTimeout sind während des Renderns nicht deterministisch und führen zu Flackern oder Synchronisationsfehlern.

Wann diese Fertigkeit verwendet werden sollte

  • Der Benutzer hat ein Remotion-Projekt (remotion.config.ts oder @remotion/* in package.json) und möchte eine Komposition erstellen, ändern oder debuggen
  • Der Benutzer sagt „Lass uns ein Video mit Remotion/mit Code/programmatisch erstellen“
  • Der Benutzer fügt einen Remotion-Fehler ein oder fragt nach interpolate, spring, Sequence, useCurrentFrame, Composition usw.
  • Der Benutzer möchte ein bestehendes Remotion-Projekt rendern oder Lambda-Rendering einrichten

Wann NICHT zu verwenden

  • Video mit KI-Modellen erstellen (Veo, Sora, Runway, Kling, HeyGen) → verwenden Sie die video-Fertigkeit
  • Bestehende Videodateien bearbeiten (schneiden/trimmen/konkatenieren) → ffmpeg, nicht Remotion
  • Livestreaming → Remotion ist reines Offline-Rendering

Arbeitsablauf

  1. Projekt erkennen oder erstellen.

    • Neues Projekt: npx create-video@latest (interaktiv – wählt eine Vorlage wie Hello World, Blank, JavaScript, TikTok usw.)
    • Bestehend: Prüfen auf remotion.config.ts, src/Root.tsx und @remotion/cli in package.json. Notieren Sie die Remotion-Hauptversion – die APIs entwickeln sich weiter, und die korrekte Dokumentations-URL ist https://www.remotion.dev/docs (aktuellste) oder versionierte Seiten.
  2. Komposition lokalisieren oder erstellen. Kompositionen werden in src/Root.tsx über <Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} /> registriert. Die id ist das, was die CLI namentlich rendert.

  3. Komponente mit useCurrentFrame + useVideoConfig für Zeit und Metadaten erstellen. Layout mit <AbsoluteFill> zusammensetzen, Zeitabschnitte mit <Sequence>.

  4. Vorschau im Studio: npx remotion studio (automatisches Neuladen). Versuchen Sie nicht, Frames isoliert zu „testen“ – öffnen Sie das Studio.

  5. Rendern: npx remotion render <CompositionId> [output.mp4]. Standard-Codec ist H.264/MP4. Siehe references/rendering.md für Flags und programmatische API.

Kurze API-Referenz

In den verlinkten Dateien finden Sie Details – laden Sie diese nur, wenn eine Aufgabe sie benötigt.

ThemaDatei
Composition, Hooks, Sequence, AbsoluteFill, Layoutreferences/core-concepts.md
interpolate, spring, Easing, Staffelung, gängige Animationsmusterreferences/animation.md
Rendering: CLI-Flags, @remotion/renderer, Lambda, Codecs, Propsreferences/rendering.md
Audio/Video/Bilder: <Audio>, <Video>, <Img>, <OffthreadVideo>, Untertitelreferences/media.md
Projekteinrichtung, Dateikonventionen, remotion.config.tsreferences/project-setup.md
Gängige Muster: Schreibanimationen, Lower Thirds, datengetrieben, Parallaxereferences/patterns.md

Harte Regeln

  1. Mit useCurrentFrame() animieren. Niemals setTimeout, requestAnimationFrame oder CSS transition. Diese flackern beim Rendern, da jeder Frame unabhängig in einem Headless-Browser gerendert wird.
  2. durationInFrames ist erforderlich und muss eine ganze Zahl sein. Gesamtsekunden = durationInFrames / fps.
  3. Komponenten rein halten. Keine Side-Effects auf oberster Ebene, kein Math.random() ohne deterministischen Seed – derselbe Frame muss immer dieselben Pixel erzeugen.
  4. Nicht im Render-Fetch abrufen. Verwenden Sie delayRender()/continueRender(), um die Frame-Bereitschaft zu blockieren, während Daten geladen werden, oder rufen Sie vorab ab und übergeben Sie sie per Props.
  5. Wenn möglich <OffthreadVideo> anstelle von <Video> verwenden für nicht blockierende Video-Lesevorgänge während des Renderns (schneller, weniger Speicher).
  6. Dynamische Daten über --props (CLI) oder inputProps (Studio/programmatisch) übergeben, nicht durch Bearbeiten von Dateien.

Häufige Fehler

Fehler / SymptomUrsacheBehebung
Flackern / nicht übereinstimmende Bewegung in MP4 vs. Studio-VorschauCSS-Übergänge oder nicht frame-gesteuerte Animation verwendetErsetzen durch interpolate(frame, ...) oder spring({ frame, fps })
„Komposition nicht gefunden“Tippfehler in ID oder fehlende <Composition>-Registrierungsrc/Root.tsx überprüfen
Rendern hängtAusstehendes delayRender() hat nie continueRender() aufgerufenNicht aufgelöstes Promise finden; try/finally hinzufügen
Speichermangel bei langen Videos<Video> hält Frames im SpeicherAuf <OffthreadVideo> umstellen
Audio nicht synchronAudio-Datei-FPS stimmen nicht überein oder Start bei falschem Frame<Audio> in <Sequence from={...}> einwickeln

Überprüfung

Nach Änderungen immer:

  • npx remotion studio ausführen und die Zeitleiste durchgehen, um zu bestätigen, dass die Änderung an mehreren Frames korrekt aussieht (Anfang, Mitte, Ende)
  • Für programmatische Änderungen ein kurzes Testsegment rendern: npx remotion render <id> out.mp4 --frames=0-60
  • Typprüfung: npx tsc --noEmit, falls das Projekt TypeScript verwendet

Behaupten Sie keinen Erfolg ohne einen dieser Schritte. Code, der kompiliert, ist nicht dasselbe wie ein Video, das richtig aussieht.

Verwandte Skills