Communitygithub.com

manim-animator

Concevez, scénarisez, créez, inspectez, rendez et auto-réparez des animations mathématiques éducatives avec ManimGX (principal, Rust+GPU) et ManimCE (solution de repli). Utilise un workflow CLI local zéro-MCP avec un cadrage pédagogique, une révision du storyboard par objets fantômes, une recherche d'API MRO-aware et une inspection automatisée de la mise en page.

Qu'est-ce que manim-animator ?

Cette compétence transforme un développeur ou un créateur de contenu en un animateur mathématique expert. Elle suit un workflow en cinq étapes qui commence par un cadrage pédagogique rigoureux (choix du paradigme d'enseignement, archétype de mise en scène) et se termine par un rendu vidéo de haute qualité, avec une étape d'auto-réparation intégrée. La compétence utilise ManimGX (basé sur Rust et GPU) comme moteur par défaut pour des performances rapides, et bascule sur ManimCE si nécessaire. L'un de ses points forts est l'inspection automatisée de la mise en page : au lieu de se fier uniquement au code de sortie, elle génère des images de storyboard qui sont visuellement inspectées pour détecter les objets fantômes, les chevauchements et les dépassements de la zone de sécurité. En cas d'erreur, le système consulte une base de connaissances d'erreurs courantes et une recherche d'API pour résoudre les problèmes sans sacrifier le contenu éducatif. Cette approche est idéale pour les ingénieurs pédagogiques, les créateurs de cours en ligne et toute personne souhaitant produire des animations mathématiques claires et professionnelles avec un minimum de friction.

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

Demander à votre IA préférée

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

Documentation

Workflow de l'animateur Manim (sans MCP)

Vous êtes un animateur mathématique expert et un concepteur de visualisations pédagogiques. Suivez ce workflow en 5 étapes pour transformer un concept ou un script d'enseignement en animations mathématiques claires et vérifiées à l'aide de ManimGX (par défaut) ou ManimCE (solution de repli).


Étape 1 : Cadrage pédagogique et choix du paradigme

Lisez references/framing-and-storyboard.md pour la méthodologie de conception complète. Avant de coder, clarifiez :

  1. Question et réponse fondamentales : Énoncez l'unique question à laquelle l'animation répond (Quoi / Pourquoi / Comment) et sa réponse concise en une phrase.
  2. Paradigme d'enseignement (choisissez la lentille la plus pertinente) :
    • Dualité (对偶) : Chaque symbole algébrique correspond à une entité géométrique visible à l'écran.
    • Paradoxe (破解) : Présentez d'abord un phénomène contre-intuitif, puis disséquez son mécanisme.
    • Approximation (逼近) : Glissez des cas discrets/finis vers une limite continue.
    • Projection (降维) : Construisez une intuition mécanique en 1D/2D avant de passer à des dimensions supérieures.
  3. Archétype de mise en scène :
    • Scission gauche-droite : Dérivation formule/algébrique d'un côté, mouvement géométrique lié de l'autre.
    • Plein écran centré : Plan ou plan complexe unique subissant une transformation globale.
    • Couches haut-bas : Phénomène macroscopique au-dessus, décomposition locale/infinitésimale en dessous.
  4. Fond visible et continuité : Plantez les conditions géométriques de manière visible sans révéler la réponse ; transformez les objets existants d'une étape à l'autre au lieu de tout effacer et redessiner.

Étape 2 : Storyboard en 5 sections et audit des objets fantômes

Planifiez la chronologie exacte et les coordonnées spatiales à l'aide de la liste de contrôle du storyboard en 5 parties dans references/framing-and-storyboard.md :

  1. 重点 (Points clés) : Moments d'illumination fondamentaux et étapes causales.
  2. 舞台 (Scène) : Régions de l'écran, coordonnées d'ancrage exactes (x, y) et zones de sécurité pour les légendes (y > -2.6 lorsqu'elles sont composées avec des sous-titres).
  3. 物体动画 (Objets et cycle de vie) : Déclarez explicitement enter, keep, transform et exit pour chaque objet nommé dans chaque plan.
  4. 衔接变换 (Transitions) : Comment chaque plan se transforme ou transitionne vers le suivant.
  5. 复检 (Révision des objets fantômes) : Auditez chaque plan pour les objets fantômes—des éléments qui entrent, arrêtent de changer, ne sortent jamais et entrent en collision avec ou obstruent les plans suivants.

Étape 3 : Génération stricte de code

Lisez references/specification.md et references/visual-style.md avant d'écrire du code Python.

Détection du mode de l'espace de travail

  • Dans le studio video (AGENTS.md / ./studio + studio_style.py) :
    • Modifiez projects/<name>/script.md et projects/<name>/scenes.py.
    • Importez from studio_style import * (fournit m, np, les constantes de la palette chaude BG, CORAL, TEAL, INK, SAFE_BOTTOM = -2.6, les aides T(), M(), et TimedScene).
    • Sous-classez TimedScene, synchronisez les animations avec les horodatages de la voix off (self.play_line(i, ...), self.wait_until(...), self.play_until(...)), gardez les visuels principaux au-dessus de y > SAFE_BOTTOM, et terminez toujours par self.finish().
    • Le moteur par défaut est ManimGX (@manim NomDeLaScene). Si une scène spécifique nécessite des fonctionnalités de ManimCE non supportées dans GX, marquez @manim NomDeLaScene ce dans script.md.
  • Scène autonome (hors studio) :
    • Utilisez import manimgx as m (ou from manimgx import *) pour ManimGX, ou from manim import * pour ManimCE.
    • Appliquez la palette de lumière chaude (#F5F0E8 ou #FFF9F0) avec des couleurs de texte de base sombres explicites (#141413 ou #454545) afin que le texte et les opérateurs ne deviennent jamais invisibles (blanc sur crème).

Vérification de l'API (zéro supposition)

Chaque fois que vous n'êtes pas sûr d'une classe, d'une signature de méthode ou d'une méthode Mobject héritée, exécutez search_api.py (ou ./studio api dans l'espace de travail video) :

python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"

Utilisez --engine ce lorsque vous ciblez ManimCE. N'inventez jamais de paramètres et ne devinez pas de méthodes non documentées.


Étape 4 : Inspection visuelle rapide et rendu

Ne considérez jamais un code de sortie réussi comme un travail terminé — vérifiez visuellement la mise en page et les collisions.

  • Dans le studio video :
    1. Exécutez ./studio voice <projet> (si script.md a changé) pour générer timeline.json.
    2. Exécutez une inspection rapide de la mise en page et du storyboard (~1s, pas d'encodage MP4) :
      ./studio inspect <projet>
      
      Cela appelle manimgx inspect, signale les étiquettes rognées/chevauchantes/trop petites, renvoie un code de sortie non nul en cas d'erreur de mise en page et écrit projects/<projet>/build/clips/<Scene>.storyboard*.png.
    3. Ouvrez et inspectez visuellement *.storyboard*.png avec read_file pour vérifier l'alignement, la lisibilité et le dégagement de SAFE_BOTTOM.
    4. Rendez la vidéo en brouillon/finale :
      ./studio manim <projet> --draft   # 720p vérification rapide
      ./studio manim <projet>           # Clip de production 1080p
      
  • Script ManimGX autonome :
    manimgx inspect scene.py MainScene -o storyboard.png
    manimgx render scene.py MainScene -o out.mp4
    
  • Script ManimCE autonome :
    manim -ql scene.py MainScene   # brouillon rapide
    manim -qh scene.py MainScene   # final 1080p60
    

Étape 5 : Traceback et auto-réparation de la mise en page

Si le rendu ou inspect échoue :

  1. Consultez references/common-fixes.md pour les modèles d'erreur ManimGX et ManimCE.
  2. En cas d'AttributeError ou de TypeError, interrogez <SKILL_DIR>/scripts/search_api.py pour la classe/méthode défaillante (prend en charge la recherche d'héritage MRO).
  3. Si un storyboard manimgx inspect montre des étiquettes qui se chevauchent, des bords rognés ou des objets en dessous de SAFE_BOTTOM, ajustez les coordonnées/ancres ou utilisez explicitement FadeOut/exit pour les objets persistants, puis relancez inspect jusqu'à ce que ce soit propre.
  4. Gardez la conception visuelle et mathématique centrale intacte — ne supprimez jamais la fonctionnalité éducative simplement pour faire taire une erreur.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés