Communitygithub.com

remotion-math-explainer

Crée des vidéos explicatives Remotion immersives et synchronisées pour les mathématiques (calcul, algèbre linéaire, équations différentielles, probabilités, preuves) au format Log2Base2 à un seul panneau, avec spot sur une équation, animations géométriques pleine écran 3Blue1Brown × Log2Base2, sous-titres karaoké WordBoundary et rendu MP4 rapide en 1080p.

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

Remotion Math Explainer est un outil conçu pour les développeurs et créateurs de contenu qui souhaitent transformer des concepts mathématiques complexes en vidéos explicatives animées, immersives et professionnelles. Il repose sur Remotion, un framework de rendu vidéo programmatique en React, et produit des vidéos au format 1080p 30fps MP4. L'agent utilise un format d'écran unique baptisé `SinglePaneStage`, ce qui évite les mises en page fractionnées et maintient toute l'attention du spectateur sur le récit visuel. Il génère des graphiques animés vectoriels (SVG) en plein écran, des équations mises en avant ligne par ligne avec des surlignages animés et des sous-titres karaoké synchronisés au mot près grâce aux timestamps WordBoundary. Le flux de travail typique comprend la rédaction d'un script structuré (beats.json), le scaffolding du projet Remotion via un CLI Python, la synthèse vocale neuronale (avec edge-tts), l'implémentation d'animations SVG personnalisées dans la zone d'affichage 1600×680, puis le rendu final accéléré avec déduplication d'images clés. Il est particulièrement adapté pour expliquer des dérivations, des théorèmes ou des preuves mathématiques sur demande (commande `/remotion`) ou pour transformer un script mathématique en vidéo MP4 explicative.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/uzowurumauritius-rgb/remotion-stage/tree/main/skills/remotion-math-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 Math Explainer (remotion-math-explainer)

Présentation

Convertit toute dérivation mathématique, théorème, preuve ou présentation en une vidéo explicative immersive 1920×1080 30fps MP4 avec Remotion, au Format Studio Log2Base2 à un seul panneau.

Ne divise jamais l'écran en panneaux concurrents (côte à côte ou piles de fiches). Chaque vidéo utilise une scène visuelle unique (<SinglePaneStage>) pour que l'attention du spectateur reste entièrement focalisée sur l'histoire visuelle :

  1. Barre supérieure minimale (44px, intégrée à SinglePaneStage) :
    • Titre du sujet + pilule de section active courante à gauche ; compteur d'étapes discret + barre de progression fine à droite.
  2. UNE scène Log2Base2 unifiée (SinglePaneStage — 100% de largeur) :
    • En-tête spot sur une ligne : affiche uniquement le titre de l'étape courante et la ligne d'équation active unique (surlignage du terme parlé en place avec borderBottom: "2px solid #FACC15", sans jamais ajouter de padding horizontal) plus une pilule d'appel de terme actif compacte (symbole → signification en langage clair) qui apparaît avec une animation au triggerFrame.
    • Canvas SVG immersif pleine largeur (viewBox="0 0 1600 680") : graphiques animés continus et spacieux — grilles de coordonnées vivantes avec points de données colorés qui s'étirent et se contractent, nombres qui glissent physiquement hors des matrices dans des blocs mineurs, traits de laser qui balayent, barres de magnitude signées et cubes unités 3D qui se déforment pour revenir à l'identité — intégrés directement sur le même canevas ouvert.
  3. Barre de sous-titres inférieure minimale (VoiceoverCaptionBar — 68px) :
    • Sous-titres centrés et nets en mode karaoké mot par mot, entraînés par les timestamps exacts WordBoundary de la synthèse vocale TTS.

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) : nécessaire pour exécuter uv run --with edge-tts pour la synthèse vocale neuronale.

Démarrage rapide

# 1. Créer le projet Remotion math explainer
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/chemin/vers/projet" \
  --output "/chemin/vers/projet/scaffold-status.json"

# 2. Synthétiser la voix off neuronale naturelle + timestamps exacts WordBoundary et des termes
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  synthesize-voiceover \
  --project-dir "/chemin/vers/projet" \
  --beats-json "/chemin/vers/projet/beats.json" \
  --voice "en-US-AndrewNeural" \
  --rate "+2%" \
  --pause-sec 0.40 \
  --output "/chemin/vers/projet/public/voiceover/manifest.json"

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

Narration immersive et flux de travail

  1. Concevoir des séquences rythmées (beats.json) :
    • Rédiger une narration conversationnelle avec un accroche forte (éviter le ton sec des manuels) pour que même les étudiants non motivés restent engagés.
    • Limiter snippet à 2–4 lignes concises où chaque token apparaît textuellement dans une ligne et correspond à un triggerWord propre en minuscules dans text.
    • Mettre "motionStepFrames": 2 sur les séquences avec des animations continues de courbes, vecteurs, grilles ou éléments volants.
  2. Créer le projet et synthétiser la voix off :
    • Exécuter scaffold (copie SinglePaneStage.tsx, VoiceoverCaptionBar.tsx et render_full_mp4.mjs) et synthesize-voiceover via scripts/explainer_cli.py.
  3. Créer les graphiques animés plein-canvas (viewBox="0 0 1600 680") :
    • Passer votre scène SVG immersive comme children de <SinglePaneStage>.
    • Montrer, ne pas dire : remplacer les fiches de texte statiques par des mouvements physiques — particules/points qui suivent des déformations de coordonnées, éléments qui volent entre positions, traits de laser qui balayent, jauges vivantes et tracés en direct côte à côte dans le même canevas ouvert.
    • Toujours envelopper les lignes de grille qui se déforment/s'étendent dans <clipPath> pour que le mouvement ne déborde jamais sur les libellés ou les pilules.
  4. Vérifier les images fixes et rendre le MP4 final :
    • Exécuter npm run lint et inspecter des images fixes représentatives (npx remotion still) avec read_file avant de lancer render-mp4.
    • Copier le fichier .mp4 final dans out/, la racine du projet et la racine de l'espace de travail.

Limitation de débit et erreurs fréquentes

  • scripts/explainer_cli.py applique un verrou /tmp/remotion_edge_tts.lock (espacement de 0.35s, 3 tentatives avec backoff 1s/2s/4s).
  • Ne jamais utiliser une disposition en écran divisé multi-panneaux ou empiler des sous-fiches bordées — utiliser <SinglePaneStage> pour qu'il n'y ait strictement qu'un panneau principal à l'écran.
  • Ne jamais afficher une preuve multi-étapes complète en une fois ; ne mettre en avant qu'une ligne d'équation active et une pilule d'appel active à la fois.
  • Ne jamais ajouter de padding horizontal aux termes en surbrillance inline (borderBottom: "2px solid #FACC15" et backgroundColor seulement).

Individual skills in this repo

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

remotion-code-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for source code (Mobile/Web UI, Backend, AI/ML, Algorithms) in a pure Log2Base2 single-stage format—with a focused single-line code spotlight, full-screen animated memory boxes, pointer arrows, data packets, and live execution state on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain code with /remotion, build a code walkthrough video, or turn a voiceover script into an MP4 explainer.

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-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