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.jsonin ein Remotion-Videoprojekt umwandeln möchten- React-Komponenten gemäß den
remotion-best-practicesgenerieren 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:
script.jsoneinlesen- Die
remotion-best-practices-Fähigkeit referenzieren - Für jeden Szenentyp die entsprechende Komponente generieren
- Sicherstellen, dass spring-Animationen (keine CSS-Animationen) verwendet werden
fitText/measureTextfü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:
- Projektverzeichnisstruktur anlegen
package.json,tsconfig.json,remotion.config.tskopieren- Hauptkomponente
Root.tsxerstellen - Gemeinsame Komponenten kopieren (NeonBackground, Subtitle usw.)
- Themendatei (
theme.ts) kopieren - 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:
- Eigenständiges Skript
tts-generator.jserstellen - Für jede Szene eine Audiodatei generieren
- 1,25-fache Wiedergabegeschwindigkeit anwenden
- Untertitel-Segmentdaten generieren
- 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:
- Remotion-Vorschauserver starten (
pnpm start) - Effekt im Browser prüfen
- Finales Video rendern (
pnpm build) - 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:
| Szenentyp | Dauer | Zweck | Hauptmerkmale |
|---|---|---|---|
| hook | 5–8 s | Einstiegshaken | Schreibmaschineneffekt, Spring-Animation |
| textDisplay | 15–20 s | Kerninformationen anzeigen | fitText-Anpassung, Einblend-Animation |
| numberComparison | 12–18 s | Datenvergleich | Zahlenanimation, Vorher-/Nachher-Layout |
| threeColumns | 15–20 s | Dreispaltiger Vergleich | Versetzte Anzeige, Serie |
| caseStudy | 20–30 s | Fallstudie/Story | TransitionSeries, Vorher-/Nachher-Übergang |
| cta | 8–12 s | Handlungsaufforderung | Mehrschritt-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-Generierungproject-assembly.md– Projektstruktur und Konfigurationrender-configuration.md– Remotion-Rendering-Einstellungentroubleshooting.md– Häufige Probleme und Lösungen
Szenentypen-Leitfäden (6 Stück):
scene-types/hook-scene.md– Einstiegshaken-Szenescene-types/text-display-scene.md– Textanzeige-Szenescene-types/number-comparison-scene.md– Zahlenvergleich-Szenescene-types/three-columns-scene.md– Dreispaltige Szenescene-types/case-study-scene.md– Fallstudien-Szenescene-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ängigkeitentsconfig.json.template– TypeScript-Konfigurationremotion.config.ts.template– Remotion-Einstellungentheme.ts– Neon-Glasmorphismus-Design
Gemeinsame Komponenten:
components/NeonBackground.tsx– Dynamischer Farbverlaufshintergrundcomponents/SceneAudio.tsx– Audio-Playercomponents/Subtitle.tsx– Untertitel-Komponente
Sonstige:
Root.tsx.template– Hauptkomponenten-Vorlagetts-generator.js.template– TTS-Generierungsskript
Beispiele
examples/script-input.json– Beispiel-Eingabeskriptexamples/Hook-scene-example.tsx– Vollständige Hook-Szenen-Komponenteexamples/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/measureTextfür Textanpassung verwenden - ✅ Komponenten müssen reine Funktionen sein (keine Seiteneffekte)
- ✅
useCurrentFrame()unduseVideoConfig()korrekt verwenden - ❌ Keine CSS-Animationen oder -Übergänge verwenden
- ❌ Kein
useState/useEffectverwenden - ❌ 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.mdnach häufigen Fragen - Referenzieren Sie die Beispielimplementierungen in
examples/ - Ziehen Sie die Fähigkeit
remotion-best-practiceszu 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