Communitygithub.com

remotion-topic-explainer

Montre à un agent comment planifier, construire ou monter une vidéo explicative avec Remotion, en produisant un montage vidéo final.

Qu'est-ce que remotion-topic-explainer ?

Cette compétence guide la création de vidéos explicatives courtes (60-90 secondes) au format vertical (1080x1920, 30 ips) pour TikTok, YouTube Shorts ou Reels. Elle combine les meilleures pratiques visuelles de Remotion (animations spring, interpolations verrouillées, composition de séquences), la synthèse vocale via Edge TTS ou CIT Voice Studio, et une synchronisation précise des durées audio avec les trames Remotion. La structure suit le framework Hook-Problème-Solution-Valeur-Outro, avec un pipeline automatisé de génération de voix, d'audio et de code. Elle est conçue pour les agents d'IA (par exemple, Cursor, Codex) qui doivent produire des vidéos complètes à partir d'un simple sujet. Le processus intègre la gestion des tampons de transition, les effets sonores, et les règles de codage Remotion pour garantir un rendu professionnel.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/hoangtuanqn/remotion-template/tree/HEAD/.agents/skills/remotion-topic-explainer

Demander à votre IA préférée

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

Documentation

Compétence : Vidéo Explicative Remotion (60-90s)

Cette compétence vous guide dans la création de vidéos explicatives courtes de haute qualité, de 60 à 90 secondes (format TikTok / YouTube Shorts / Reels : 1080x1920 à 30 ips) à partir de n'importe quel sujet.

Elle combine :

  1. Les meilleures pratiques visuelles de remotion-dev/skills (ressorts précis aux trames, interpolations verrouillées, composition de séquences, hiérarchie typographique).
  2. La synthèse vocale via TTS_PROVIDER dans .env : edge (edge-tts-universal, en ligne, gratuit) ou cit (CIT Voice Studio, voix studio vietnamiennes hors ligne - téléchargement sur github.com/Cuongyd196/cit-voice-studio, documentation API : docs/cit-voice-studio.md).
  3. Une synchronisation temporelle exacte qui mappe les longueurs des voix off directement dans les séquences de trames Remotion.

1. Structure et Timing de la Vidéo (60-90s / 1800-2700 trames à 30 ips)

Une vidéo courte captivante suit le framework Hook-Problème-Solution-Valeur-Outro :

ScèneNomDuréePlage de trames (@ 30 ips)Objectif et Visuels
1Hook0s – 6s~180 tramesPromesse ou question intrigante avec un chiffre, dite dans les 2 premières secondes. Grand titre, effet d'accroche du video-style.
2Contexte / Point de douleur6s – 17s~330 tramesÉnonce le problème ou le contexte expliquant pourquoi ce sujet est important. Deux cartes opposées glissent depuis les côtés.
3Concept Clé Partie 117s – 32s~450 trames1er principe fondamental : carte en verre dépoli, mots-clés en évidence.
4Concept Clé Partie 232s – 48s~480 tramesMécanisme de fonctionnement : processus en 3 étapes, lignes de connexion qui se dévoilent progressivement.
5Impact dans le Monde Réel48s – 64s~480 tramesApplication pratique, conseil ou compteur de données.
6Outro et Appel à l'Action64s – 75s~330 tramesUne phrase puissante en guise de conclusion, bouton d'abonnement.

Pour atteindre 90s, ajoutez 1 à 2 scènes supplémentaires (exemple concret, note importante) avant l'Outro. Toute scène de plus de 13s doit être divisée en deux.

Durée totale : 1800 à 2700 trames (environ 60 à 90 secondes).


2. Génération de la Voix Off TTS (edge | cit)

2.1 Configuration de la Voix via .env

Assurez-vous que le fichier .env est configuré (voir .env.example pour plus de détails) :

TTS_PROVIDER=edge                    # edge | cit
TTS_OUTPUT_DIR=public/audio

# Edge TTS (TTS_PROVIDER=edge)
EDGE_TTS_VOICE=vi-VN-HoaiMyNeural    # ou vi-VN-NamMinhNeural, en-US-ChristopherNeural
EDGE_TTS_RATE=+10%                   # +10% à +15% pour un rythme rapide et engageant dans les vidéos courtes

# CIT Voice Studio (TTS_PROVIDER=cit)
CIT_TTS_BASE_URL=http://127.0.0.1:8001
CIT_TTS_VOICE=Hải Đăng               # liste des voix : docs/cit-voice-studio.md ou GET /voices
CIT_TTS_SPEED=1.1                    # 0.5 - 2.0

Lorsque TTS_PROVIDER=cit :

  • L'application CIT Voice Studio doit être ouverte. Le script appelle automatiquement GET /health avant de générer l'audio ; s'il signale une absence de connexion, invitez l'utilisateur à ouvrir l'application (ou téléchargez-la sur github.com/Cuongyd196/cit-voice-studio).
  • Le dialogue peut inclure des balises émotionnelles [crire], [soupir], [raclement de gorge] et la balise de pause [pause 0.5s] (elles ne seront pas lues à voix haute). Ne pas abuser : maximum 1 balise par scène.
  • Erreur 400 Voice not found = nom de voix incorrect (respectez les accents). Vérifiez CIT_TTS_VOICE.

2.2 Procédure de Génération des Fichiers Audio

Lorsque vous recevez un sujet, commencez par créer le dossier src/<NomDuSujet>/, car src/<NomDuSujet>/audioData.ts n'est généré que si ce dossier existe déjà. Ensuite, créez scripts/generate-<sujet>-audio.ts et exécutez-le pour générer l'audio :

import { generateTopicVoices } from "./generate-tts";

const scenes = [
  {
    id: "scene1_hook",
    text: "Savez-vous ce qu'est Docker et pourquoi chaque développeur en a besoin ?",
  },
  {
    id: "scene2_problem",
    text: "Avant, la phrase 'ça marche sur ma machine' était un cauchemar lors de la livraison du produit.",
  },
  {
    id: "scene3_concept1",
    text: "Docker résout ce problème avec les conteneurs : empaqueter tout le code et l'environnement en un seul bloc.",
  },
  {
    id: "scene4_concept2",
    text: "Contrairement aux machines virtuelles lourdes, Docker partage le noyau du système d'exploitation, ce qui permet un démarrage en un clin d'œil.",
  },
  {
    id: "scene5_impact",
    text: "Grâce à cela, vous déployez des applications en douceur sur n'importe quel serveur, d'AWS et GCP aux VPS bon marché.",
  },
  {
    id: "scene6_outro",
    text: "Abonnez-vous à la chaîne pour maîtriser chaque jour des connaissances technologiques concises !",
  },
];

generateTopicVoices("DockerShort", scenes).catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

Les fichiers audio seront automatiquement sauvegardés dans public/audio/<NomDuSujet>/<sceneId>.<ext> (.mp3 pour edge, .wav pour cit) avec un fichier manifest.json enregistrant le nombre exact de trames (durationInFrames) et le audioPath pour chaque scène.

  • Options par scène : voice (voix du fournisseur sélectionné), rate/pitch/volume (edge uniquement), speed 0.5-2.0 (cit uniquement).
  • Les fichiers existants sont réutilisés (cache). Pour régénérer après modification du script ou changement de voix, supprimez d'abord le fichier audio correspondant.

3. Règles de Codage Remotion (issues de remotion-dev/skills)

Lors de l'écriture du code source Remotion, vous DEVEZ respecter les principes suivants :

3.1 Utilisation des Animations Spring

N'utilisez pas de keyframes/transitions CSS ou d'easing linéaire sans vie. Utilisez spring() :

import { spring, useCurrentFrame, useVideoConfig } from "remotion";

const frame = useCurrentFrame();
const { fps } = useVideoConfig();

// Spring rebondissant et fluide pour les Cartes/Icônes
const scale = spring({
  frame,
  fps,
  config: {
    damping: 12,    // Moins de 15 crée un rebond élastique naturel
    stiffness: 100,  // Tension
    mass: 0.8,
  },
});

const entrance = spring({
  frame: frame - 10, // Délai de 10 trames
  fps,
  from: 50,
  to: 0,
});

3.2 Interpolation Sécurisée (Toujours Verrouillée)

Fournissez toujours extrapolateLeft: "clamp" et extrapolateRight: "clamp" pour éviter les dépassements de valeurs lorsque la timeline sort de la plage :

import { interpolate } from "remotion";

const opacity = interpolate(frame, [0, 15], [0, 1], {
  extrapolateLeft: "clamp",
  extrapolateRight: "clamp",
});

3.3 Intégration Audio et Synchronisation des Séquences

Chaque scène dans la Composition utilise <Sequence> ou <Series> pour gérer le timing avec précision :

import { Audio, staticFile, Sequence } from "remotion";

// Dans le composant Scene - récupérez le chemin depuis le manifest, NE codez PAS en dur l'extension .mp3 (le fournisseur cit génère du .wav) :
<Sequence from={0} durationInFrames={sceneDuration}>
  <Audio src={staticFile(audioManifest.scenes[0].audioPath)} />
  <SceneContent />
