Communitygithub.com

Remotion Math Explainer

Erstellt synchronisierte, immersive Remotion-Erklärvideos für Mathematik (Analysis, Lineare Algebra, Differentialgleichungen, Wahrscheinlichkeit, Beweise) im klaren Log2Base2-Format mit Ein-Gleichung-Spotlight, animierten 3Blue1Brown-Grafiken, Wort-für-Wort-Karaoke-Untertiteln und schnellem 1080p-MP4-Export.

Was ist Remotion Math Explainer?

Das Skill 'Remotion Math Explainer' verwandelt mathematische Ableitungen, Theoreme, Beweise oder Präsentationen in fesselnde, framesynchronisierte 1920x1080 30fps MP4-Erklärvideos im Single-Pane-Log2Base2-Studio-Format. Es ist ideal für Inhalte aus Analysis, linearer Algebra, Differentialgleichungen, Wahrscheinlichkeitsrechnung und formalen Beweisen. Das Skill stellt sicher, dass der gesamte Bildschirm als eine einzige visuelle Bühne (SinglePaneStage) genutzt wird, sodass die Aufmerksamkeit des Zuschauers nie durch geteilte Ansichten oder überladene Textkarten abgelenkt wird. Der Aufbau ist dreiteilig: eine minimale obere Leiste mit Titel und Fortschrittsbalken, eine großzügige SVG-Leinwand für immersive Bewegungsgrafiken und eine untere Leiste mit karaoke-artigen Untertiteln. Mathematische Ausdrücke werden schrittweise beleuchtet: ein einzelner aktiver Ausdruck wird hervorgehoben, während eine kompakte Erklärungskachel den aktuellen Begriff in einfache Worte übersetzt. Die gesamte Animation und der Voiceover werden über ein CLI-Skript (explainer_cli.py) gesteuert, das die Projektstruktur aufsetzt, neuronale Sprachsynthese mit edge-tts durchführt und das finale Video ausgibt. Das Skill integriert sich nahtlos mit den Remotion-Best-Practices und dem uv-Paketmanager und vermeidet typische Fehler wie Multi-Pane-Layouts, horizontales Padding bei Hervorhebungen oder das gleichzeitige Anzeigen mehrerer Beweisschritte.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Remotion Math Explainer (remotion-math-explainer)

Übersicht

Verwandelt jede mathematische Ableitung, jedes Theorem, jeden Beweis oder jede Folienpräsentation in ein immersives, framesynchronisiertes 1920×1080 30fps MP4 Remotion-Erklärvideo im Single-Pane-Log2Base2-Studio-Format.

Teile den Bildschirm niemals in konkurrierende Side-by-Side-Panels oder gestapelte Textkartenwände auf. Jedes Video verwendet eine einzige, einheitliche visuelle Bühne (<SinglePaneStage>), sodass die volle Aufmerksamkeit des Betrachters auf der visuellen Geschichte bleibt:

  1. Minimale obere Leiste (44px, in SinglePaneStage integriert):
    • Titel des Themas + aktuelle Abschnittsmarkierung links; dezenter Schritt-Indikator + dünner Fortschrittsbalken rechts.
  2. EINHEITLICHE Log2Base2-Bühne (SinglePaneStage – 100% Breite):
    • Fokussierter Einzeiler-Spotlight-Header: Zeigt nur den aktuellen Schritttitel und die aktive Gleichungszeile (Hervorhebung des gesprochenen Begriffs an Ort und Stelle mit borderBottom: "2px solid #FACC15", niemals horizontales Padding) plus eine kompakte, aktive Erklärungskachel (symbol → alltagssprachliche Bedeutung), die bei triggerFrame erscheint.
    • Vollformatige immersive SVG-Leinwand (viewBox="0 0 1600 680"): Großzügige, kontinuierliche Bewegungsgrafiken – Live-Koordinatengitter mit farbigen Datenpunkten, die sich ausdehnen und zusammenziehen, Zahlen, die physisch aus Matrizen in kleine Blöcke gleiten, schwungvolle Laser-Durchstreichungen, Balken mit Vorzeichen und 3D-Einheitswürfel, die sich zurück zur Identität entzerren – direkt auf derselben offenen Leinwand integriert.
  3. Minimale untere Untertitel-Leiste (VoiceoverCaptionBar – 68px):
    • Saubere, zentrierte Karaoke-Wort-für-Wort-Untertitel mit Hervorhebung, gesteuert durch exakte WordBoundary-Millisekunden-Zeitstempel der TTS.

