Communitygithub.com

remotion-software-explainer

Crée des vidéos explicatives Remotion synchronisées et immersives à un seul volet pour le génie logiciel (conception système, systèmes distribués, microservices, Kubernetes/Docker, patrons de conception, internes de bases de données, CI/CD, réseau) dans un format Log2Base2 mono-scène, avec un contrat/YAML focalisé en une seule ligne, des flux d'architecture animés en plein écran avec des paquets de requêtes voyageurs et des chronologies de trace en direct sur une seule toile, des sous-titres karaoké WordBoundary et un rendu MP4 1080p rapide. À utiliser chaque fois que l'utilisateur demande d'expliquer du génie logiciel, la conception système, ou l'architecture avec /remotion.

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

Cette compétence transforme n'importe quelle conception de système, architecture distribuée, patron de conception, mécanisme interne de base de données ou flux DevOps en une vidéo explicative Remotion immersive, synchronisée sur les images, au format MP4 1920×1080 30ips. Le format unique « Log2Base2 Studio Format » utilise une scène unifiée (`<SinglePaneStage>`) avec une barre supérieure minimale (titre + indicateur de progression), une zone centrale SVG plein écran (viewBox 1600×680) affichant progressivement les nœuds de service et les animations de paquets voyageurs, et une barre de sous-titres karaoké synchronisée avec les événements WordBoundary de la synthèse vocale. L'outillage en ligne de commande (`explainer_cli.py`) permet de générer la structure du projet, de synthétiser la voix, et de rendre la vidéo MP4 en local. La compétence est idéale pour les tuteurs IA, les démonstrations techniques, et toute explication visuelle de logiciel nécessitant clarté et rythme narratif.

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

Demander à votre IA préférée

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

Documentation

Expliqueur de Génie Logiciel Remotion (remotion-software-explainer)

Vue d'ensemble

Transforme toute conception système, architecture distribuée, patron de conception, mécanisme interne de base de données, ou flux DevOps en une vidéo explicative Remotion immersive, synchronisée sur les images, au format 1920×1080 30ips MP4, dans le Format Studio Log2Base2 à un seul volet.

Ne fractionnez jamais l'écran en volets concurrents côte à côte ou en murs de fiches textuelles empilées. Chaque vidéo utilise une scène visuelle unifiée (<SinglePaneStage>) :

  1. Barre supérieure minimale (44px, intégrée à SinglePaneStage) :
    • Titre du sujet + 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 projecteur focalisé sur une seule ligne : met en surbrillance l'élément parlé actif (replicas: 3, ConsistentHash, WAL, CircuitBreaker) dans la ligne de spécification/contrat active avec borderBottom: "2px solid #FACC15" (n'ajoutez jamais de remplissage horizontal) plus une pilule d'appel compacte active (terme → rôle architectural) à triggerFrame.
    • Toile SVG immersive plein écran (viewBox="0 0 1600 680") : Nœuds de service vectoriels progressifs (Client, API Gateway, Équilibreur de charge, Microservices, File de messages, Cache, Fragments de base de données, Pods K8s) apparaissant lorsqu'ils sont mentionnés, connectés par des pipelines animés en pointillés avec des paquets de requêtes voyageurs, des jauges de succès de cache/débit en direct, et des traces de requêtes qui s'écoulent directement sur la même toile ouverte.
  3. Barre de sous-titres inférieure minimale (VoiceoverCaptionBar — 68px) :
    • Sous-titres karaoké nets centrés avec surbrillance mot par mot, pilotés par les horodatages précis WordBoundary de la synthèse vocale.

Dépendances

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md)
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md)

Démarrage rapide

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

# 2. Synthétiser la voix
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-software-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 la vidéo 1080p MP4
uv run python3 \
  ~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/chemin/vers/projet" \
  --composition-id "SoftwareExplainer" \
  --out-name "SoftwareExplainer.mp4" \
  --concurrency 8 \
  --output "/chemin/vers/projet/render-report.json"

Narration immersive et flux de travail

  1. Gardez le snippet ciblé (2–4 lignes) afin que <SinglePaneStage> mette en avant une ligne de contrat active et révèle les nœuds d'architecture progressivement – ne déversez jamais 15 boîtes sur l'image 0.
  2. Définissez "motionStepFrames": 2 dans les sections avec des paquets de requêtes voyageurs, des cascades de bascule, ou des animations d'auto-adaptation.
  3. Montrez, ne dites pas : Animez les paquets de requêtes se déplaçant entre les nœuds avec des barres de latence, de file d'attente et de trace en direct directement à l'intérieur de la même toile SVG plein écran 1600×680 (en utilisant <clipPath> si nécessaire), jamais dans des boîtes séparées en écran partagé.
  4. Exécutez toujours npm run lint, inspectez des images représentatives (npx remotion still) avec read_file, et sauvegardez le fichier .mp4 final dans out/, la racine du projet, et la racine de l'espace de travail.

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

Skills associés