Communitygithub.com

remotion-code-explainer

Crée des vidéos explicatives Remotion immersives et synchronisées en un seul volet pour du code source (Mobile/Web UI, Backend, IA/ML, Algorithmes) dans un format Log2Base2 à une seule scène, avec un spot lumineux sur une seule ligne de code, des boîtes mémoire animées en plein écran, des flèches de pointeurs, des paquets de données et un état d'exécution en direct sur un seul canvas, des sous-titres karaoké par mot et un rendu MP4 1080p rapide.

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

Cette compétence d'agent IA transforme n'importe quel fichier de code source en une vidéo explicative immersive au format MP4 1920×1080 à 30 images par seconde, en utilisant le framework Remotion. Elle est conçue pour créer des vidéos pédagogiques où l'attention du spectateur reste entièrement focalisée sur le déroulement de l'exécution du code, grâce à une scène unique et unifiée (`<SinglePaneStage>`) qui remplace les écrans divisés ou les cartes multiples. La scène unique comprend une barre supérieure minimale, un canvas SVG de 1600×680 pixels pour les animations, et une barre de sous-titres karaoké en bas, le tout synchronisé avec une voix off générée par `edge-tts`. La compétence est particulièrement utile pour les développeurs qui souhaitent produire rapidement des vidéos de démonstration ou d'explication de code, des formateurs en informatique, ou toute personne ayant besoin de transformer un script de narration en une vidéo explicative professionnelle. Elle prend en charge la génération de storyboards dynamiques, la synthèse vocale neuronale, le rendu MP4 optimisé et l'application de transitions animées (packets, flèches, mutations de mémoire) pour 'montrer' plutôt que 'raconter' le comportement du code.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/uzowurumauritius-rgb/remotion-stage/tree/main/skills/remotion-code-explainer

Demander à votre IA préférée

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

Documentation

Remotion Code Explainer (remotion-code-explainer)

Aperçu

Transforme n'importe quel fichier de code source en une vidéo explicative immersive et synchronisée au format MP4 1920×1080 à 30 images/s, dans le format de studio Log2Base2 à volet unique.

Ne scinde jamais l'écran en volets concurrents côte à côte ou en murs de cartes surchargés. Chaque vidéo utilise une seule scène visuelle unifiée (<SinglePaneStage>) pour que l'attention entière du spectateur reste focalisée sur la façon dont le code s'exécute :

  1. Barre supérieure minimale (44px, intégrée à SinglePaneStage) :
    • Titre de la leçon + pilule de section active à gauche ; compteur d'étapes subtil + barre de progression fine à droite.
  2. UNE scène Log2Base2 unifiée (SinglePaneStage — 100% de largeur) :
    • En-tête de spot lumineux sur une seule ligne : Affiche uniquement le titre de l'étape en cours et la ligne de code active unique en police monospace nette (mettant en évidence le token parlé actif avec borderBottom: "2px solid #FACC15", sans jamais ajouter de rembourrage horizontal) plus une pilule d'appel compacte (token → signification en français simple) qui apparaît au triggerFrame.
    • Canvas SVG immersif pleine largeur (viewBox="0 0 1600 680") : Graphiques animés spacieux et continus combinant les visuels mémoire/exécution de Log2Base2 (boîtes mémoire étiquetées 0x1004, variables mutantes, flèches de pointeurs animées strokeDashoffset, piles de frames qui s'empilent/se dépilent, échanges de tableaux/arbres) directement à côté d'aperçus en direct de l'UI, de la sortie standard ou des tenseurs sur le même canvas ouvert.
  3. Barre de sous-titres minimale en bas (VoiceoverCaptionBar — 68px) :
    • Sous-titres propres centrés mot par mot, mis en évidence comme au karaoké, pilotés par les horodatages millisecondes exacts des WordBoundary de la synthèse vocale (startMs, endMs).

Dépendances

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md) : Doit être suivi pour toutes les règles d'animation Remotion (useCurrentFrame(), interpolate(), spring(), <Sequence premountFor>, <Audio>, @remotion/google-fonts, et zéro transition CSS).
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md) : Requis pour exécuter uv run --with edge-tts pour la synthèse vocale neuronale et l'extraction des horodatages WordBoundary.

Démarrage rapide

# 1. Créer la structure du projet Remotion explainer
uv run python3 \
  ~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
  scaffold \
  --project-dir "/chemin/vers/projet" \
  --source-file "/chemin/vers/source.ext" \
  --output "/chemin/vers/projet/scaffold-status.json"

# 2. Synthétiser une voix off neuronale naturelle + horodatages exacts WordBoundary et tokens
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
  synthesize-voiceover \
  --project-dir "/chemin/vers/projet" \
  --beats-json "/chemin/vers/projet/beats.json" \
  --voice "fr-FR-DeniseNeural" \
  --rate "+2%" \
  --pause-sec 0.40 \
  --output "/chemin/vers/projet/public/voiceover/manifest.json"

