Communitygithub.com

delorenj/skills

Pipeline de production vidéo Manim CE : animations mathématiques et algorithmiques de type 3Blue1Brown.

Qu'est-ce que skills ?

Ce pipeline de production vidéo Manim CE permet de créer des vidéos explicatives animées de type 3Blue1Brown, des visualisations d'algorithmes, des dérivations d'équations, des diagrammes d'architecture et des histoires à partir de données. Il est conçu pour transformer des concepts abstraits en récits visuels pédagogiques. Le pipeline guide l'utilisateur de la planification (rédaction d'un plan narratif) à la réalisation (code, rendu, assemblage, audio optionnel et révision). Il insiste sur une qualité esthétique professionnelle : chaque scène doit être visuellement claire, avec une palette de couleurs cohérente, un rythme d'animation étudié et une utilisation experte des sous-titres. Le système prend en charge plusieurs modes (explicateur de concept, dérivation d'équation, visualisation d'algorithme, etc.) et propose des références détaillées pour chaque aspect technique (animations, mobjects, conception visuelle, équations LaTeX, caméra 3D, rendu, etc.). Le pipeline fonctionne entièrement en local, sans navigateur ni GPU, et s'appuie sur Python 3.10+, Manim CE, LaTeX et ffmpeg. Le projet encourage la divergence créative via des méthodes comme SCAMPER ou l'inversion des hypothèses lorsque l'utilisateur demande une approche expérimentale.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/manim-video

Demander à votre IA préférée

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

Documentation

Pipeline de production vidéo Manim

Quand l'utiliser

À utiliser lorsque les utilisateurs demandent : des explications animées, des animations mathématiques, des visualisations de concepts, des démonstrations d'algorithmes, des présentations techniques, des vidéos de style 3Blue1Brown, ou toute animation programmatique avec du contenu géométrique/mathématique. Crée des vidéos explicatives de type 3Blue1Brown, des visualisations d'algorithmes, des dérivations d'équations, des diagrammes d'architecture et des histoires à partir de données à l'aide de Manim Community Edition.

Standard créatif

C'est du cinéma éducatif. Chaque image enseigne. Chaque animation révèle une structure.

Avant d'écrire une seule ligne de code, articulez l'arc narratif. Quelle idée fausse corrige-t-il ? Quel est le « moment de révélation » ? Quelle histoire visuelle mène le spectateur de la confusion à la compréhension ? L'invite de l'utilisateur est un point de départ — interprétez-la avec ambition pédagogique.

La géométrie avant l'algèbre. Montrez d'abord la forme, l'équation ensuite. La mémoire visuelle encode plus rapidement que la mémoire symbolique. Lorsque le spectateur voit le motif géométrique avant la formule, l'équation semble méritée.

L'excellence du premier rendu est non négociable. La sortie doit être visuellement claire et esthétiquement cohérente sans cycles de révision. Si quelque chose semble encombré, mal chronométré ou ressemble à des « diapositives générées par IA », c'est incorrect.

La superposition d'opacité dirige l'attention. Ne montrez jamais tout à pleine luminosité. Éléments principaux à 1.0, éléments contextuels à 0.4, éléments structurels (axes, grilles) à 0.15. Le cerveau traite la saillance visuelle en couches.

Du temps pour respirer. Chaque animation a besoin d'un self.wait() après elle. Le spectateur a besoin de temps pour assimiler ce qui vient d'apparaître. Ne vous précipitez jamais d'une animation à l'autre. Une pause de 2 secondes après une révélation clé n'est jamais du temps perdu.

Langage visuel cohérent. Toutes les scènes partagent une palette de couleurs, un dimensionnement typographique cohérent, des vitesses d'animation assorties. Une vidéo techniquement correcte où chaque scène utilise des couleurs aléatoires différentes est un échec esthétique.

Prérequis

Exécutez scripts/setup.sh pour vérifier toutes les dépendances. Nécessite : Python 3.10+, Manim Community Edition v0.20+ (pip install manim), LaTeX (texlive-full sur Linux, mactex sur macOS), et ffmpeg. La documentation de référence a été testée avec Manim CE v0.20.1.

Modes

ModeEntréeSortieRéférence
Explicateur de conceptSujet/conceptExplication animée avec intuition géométriquereferences/scene-planning.md
Dérivation d'équationExpressions mathématiquesPreuve animée étape par étapereferences/equations.md
Visualisation d'algorithmeDescription d'algorithmeExécution étape par étape avec structures de donnéesreferences/graphs-and-data.md
Histoire basée sur des donnéesDonnées/métriquesGraphiques animés, comparaisons, compteursreferences/graphs-and-data.md
Diagramme d'architectureDescription du systèmeComposants se construisant avec connexionsreferences/mobjects.md
Explicateur d'articleArticle de rechercheRésultats et méthodes clés animésreferences/scene-planning.md
Visualisation 3DConcept 3DSurfaces tournantes, courbes paramétriques, géométrie spatialereferences/camera-and-3d.md

Stack

Un seul script Python par projet. Pas de navigateur, pas de Node.js, pas de GPU requis.

CoucheOutilObjectif
CœurManim Community EditionRendu de scène, moteur d'animation
MathématiquesLaTeX (texlive/MiKTeX)Rendu d'équations via MathTex
Entrée/Sortie vidéoffmpegAssemblage de scènes, conversion de format, multiplexage audio
TTSElevenLabs / Qwen3-TTS (optionnel)Voix off narrative

Pipeline

PLANIFIER --> CODER --> RENDU --> ASSEMBLER --> AUDIO (optionnel) --> RÉVISER
  1. PLANIFIER — Écrivez plan.md avec l'arc narratif, la liste des scènes, les éléments visuels, la palette de couleurs, le script de voix off
  2. CODER — Écrivez script.py avec une classe par scène, chaque scène étant rendue indépendamment
  3. RENDU — manim -ql script.py Scene1 Scene2 ... pour le brouillon, -qh pour la production
  4. ASSEMBLER — Concaténation ffmpeg des clips de scènes en final.mp4
  5. AUDIO (optionnel) — Ajout de voix off et/ou de musique de fond via ffmpeg. Voir references/rendering.md
  6. RÉVISER — Rendu d'aperçus fixes, vérification par rapport au plan, ajustements

Structure du projet

nom-du-projet/
  plan.md                # Arc narratif, découpage des scènes
  script.py              # Toutes les scènes dans un fichier
  concat.txt             # Liste des scènes ffmpeg
  final.mp4              # Sortie assemblée
  media/                 # Généré automatiquement par Manim
    videos/script/480p15/

Direction créative

Palettes de couleurs

PaletteArrière-planPrimaireSecondaireAccentCas d'usage
Classique 3B1B#1C1C1C#58C4DD (BLEU)#83C167 (VERT)#FFFF00 (JAUNE)Mathématiques/CS général
Académique chaleureuse#2D2B55#FF6B6B#FFD93D#6BCB77Accessible
Technologique néon#0A0A0A#00F5FF#FF00FF#39FF14Systèmes, architecture
Monochrome#1A1A2E#EAEAEA#888888#FFFFFFMinimaliste

Vitesse d'animation

Contexterun_timeself.wait() après
Titre/intro apparaît1.5s1.0s
Révélation d'équation clé2.0s2.0s
Transformation/morphing1.5s1.5s
Étiquette de support0.8s0.5s
Nettoyage FadeOut0.5s0.3s
Révélation du « moment de révélation »2.5s3.0s

Échelle typographique

RôleTaille de policeUtilisation
Titre48Titres de scène, texte d'ouverture
En-tête36En-têtes de section dans une scène
Corps30Texte explicatif
Étiquette24Annotations, étiquettes d'axes
Légende20Sous-titres, petits caractères

Polices

Utilisez des polices à chasse fixe pour tout le texte. Le rendu Pango de Manim produit un crénage cassé avec les polices proportionnelles à toutes les tailles. Voir references/visual-design.md pour les recommandations complètes.

MONO = "Menlo"  # définir une fois en haut du fichier

Text("Série de Fourier", font_size=48, font=MONO, weight=BOLD)  # titres
Text("n=1 : sin(x)", font_size=20, font=MONO)                  # étiquettes
MathTex(r"\nabla L")                                            # mathématiques (utilise LaTeX)

Taille de police minimale font_size=18 pour la lisibilité.

Variation par scène

N'utilisez jamais une configuration identique pour toutes les scènes. Pour chaque scène :

  • Une couleur dominante différente de la palette
  • Une disposition différente — ne centrez pas tout systématiquement
  • Une entrée d'animation différente — variez entre Write, FadeIn, GrowFromCenter, Create
  • Un poids visuel différent — certaines scènes denses, d'autres clairsemées

Flux de travail

Étape 1 : Planifier (plan.md)

Avant tout code, écrivez plan.md. Voir references/scene-planning.md pour le modèle complet.

Étape 2 : Coder (script.py)

Une classe par scène. Chaque scène est rendue indépendamment.

from manim import *

BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"

class Scene1_Introduction(Scene):
    def construct(self):
        self.camera.background_color = BG
        title = Text("Pourquoi cela fonctionne-t-il ?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("Pourquoi cela fonctionne-t-il ?", duration=2)
        self.play(Write(title), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(title), run_time=0.5)

Modèles clés :

  • Sous-titres sur chaque animation : self.add_subcaption("texte", duration=N) ou subcaption="texte" sur self.play()
  • Constantes de couleur partagées en haut du fichier pour une cohérence entre les scènes
  • self.camera.background_color défini dans chaque scène
  • Sorties propres — FadeOut de tous les mobjects à la fin de la scène : self.play(FadeOut(Group(*self.mobjects)))

Étape 3 : Rendu

manim -ql script.py Scene1_Introduction Scene2_CoreConcept  # brouillon
manim -qh script.py Scene1_Introduction Scene2_CoreConcept  # production

Étape 4 : Assembler

cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Scene1_Introduction.mp4'
file 'media/videos/script/480p15/Scene2_CoreConcept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4

Étape 5 : Réviser

manim -ql --format=png -s script.py Scene2_CoreConcept  # aperçu fixe

Notes d'implémentation critiques

Chaînes brutes pour LaTeX

# FAUX : MathTex("\frac{1}{2}")
# JUSTE :
MathTex(r"\frac{1}{2}")

buff >= 0.5 pour le texte en bordure

label.to_edge(DOWN, buff=0.5)  # jamais < 0.5

FadeOut avant de remplacer du texte

self.play(ReplacementTransform(note1, note2))  # pas Write(note2) par-dessus

Ne jamais animer des mobjects non ajoutés

self.play(Create(circle))  # doit d'abord ajouter
self.play(circle.animate.set_color(RED))  # puis animer

Objectifs de performance

QualitéRésolutionFPSVitesse
-ql (brouillon)854x480155-15s/scène
-qm (moyenne)1280x7203015-60s/scène
-qh (production)1920x10806030-120s/scène

Itérez toujours à -ql. Ne faites le rendu à -qh que pour la sortie finale.

Références

FichierContenu
references/animations.mdAnimations de base, fonctions de vitesse, composition, syntaxe .animate, motifs temporels
references/mobjects.mdTexte, formes, VGroup/Group, positionnement, style, mobjects personnalisés
references/visual-design.md12 principes de conception, superposition d'opacité, modèles de mise en page, palettes de couleurs
references/equations.mdLaTeX dans Manim, TransformMatchingTex, motifs de dérivation
references/graphs-and-data.mdAxes, tracé, BarChart, données animées, visualisation d'algorithmes
references/camera-and-3d.mdMovingCameraScene, ThreeDScene, surfaces 3D, contrôle de la caméra
references/scene-planning.mdArcs narratifs, modèles de mise en page, transitions de scènes, modèle de planification
references/rendering.mdRéférence CLI, préréglages de qualité, ffmpeg, flux de travail de voix off, export GIF
references/troubleshooting.mdErreurs LaTeX, erreurs d'animation, erreurs courantes, débogage
references/animation-design-thinking.mdQuand animer vs afficher statique, décomposition, rythme, synchronisation de la narration
references/updaters-and-trackers.mdValueTracker, add_updater, always_redraw, updaters basés sur le temps, motifs
references/paper-explainer.mdTransformer des articles de recherche en animations — flux de travail, modèles, motifs par domaine
references/decorations.mdSurroundingRectangle, Brace, flèches, DashedLine, Angle, cycle de vie des annotations
references/production-quality.mdListes de contrôle pré-code, pré-rendu et post-rendu, disposition spatiale, couleur, tempo

Divergence créative (à utiliser uniquement lorsque l'utilisateur demande un résultat expérimental/créatif/unique)

Si l'utilisateur demande des approches explicatives créatives, expérimentales ou non conventionnelles, sélectionnez une stratégie et réfléchissez avant de concevoir l'animation.

  • SCAMPER — lorsque l'utilisateur souhaite un nouveau regard sur une explication standard
  • Inversion des hypothèses — lorsque l'utilisateur souhaite remettre en question la façon dont quelque chose est généralement enseigné

Transformation SCAMPER

Prenez une visualisation mathématique/technique standard et transformez-la :

  • Substituer : remplacez la métaphore visuelle standard (ligne numérique → chemin sinueux, matrice → grille urbaine)
  • Combiner : fusionnez deux approches explicatives (algébrique + géométrique simultanément)
  • Inverser : dérivez à rebours — partez du résultat et déconstruisez jusqu'aux axiomes
  • Modifier : exagérez un paramètre pour montrer pourquoi il est important (taux d'apprentissage multiplié par 10, taille d'échantillon multipliée par 1000)
  • Éliminer : supprimez toute notation — expliquez purement par l'animation et les relations spatiales

Inversion des hypothèses

  1. Listez ce qui est « standard » dans la visualisation de ce sujet (de gauche à droite, 2D, étapes discrètes, notation formelle)
  2. Choisissez l'hypothèse la plus fondamentale
  3. Inversez-la (dérivation de droite à gauche, plongement 3D d'un concept 2D, morphing continu au lieu d'étapes, zéro notation)
  4. Explorez ce que l'inversion révèle et que l'approche standard cache

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Skills associés