Communitygithub.com

joyehuang/skills

Convertit des scripts vidéo en projets Remotion prêts à produire, avec des composants React, de l'audio et du rendu.

Qu'est-ce que skills ?

Cette compétence transforme un script vidéo structuré (au format JSON) en un projet Remotion complet et opérationnel. Elle génère automatiquement des composants React conformes aux meilleures pratiques de Remotion, intègre de l'audio via TTS (optionnellement avec Google Gemini API), crée des sous-titres intelligemment segmentés et produit une vidéo MP4 finale. Principalement utilisée avec des agents de codage comme Claude Code ou Cursor, elle suit un workflow en quatre étapes : génération de composants, assemblage du projet, génération audio TTS (optionnelle), et prévisualisation/rendu. Le système prend en charge six types de scènes (accroche, affichage de texte, comparaison numérique, trois colonnes, étude de cas, appel à l'action), tous animés avec le moteur physique spring() de Remotion. Elle nécessite Node.js 18+, pnpm, le script JSON d'entrée et fait obligatoirement référence à la compétence 'remotion-best-practices' pour garantir la qualité des composants. Un ensemble de règles Markdown et de templates prêts à l'emploi guide chaque phase.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.json en 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 :

  1. Lire le fichier script.json
  2. Consulter la compétence remotion-best-practices
  3. Générer les composants correspondant à chaque type de scène
  4. Utiliser des animations spring (pas d'animations CSS)
  5. 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 :

  1. Créer la structure des répertoires du projet
  2. Copier package.json, tsconfig.json, remotion.config.ts
  3. Créer le composant principal Root.tsx
  4. Copier les composants partagés (NeonBackground, Subtitle, etc.)
  5. Copier le fichier de thème (theme.ts)
  6. 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 :

  1. Créer un script autonome tts-generator.js
  2. Générer les fichiers audio pour chaque scène
  3. Appliquer une vitesse de lecture 1,25x
  4. Générer les données de segmentation des sous-titres
  5. 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 :

  1. Démarrer le serveur de prévisualisation Remotion (pnpm start)
  2. Vérifier le rendu dans le navigateur
  3. Effectuer le rendu final de la vidéo (pnpm build)
  4. 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èneDuréeUtilisationCaractéristique clé
hook5-8sAccroche d'ouvertureEffet machine à écrire, animation rebond
textDisplay15-20sAffichage d'informations clésfitText adaptatif, animation glissée
numberComparison12-18sComparaison de donnéesAnimation de chiffres, mise en page avant/après
threeColumns15-20sComparaison trois colonnesAffichage décalé, séquence Series
caseStudy20-30sHistoire de casTransitionSeries, transition avant/après
cta8-12sAppel à l'actionAffichage 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 React
  • project-assembly.md - Structure et configuration du projet
  • render-configuration.md - Configuration du rendu Remotion
  • troubleshooting.md - Résolution des problèmes courants

Guides des types de scènes (6) :

  • scene-types/hook-scene.md - Scène d'accroche
  • scene-types/text-display-scene.md - Scène d'affichage de texte
  • scene-types/number-comparison-scene.md - Scène de comparaison numérique
  • scene-types/three-columns-scene.md - Scène trois colonnes
  • scene-types/case-study-scene.md - Scène d'étude de cas
  • scene-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 projet
  • tsconfig.json.template - Configuration TypeScript
  • remotion.config.ts.template - Paramètres Remotion
  • theme.ts - Thème verre néon

Composants partagés :

  • components/NeonBackground.tsx - Fond dégradé dynamique
  • components/SceneAudio.tsx - Lecteur audio
  • components/Subtitle.tsx - Composant de sous-titres

Autres :

  • Root.tsx.template - Template du composant principal
  • tts-generator.js.template - Script de génération TTS

Exemples

  • examples/script-input.json - Exemple de script d'entrée
  • examples/Hook-scene-example.tsx - Composant complet d'une scène hook
  • examples/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.md pour 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

Skills associés