# 3. Rendre le MP4 final 1080p 30 ips via un rendu rapide à 8 workers avec déduplication d'images clés
uv run python3 \
  ~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
  render-mp4 \
  --project-dir "/chemin/vers/projet" \
  --composition-id "CodeExplainer" \
  --out-name "Explainer.mp4" \
  --concurrency 8 \
  --output "/chemin/vers/projet/render-report.json"

Narration immersive et flux de travail

  1. Concevoir des beats énergiques (beats.json) :
    • Rédigez une narration concise et conversationnelle qui accroche immédiatement le spectateur sur le pourquoi le code se comporte ainsi.
    • Gardez codeSnippet ciblé (1–4 lignes) afin que la ligne active passée à <SinglePaneStage> contienne le token actif textuellement.
    • Définissez "motionStepFrames": 2 sur les beats avec des paquets voyageurs, des sauts de pointeurs, des échanges de tableaux ou des animations de tenseurs/UI en direct.
  2. Créer la structure et synthétiser la voix off :
    • Exécutez scaffold (copie SinglePaneStage.tsx, VoiceoverCaptionBar.tsx et render_full_mp4.mjs) et synthesize-voiceover via scripts/code_explainer_cli.py.
  3. Réaliser des graphiques animés sur tout le canvas (viewBox="0 0 1600 680") :
    • Passez votre storyboard SVG animé Log2Base2 × KodeKloud comme children dans <SinglePaneStage>.
    • Montrez, ne racontez pas : Remplacez les murs de code statiques et les boîtes de texte par du mouvement physique — des valeurs volant des registres/variables vers les emplacements mémoire, des pointeurs se réorientant en douceur, des paquets de données voyageant à travers les composants, et des sorties d'état/UI en direct se mettant à jour sur le même canvas ouvert.
    • Enveloppez les grilles dynamiques ou les traces défilantes dans <clipPath> afin que le mouvement ne déborde jamais de sa région.
  4. Vérifier les images fixes et effectuer le rendu final MP4 :
    • Exécutez npm run lint et inspectez les images fixes représentatives (npx remotion still) avec read_file pour vérifier qu'il n'y a pas de chevauchement ou de clipping.
    • Exécutez render-mp4 (scripts/render_full_mp4.mjs) et assurez-vous que le .mp4 final est sauvegardé dans out/, à la racine du projet et à la racine de l'espace de travail.

Limitation de débit et erreurs courantes

  • scripts/code_explainer_cli.py impose /tmp/remotion_edge_tts.lock (espacement de 0.35s, 3 tentatives avec backoff de 1s/2s/4s).
  • N'utilisez jamais un tableau de bord à deux zones divisées ou un mur de code défilant de 40 lignes ; gardez l'écran sur un seul volet <SinglePaneStage>.
  • N'ajoutez jamais de rembourrage padding horizontal aux tokens en ligne mis en évidence (utilisez uniquement borderBottom: "2px solid #FACC15" et backgroundColor).
  • N'utilisez jamais de cartes de texte statiques à l'intérieur de la scène SVG quand un mouvement animé de mémoire/pointeur/paquet peut démontrer le concept visuellement.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

remotion-electronic-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Electronic Engineering (Semiconductors, PN Junctions, Diodes, BJTs, MOSFETs, CMOS Logic, Op-Amp IC Stages, ADC/DAC, PCB Signal Integrity) in a pure Log2Base2 single-stage format—with a focused single-line device equation spotlight, full-screen animated carrier/channel diagrams and live I-V curves on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain electronic engineering, semiconductors, transistors, or analog/digital ICs with /remotion.

remotion-math-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Mathematics (Calculus, Linear Algebra, Differential Equations, Probability, Proofs) in a pure Log2Base2 single-stage format—with a focused single-line equation spotlight, full-screen 3Blue1Brown x Log2Base2 animated geometric/data motion graphics, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain math with /remotion, animate a derivation or theorem, or turn a math script into an MP4 explainer.

remotion-physics-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Physics (Mechanics, Electromagnetism, Thermodynamics, Optics/Waves, Quantum Mechanics, Relativity) in a pure Log2Base2 single-stage format—with a focused single-line governing law spotlight, full-screen animated free-body/field/wave simulations and live telemetry on one canvas, millisecond-accurate WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain physics with /remotion or animate a physical law/system.

remotion-software-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Software Engineering (System Design, Distributed Systems, Microservices, Kubernetes/Docker, Design Patterns, Database Internals, CI/CD, Networking) in a pure Log2Base2 single-stage format—with a focused single-line contract/YAML spotlight, full-screen animated architecture flows with traveling request packets and live trace timelines on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain software engineering, system design, or architecture with /remotion.

Skills associés