Communitygithub.com

Skript-zu-Remotion

Konvertieren Sie Videoskripte in produktionsreife Remotion-Projekte mit React-Komponenten, Audio und Rendering.

Was ist Skript-zu-Remotion?

Diese Fähigkeit verwandelt strukturierte Videoskripte (script.json) in vollständige, ausführbare Remotion-Projekte. Sie generiert für jede Szene des Skripts maßgeschneiderte React-Komponenten, die auf sechs verschiedenen Szenentypen basieren (Hook, Textanzeige, Zahlenvergleich, Dreispaltig, Fallstudie, Call-to-Action). Die Animationen nutzen ausschließlich Remotions `spring()`-Physik-Engine für flüssige, 60fps-Animationen und vermeiden CSS-Animationen. Optional können TTS-Audio über die Google Gemini API generiert und intelligent in Untertitel segmentiert werden. Das Projekt wird dann assembliert, Abhängigkeiten installiert und als MP4-Datei gerendert. Die Fähigkeit ist für Entwickler konzipiert, die mit Claude Code, Cursor oder anderen KI-Agenten arbeiten, und setzt die vorherige Verwendung der `article-to-script`-Fähigkeit voraus. Sie erzwingt die Einhaltung der `remotion-best-practices` für qualitativ hochwertige Komponenten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/joyehuang/skills/tree/HEAD/script-to-remotion

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Skript-zu-Remotion?

Konvertieren Sie strukturierte Videoskripte in ausführbare Remotion-Projekte, inklusive React-Komponenten-Generierung, TTS-Audio-Integration, Untertitel-Erstellung und Video-Rendering.

Verwendungsszenarien

Verwenden Sie diese Fähigkeit, wenn Sie:

  • script.json in ein Remotion-Videoprojekt umwandeln möchten
  • React-Komponenten gemäß den remotion-best-practices generieren möchten
  • Optional TTS-Audio (mit der Google Gemini API) erzeugen möchten
  • Automatische, intelligent segmentierte Untertitel benötigen
  • Das finale Video als MP4 rendern möchten

Nicht verwenden, wenn:

  • Sie direkt aus einem Artikel ein Skript generieren (dafür gibt es die Fähigkeit article-to-script)
  • Sie bestehende Videos bearbeiten oder schneiden möchten
  • Sie interaktive Videoinhalte erstellen möchten

Voraussetzungen

Erforderlich

  • script.json – Ausgabe der article-to-script-Fähigkeit
  • Node.js – Version 18+ und der Paketmanager pnpm
  • remotion-best-practices-Fähigkeit – Muss referenziert werden, um die Komponentenqualität sicherzustellen

Optional

  • Google Gemini API-Schlüssel – Für die TTS-Audio-Generierung
  • Hintergrundmusik – BGM-Datei bei Bedarf

Arbeitsablauf

Diese Fähigkeit folgt einem 4-Phasen-Arbeitsablauf:

Phase 1: Komponenten-Generierung (30–45 Minuten)

Generieren Sie React-Komponenten für jede Szene.

Ablauf:

  1. script.json einlesen
  2. Die remotion-best-practices-Fähigkeit referenzieren
  3. Für jeden Szenentyp die entsprechende Komponente generieren
  4. Sicherstellen, dass spring-Animationen (keine CSS-Animationen) verwendet werden
  5. fitText/measureText für die Textgrößenanpassung nutzen

Regeldatei: rules/component-generation.md Szenentypen-Leitfäden: rules/scene-types/*.md (6 Dateien)

Phase 2: Projekt-Assemblierung (15–20 Minuten)

Erstellen Sie die vollständige Remotion-Projektstruktur.

Ablauf:

  1. Projektverzeichnisstruktur anlegen
  2. package.json, tsconfig.json, remotion.config.ts kopieren
  3. Hauptkomponente Root.tsx erstellen
  4. Gemeinsame Komponenten kopieren (NeonBackground, Subtitle usw.)
  5. Themendatei (theme.ts) kopieren
  6. Abhängigkeiten installieren

Regeldatei: rules/project-assembly.md

Phase 3: TTS-Audio-Generierung (optional, 10–15 Minuten)

Generieren Sie TTS-Audio mit der Google Gemini API.

Ablauf:

  1. Eigenständiges Skript tts-generator.js erstellen
  2. Für jede Szene eine Audiodatei generieren
  3. 1,25-fache Wiedergabegeschwindigkeit anwenden
  4. Untertitel-Segmentdaten generieren
  5. Im Verzeichnis public/audio/ speichern

Regeldateien: rules/tts-integration.md, rules/subtitle-generation.md

Phase 4: Vorschau und Rendering (5–10 Minuten)

Starten Sie die Vorschau und rendern Sie das Video.

Ablauf:

  1. Remotion-Vorschauserver starten (pnpm start)
  2. Effekt im Browser prüfen
  3. Finales Video rendern (pnpm build)
  4. Ausgabe: video.mp4

Regeldatei: rules/render-configuration.md

Schnellstart

# 1. script.json vorbereiten
# Angenommen, es wurde bereits durch article-to-script generiert

# 2. remotion-best-practices referenzieren
Read .claude/skills/remotion-best-practices/skill.md

# 3. Regeln für script-to-remotion referenzieren
Read .claude/skills/script-to-remotion/rules/component-generation.md
Read .claude/skills/script-to-remotion/rules/scene-types/*.md

# 4. Komponenten generieren (für jede Szene)
# Je nach Szenentyp die entsprechende Vorlage und Regeln zur Code-Generierung auswählen

# 5. Projekt assemblieren
Read .claude/skills/script-to-remotion/rules/project-assembly.md
# Vollständige Projektstruktur gemäß der Anleitung erstellen

# 6. Optional: TTS generieren
Read .claude/skills/script-to-remotion/rules/tts-integration.md
# tts-generator.js erstellen und ausführen

# 7. Abhängigkeiten installieren
cd video-output-<timestamp>
pnpm install

# 8. Vorschau
pnpm start
# Browser öffnen: http://localhost:3000

# 9. Rendern
pnpm build
# Ausgabe: out/video.mp4

Kernfunktionen

Unterstützung von 6 Szenentypen

Jeder Szenentyp hat eine spezielle Vorlage und Animationen:

SzenentypDauerZweckHauptmerkmale
hook5–8 sEinstiegshakenSchreibmaschineneffekt, Spring-Animation
textDisplay15–20 sKerninformationen anzeigenfitText-Anpassung, Einblend-Animation
numberComparison12–18 sDatenvergleichZahlenanimation, Vorher-/Nachher-Layout
threeColumns15–20 sDreispaltiger VergleichVersetzte Anzeige, Serie
caseStudy20–30 sFallstudie/StoryTransitionSeries, Vorher-/Nachher-Übergang
cta8–12 sHandlungsaufforderungMehrschritt-Anzeige, Hervorhebungs-Animation

Spring-Physik-Animationen

Alle Animationen verwenden die spring()-Physik-Engine von Remotion:

const scale = spring({
  frame,
  fps,
  config: { damping: 12, stiffness: 100 }
});

CSS-Animationen sind verboten (verstoßen gegen remotion-best-practices).

Responsiver Text

Verwenden Sie @remotion/layout-utils, um die Textanpassung sicherzustellen:

import { fitText, measureText } from '@remotion/layout-utils';

const fittedText = fitText({
  text: narration,
  withinWidth: 1600,
  fontFamily: 'Inter',
  fontSize: 80
});

Intelligente Untertitel-Segmentierung

Lange Erzähltexte werden automatisch in leicht lesbare Untertitel segmentiert:

  • Natürliche Satztrennung an Satzzeichen
  • Jedes Segment 3–8 Sekunden lang
  • Ein-/Ausblendeffekt (0,2 Sekunden)
  • Perfekt synchronisiert mit dem Audio

Regeldateien

Alle Arbeitsablaufregeln sind im Verzeichnis rules/ dokumentiert:

Kernregeln:

  • component-generation.md – Leitfaden zur React-Komponenten-Generierung
  • project-assembly.md – Projektstruktur und Konfiguration
  • render-configuration.md – Remotion-Rendering-Einstellungen
  • troubleshooting.md – Häufige Probleme und Lösungen

Szenentypen-Leitfäden (6 Stück):

  • scene-types/hook-scene.md – Einstiegshaken-Szene
  • scene-types/text-display-scene.md – Textanzeige-Szene
  • scene-types/number-comparison-scene.md – Zahlenvergleich-Szene
  • scene-types/three-columns-scene.md – Dreispaltige Szene
  • scene-types/case-study-scene.md – Fallstudien-Szene
  • scene-types/cta-scene.md – CTA-Szene

Audio und Untertitel:

  • tts-integration.md – TTS-Audio-Generierung (optional)
  • subtitle-generation.md – Untertitel-Segmentierungsalgorithmus

Vorlagendateien

Einsatzbereite Code-Vorlagen im Verzeichnis templates/:

Konfigurationsdateien:

  • package.json.template – Projektabhängigkeiten
  • tsconfig.json.template – TypeScript-Konfiguration
  • remotion.config.ts.template – Remotion-Einstellungen
  • theme.ts – Neon-Glasmorphismus-Design

Gemeinsame Komponenten:

  • components/NeonBackground.tsx – Dynamischer Farbverlaufshintergrund
  • components/SceneAudio.tsx – Audio-Player
  • components/Subtitle.tsx – Untertitel-Komponente

Sonstige:

  • Root.tsx.template – Hauptkomponenten-Vorlage
  • tts-generator.js.template – TTS-Generierungsskript

Beispiele

  • examples/script-input.json – Beispiel-Eingabeskript
  • examples/Hook-scene-example.tsx – Vollständige Hook-Szenen-Komponente
  • examples/complete-project/ – Referenz für ein vollständiges Projekt

Bash-Befehle

Alle CLI-Operationen sind in commands/bash-commands.md dokumentiert:

  • Befehle zur Projekteinrichtung
  • Abhängigkeiten installieren
  • TTS-Generierung (optional)
  • Vorschau und Rendering
  • Fehlerbehandlung

Qualitätssicherung

remotion-best-practices sind zwingend einzuhalten

Wichtige Regeln:

  • ✅ spring() für alle Animationen verwenden
  • ✅ fitText/measureText für Textanpassung verwenden
  • ✅ Komponenten müssen reine Funktionen sein (keine Seiteneffekte)
  • ✅ useCurrentFrame() und useVideoConfig() korrekt verwenden
  • ❌ Keine CSS-Animationen oder -Übergänge verwenden
  • ❌ Kein useState/useEffect verwenden
  • ❌ Keine externen API-Aufrufe tätigen

Qualitätsstandards für Komponenten

Jede generierte Komponente muss:

  • Fehlerfrei mit TypeScript kompilieren
  • Den korrekten Typ exportieren (Szenenkomponente)
  • Props enthalten: startFrame, durationFrames, scene
  • Flüssige Animationen (60 fps) aufweisen
  • Klar lesbaren Text bieten
  • Ausreichenden Farbkontrast aufweisen

Fehlerbehebung

Häufige Probleme und Lösungen in rules/troubleshooting.md:

  • TypeScript-Kompilierungsfehler
  • Ruckelnde Animationen
  • Textüberlauf
  • Audio-Synchronisationsprobleme
  • Fehlgeschlagenes Rendering

Versionsverlauf

  • v3.0.0 (2025-01): Rein dokumentationsbasierte Fähigkeit, vorlagengetrieben
  • v2.1.0 (2024-12): CLI-gesteuerte Implementierung von Phase 4–8
  • v1.0.0 (2024-11): Erste monolithische Fähigkeit

Support

Bei Problemen:

  • Sehen Sie in rules/troubleshooting.md nach häufigen Fragen
  • Referenzieren Sie die Beispielimplementierungen in examples/
  • Ziehen Sie die Fähigkeit remotion-best-practices zu Rate
  • Prüfen Sie die offizielle Remotion-Dokumentation

Verwandte Fähigkeiten

  • article-to-script – Vorgelagert: generiert script.json
  • remotion-best-practices – Muss referenziert werden: stellt die Komponentenqualität sicher

Verwandte Skills