Abhängigkeiten

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md): Muss für alle Remotion-Animationen befolgt werden (useCurrentFrame(), interpolate(), spring(), <Sequence premountFor>, <Audio>, @remotion/google-fonts und keine CSS-Übergänge).
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md): Erforderlich zum Ausführen von uv run --with edge-tts für die neuronale Sprachsynthese.

Kurzstart

# 1. Erstelle das Remotion-Mathe-Erklärprojekt
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/pfad/zum/projekt" \
  --output "/pfad/zum/projekt/scaffold-status.json"

# 2. Synthetisiere natürliche neuronale Sprachausgabe + exakte WordBoundary & Begriff-Zeitstempel
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  synthesize-voiceover \
  --project-dir "/pfad/zum/projekt" \
  --beats-json "/pfad/zum/projekt/beats.json" \
  --voice "en-US-AndrewNeural" \
  --rate "+2%" \
  --pause-sec 0.40 \
  --output "/pfad/zum/projekt/public/voiceover/manifest.json"

# 3. Rendere das finale 1080p 30fps MP4 über den schnellen 8-Worker-Keyframe-Deduplication-Renderer
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/pfad/zum/projekt" \
  --composition-id "MathExplainer" \
  --out-name "MathExplainer.mp4" \
  --concurrency 8 \
  --output "/pfad/zum/projekt/render-report.json"

Immersive Erzählweise & Arbeitsablauf

  1. Entwerfe energiegeladene Beats (beats.json):
    • Schreibe eine gesprächige, hakenbetonte Erzählung (vermeide trockene Lehrbuchformulierungen), damit auch unmotivierte Studenten engagiert bleiben.
    • Halte snippet auf 2–4 prägnante Zeilen, wobei jedes token wörtlich in einer Zeile erscheint und mit einem sauberen, kleingeschriebenen triggerWord in text übereinstimmt.
    • Setze "motionStepFrames": 2 auf Beats mit kontinuierlichen Kurven-, Vektor-, Gitter- oder fliegenden Element-Animationen.
  2. Erstelle Projektgerüst & synthetisiere Sprachausgabe:
    • Führe scaffold (kopiert SinglePaneStage.tsx, VoiceoverCaptionBar.tsx und render_full_mp4.mjs) und synthesize-voiceover über scripts/explainer_cli.py aus.
  3. Autorisiere Voll-Canvas-Bewegungsgrafiken (viewBox="0 0 1600 680"):
    • Übergib deine immersive SVG-Bühne als children an <SinglePaneStage>.
    • Zeigen, nicht erzählen: Ersetze statische Text-/Kartenkarten durch physische Bewegung – Partikel/Punkte, die auf Koordinatenverzerrungen reiten, Elemente, die zwischen Positionen fliegen, schwungvolle Laserlinien, Live-Anzeigen und Live-Plots nebeneinander in der gleichen offenen Leinwand.
    • Wickle verzerrte/sich ausdehnende Gitterlinien immer in <clipPath>, damit die Bewegung niemals über Labels oder Kacheln läuft.
  4. Überprüfe Standbilder & rendere finales MP4:
    • Führe npm run lint aus und inspiziere repräsentative Einzelbilder (npx remotion still) mit read_file, bevor du render-mp4 ausführst.
    • Kopiere das finale .mp4 in out/, das Projekt-Stammverzeichnis und das Workspace-Stammverzeichnis.

Ratenbegrenzung & Häufige Fehler

  • scripts/explainer_cli.py erzwingt /tmp/remotion_edge_tts.lock (0,35s Abstand, 3 Wiederholungen mit 1s/2s/4s Backoff).
  • Verwende niemals ein geteiltes Multi-Pane-Layout oder gestapelte Unterkarten – verwende <SinglePaneStage>, sodass es streng einen Hauptbereich auf dem Bildschirm gibt.
  • Überflute niemals den gesamten Bildschirm mit einem mehrstufigen Beweis; hebe jeweils eine aktive Gleichungszeile und eine aktive Erklärungskachel hervor.
  • Füge niemals horizontales padding zu hervorgehobenen Inline-Tokens hinzu (borderBottom: "2px solid #FACC15" und backgroundColor nur).

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.

Verwandte Skills