script-to-remotion
Convertit des scripts vidéo structurés en projets Remotion exécutables, incluant la génération de composants React, l'intégration audio TTS, la création de sous-titres et le rendu vidéo.
Cas d'utilisation
Utilisez cette compétence lorsque vous devez :
- Convertir un
script.jsonen projet vidéo Remotion - Générer des composants React conformes aux
remotion-best-practices - Générer optionnellement de l'audio TTS (via Google Gemini API)
- Générer automatiquement des sous-titres segmentés intelligemment
- Effectuer le rendu final de la vidéo (format MP4)
À ne pas utiliser lorsque :
- Vous générez un script directement à partir d'un article (utilisez la compétence
article-to-script) - Vous éditez une vidéo existante ou effectuez du montage
- Vous créez du contenu vidéo interactif
Prérequis
Requis
- script.json - Sortie de la compétence
article-to-script - Node.js - Version 18+ et gestionnaire de paquets pnpm
- Compétence remotion-best-practices - Doit être consultée pour garantir la qualité des composants
Optionnel
- Clé API Google Gemini - Pour la génération audio TTS
- Musique de fond - Fichier BGM si nécessaire
Workflow
Cette compétence suit un workflow en 4 étapes :
Étape 1 : Génération des composants (30-45 minutes)
Génère les composants React pour chaque scène.
Processus :
- Lire le fichier script.json
- Consulter la compétence remotion-best-practices
- Générer les composants correspondant à chaque type de scène
- Utiliser des animations spring (pas d'animations CSS)
- Utiliser fitText/measureText pour gérer les dimensions du texte
Fichier de règles : rules/component-generation.md
Guide des types de scènes : rules/scene-types/*.md (6 fichiers)
Étape 2 : Assemblage du projet (15-20 minutes)
Crée la structure complète du projet Remotion.
Processus :
- Créer la structure des répertoires du projet
- Copier package.json, tsconfig.json, remotion.config.ts
- Créer le composant principal Root.tsx
- Copier les composants partagés (NeonBackground, Subtitle, etc.)
- Copier le fichier de thème (theme.ts)
- Installer les dépendances
Fichier de règles : rules/project-assembly.md
Étape 3 : Génération audio TTS (optionnelle, 10-15 minutes)
Utilise l'API Google Gemini pour générer l'audio TTS.
Processus :
- Créer un script autonome tts-generator.js
- Générer les fichiers audio pour chaque scène
- Appliquer une vitesse de lecture 1,25x
- Générer les données de segmentation des sous-titres
- Sauvegarder dans le répertoire public/audio/
Fichiers de règles : rules/tts-integration.md, rules/subtitle-generation.md
Étape 4 : Prévisualisation et rendu (5-10 minutes)
Lance la prévisualisation et effectue le rendu de la vidéo.
Processus :
- Démarrer le serveur de prévisualisation Remotion (
pnpm start) - Vérifier le rendu dans le navigateur
- Effectuer le rendu final de la vidéo (
pnpm build) - Obtenir le fichier video.mp4
Fichier de règles : rules/render-configuration.md
Démarrage rapide
# 1. Préparer script.json
# En supposant qu'il a été généré via article-to-script
# 2. Consulter remotion-best-practices
Read .claude/skills/remotion-best-practices/skill.md
# 3. Consulter les règles de script-to-remotion
Read .claude/skills/script-to-remotion/rules/component-generation.md
Read .claude/skills/script-to-remotion/rules/scene-types/*.md
# 4. Générer les composants (pour chaque scène)
# Choisir le template et les règles en fonction du type de scène
# 5. Assembler le projet
Read .claude/skills/script-to-remotion/rules/project-assembly.md
# Suivre les instructions pour créer la structure complète du projet
# 6. Optionnel : Générer le TTS
Read .claude/skills/script-to-remotion/rules/tts-integration.md
# Créer et exécuter tts-generator.js
# 7. Installer les dépendances
cd video-output-<timestamp>
pnpm install
# 8. Prévisualiser
pnpm start
# Accéder à http://localhost:3000 dans le navigateur
# 9. Effectuer le rendu
pnpm build
# Sortie dans out/video.mp4
Fonctionnalités principales
Prise en charge de 6 types de scènes
Chaque type de scène dispose de templates et d'animations dédiés :
| Type de scène | Durée | Utilisation | Caractéristique clé |
|---|---|---|---|
| hook | 5-8s | Accroche d'ouverture | Effet machine à écrire, animation rebond |
| textDisplay | 15-20s | Affichage d'informations clés | fitText adaptatif, animation glissée |
| numberComparison | 12-18s | Comparaison de données | Animation de chiffres, mise en page avant/après |
| threeColumns | 15-20s | Comparaison trois colonnes | Affichage décalé, séquence Series |
| caseStudy | 20-30s | Histoire de cas | TransitionSeries, transition avant/après |
| cta | 8-12s | Appel à l'action | Affichage en plusieurs étapes, animation accentuée |
Animations physiques Spring
Toutes les animations utilisent le moteur physique spring() de Remotion :
const scale = spring({
frame,
fps,
config: { damping: 12, stiffness: 100 }
});
Interdiction d'utiliser des animations CSS (enfreint les remotion-best-practices)
Texte responsive
Utilise @remotion/layout-utils pour garantir l'adaptation du texte :
import { fitText, measureText } from '@remotion/layout-utils';
const fittedText = fitText({
text: narration,
withinWidth: 1600,
fontFamily: 'Inter',
fontSize: 80
});
Segmentation intelligente des sous-titres
Divise automatiquement les longues narrations en sous-titres lisibles :
- Césure naturelle aux signes de ponctuation
- Chaque segment dure entre 3 et 8 secondes
- Effet fondu entrant/sortant (0,2 seconde)
- Synchronisation parfaite avec l'audio
Fichiers de règles
Toutes les règles du workflow sont documentées dans le répertoire rules/ :
Règles principales :
component-generation.md- Guide de génération des composants Reactproject-assembly.md- Structure et configuration du projetrender-configuration.md- Configuration du rendu Remotiontroubleshooting.md- Résolution des problèmes courants
Guides des types de scènes (6) :
scene-types/hook-scene.md- Scène d'accrochescene-types/text-display-scene.md- Scène d'affichage de textescene-types/number-comparison-scene.md- Scène de comparaison numériquescene-types/three-columns-scene.md- Scène trois colonnesscene-types/case-study-scene.md- Scène d'étude de casscene-types/cta-scene.md- Scène d'appel à l'action
Audio et sous-titres :
tts-integration.md- Génération audio TTS (optionnelle)subtitle-generation.md- Algorithme de segmentation des sous-titres
Fichiers de templates
Des templates de code prêts à l'emploi se trouvent dans le répertoire templates/ :
Fichiers de configuration :
package.json.template- Dépendances du projettsconfig.json.template- Configuration TypeScriptremotion.config.ts.template- Paramètres Remotiontheme.ts- Thème verre néon
Composants partagés :
components/NeonBackground.tsx- Fond dégradé dynamiquecomponents/SceneAudio.tsx- Lecteur audiocomponents/Subtitle.tsx- Composant de sous-titres
Autres :
Root.tsx.template- Template du composant principaltts-generator.js.template- Script de génération TTS
Exemples
examples/script-input.json- Exemple de script d'entréeexamples/Hook-scene-example.tsx- Composant complet d'une scène hookexamples/complete-project/- Référence de projet complet
Commandes Bash
Toutes les opérations CLI sont documentées dans commands/bash-commands.md :
- Commandes de configuration du projet
- Installation des dépendances
- Génération TTS (optionnelle)
- Prévisualisation et rendu
- Gestion des erreurs
Assurance qualité
Doit impérativement suivre les remotion-best-practices
Règles clés :
- ✅ Utiliser spring() pour toutes les animations
- ✅ Utiliser fitText/measureText pour le texte
- ✅ Les composants doivent être des fonctions pures (sans effets de bord)
- ✅ Utiliser correctement useCurrentFrame() et useVideoConfig()
- ❌ Ne pas utiliser d'animations ou de transitions CSS
- ❌ Ne pas utiliser useState/useEffect
- ❌ Ne pas effectuer d'appels API externes
Critères de qualité des composants
Chaque composant généré doit :
- Être compilé sans erreur TypeScript
- Exporter le bon type (composant de scène)
- Accepter les props startFrame, durationFrames, scene
- Avoir des animations fluides (60fps)
- Avoir un texte clair et lisible
- Présenter un contraste de couleurs suffisant
Dépannage
Les problèmes courants et leurs solutions se trouvent dans rules/troubleshooting.md :
- Erreurs de compilation TypeScript
- Animations saccadées
- Débordement de texte
- Problèmes de synchronisation audio
- Échecs de rendu
Historique des versions
- v3.0.0 (2025-01) : Compétence purement documentaire, pilotée par templates
- v2.1.0 (2024-12) : Implémentation pilotée par CLI des phases 4 à 8
- v1.0.0 (2024-11) : Compétence monolithique initiale
Assistance
En cas de problème :
- Consultez
rules/troubleshooting.mdpour les problèmes courants - Référez-vous aux implémentations dans
examples/ - Consultez la compétence
remotion-best-practices - Vérifiez la documentation officielle de Remotion
Compétences connexes
- article-to-script - Amont : génère le fichier script.json
- remotion-best-practices - Référence obligatoire : garantit la qualité des composants