</Sequence>
  1. Tampon de Transition Concis (Snappy Transition Buffer) :
    • Le tampon entre les scènes doit être de +3 à +4 trames (environ 0,1s) après la fin de la voix off.
    • Évitez les tampons trop longs (+15 à +20 trames) qui créent des silences/morts rythmiques entre les scènes. La scène suivante doit apparaître immédiatement après la phrase précédente pour maintenir un rythme soutenu et captivant pour les vidéos courtes.
// Exemple de calcul des durées des scènes dans une Series
// Les valeurs du manifest incluent déjà un tampon de 10 trames, donc soustrayez-les avant d'ajouter le nouveau tampon.
const d1 = audioManifest.scenes[0].durationInFrames - 10 + 3;
const d2 = audioManifest.scenes[1].durationInFrames - 10 + 3;
// ...

3.4 Normes de Conception Visuelle (Vertical 1080x1920)

L'ensemble du style (fond, cartes en verre dépoli, marque, tailles de police, mise en page, sous-titres, mouvements, accroche) suit la compétence video-style. Copiez theme.ts et components/ depuis src/ClaudeBugHunterRepo/. N'utilisez pas d'emoji ou d'icônes décoratives dans le texte.


4. Processus de Création Vidéo Étape par Étape pour Antigravity / Codex

Lorsque vous recevez la demande : "Créez une vidéo explicative sur [Sujet X]" :

Étape 1 : Écrire le Script

  1. Identifiez les 6 scènes (Hook, Problème, Concept 1, Concept 2, Impact, Outro).
  2. Rédigez un dialogue en français (ou vietnamien) naturel, concis, avec des phrases courtes (total de 260 à 330 mots, 35 à 50 mots par scène). La scène 1 commence par une promesse ou un résultat concret ; voir la section Accroche et Dialogue de video-style.

Étape 2 : Générer la Voix Off (TTS)

  1. Lisez TTS_PROVIDER dans .env pour savoir si vous utilisez edge ou cit.
  2. Créez le dossier src/<NomDuSujet>/, puis le script scripts/generate-<sujet>-audio.ts qui appelle generateTopicVoices, exécutez npx tsx scripts/generate-<sujet>-audio.ts.
  3. Récupérez la liste des durées réelles en trames depuis manifest.json / src/<NomDuSujet>/audioData.ts.

Étape 3 : Créer le Dossier de Code src/<NomDuSujet>/

Structure de dossier standard :

src/<NomDuSujet>/
├── <NomDuSujet>.tsx          # Composition principale regroupant les Series.Sequence
├── types.ts                 # Schéma et Props
├── audioData.ts             # Métadonnées des durées audio
└── scenes/
    ├── Scene1Hook.tsx
    ├── Scene2Problem.tsx
    ├── Scene3Concept1.tsx
    ├── Scene4Concept2.tsx
    ├── Scene5Impact.tsx
    └── Scene6Outro.tsx

Effets sonores : utilisez <SfxTrack cues={...} /> depuis src/sfx/SfxTrack.tsx, placé dans le composant principal. Les fichiers audio se trouvent dans public/sfx/, régénérez-les avec npx tsx scripts/generate-sfx.ts.

QuandSon
Au début de chaque scène, 3 trames plus tôt pour tomber dans le silence avant la nouvelle phrase (scène 1 à la trame 0)mallet
Apparition d'une carte ou d'un élémentpop ou tick
Point d'impact, conclusionding
Appel à l'action d'abonnementchime
  • La frame de chaque cue est le nombre de trames depuis le début de la vidéo, correspondant au moment où l'élément apparaît.
  • Pas besoin d'éviter manuellement les chevauchements : SfxTrack ignore automatiquement les cues dont l'intervalle avec la cue précédente est inférieur à 0,4s, et réduit le volume si un son se répète immédiatement après lui-même.
  • Ne téléchargez pas de sons depuis myinstants ou des sites sans licence claire. Si un nouveau son est nécessaire, ajoutez-le dans scripts/generate-sfx.ts.

Étape 4 : Enregistrer la Composition dans src/Root.tsx

Ajoutez une nouvelle Composition dans src/Root.tsx :

<Composition
  id="<NomDuSujet>"
  component={<NomDuSujet>}
  durationInFrames={totalFrames}
  fps={30}
  width={1080}
  height={1920}
  defaultProps={{}}
/>

Étape 5 : Vérification et Rapport

  1. Exécutez npm run lint pour vérifier les erreurs TypeScript/ESLint.
  2. Rapportez à l'utilisateur le lien pour ouvrir la Composition dans Remotion Studio (http://localhost:3000) ou la commande pour générer la vidéo MP4 :
    npx remotion render <NomDuSujet> out/<NomDuSujet>.mp4
    

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés