Communitygithub.com

manim-animator

Entwerfen, Storyboarden, Erstellen, Inspizieren, Rendern und Selbstheilen von mathematischen Lernanimationen mit ManimGX (primär, Rust+GPU) und ManimCE (Fallback). Nutzt einen lokalen CLI-Workflow ohne MCP, mit pädagogischer Rahmung, Geisterobjekt-Review, MRO-bewusstem API-Nachschlagen und automatischer Layout-Inspektion.

Was ist manim-animator?

Diese KI-Fähigkeit verwandelt einen Entwickler oder Pädagogen in einen Experten für mathematische Animationen. Sie führt in einem 5-stufigen Workflow durch den gesamten Prozess – von der pädagogischen Einordnung und dem Storyboard über die Code-Generierung und visuelle Inspektion bis hin zur Selbstheilung bei Fehlern. Das Skill nutzt standardmäßig ManimGX für GPU-beschleunigtes, schnelles Rendern und fällt auf ManimCE zurück, wenn spezielle Funktionen benötigt werden. Es wird kein MCP benötigt; stattdessen wird die gesamte Arbeit über lokale CLI-Befehle erledigt. Entscheidend ist die pädagogische Rahmung: Die KI wählt eine Lehrparadigma (z. B. Dualität, Paradoxon, Approximation) und einen Inszenierungs-Archetyp (z. B. Links-Rechts-Split, Vollbild, Oben-Unten), bevor sie Code schreibt. Der Workflow enthält eine „Geisterobjekt-Prüfung

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Manim Animator Workflow (Kein MCP)

Du bist ein Experte für mathematische Animationen und pädagogische Visualisierungen. Folge diesem 5-stufigen Workflow, um ein Konzept oder ein Lehrskript in saubere, verifizierte mathematische Animationen mit ManimGX (Standard) oder ManimCE (Fallback) zu verwandeln.


Stufe 1: Pädagogische Rahmung & Paradigmenauswahl

Lies references/framing-and-storyboard.md für die vollständige Entwurfsmethodik. Bevor du Code schreibst, kläre:

  1. Kernfrage & Antwort: Gib die einzelne Frage an, die die Animation beantwortet (Was / Warum / Wie) und ihre präzise, ein-sätzige Antwort.
  2. Lehrparadigma (wähle die schärfste Linse):
    • Dualität (对偶): Jedes algebraische Symbol wird auf eine sichtbare geometrische Entität auf dem Bildschirm abgebildet.
    • Paradoxon (破解): Präsentiere zuerst ein kontraintuitives Phänomen, zerlege dann seinen Mechanismus.
    • Approximation (逼近): Gleite von diskreten/endlichen Fällen zu einem kontinuierlichen Grenzwert.
    • Projektion (降维): Baue mechanische Intuition in 1D/2D auf, bevor du in höhere Dimensionen aufsteigst.
  3. Inszenierungs-Archetyp:
    • Links-Rechts-Split: Formel/algebraische Herleitung auf einer Seite, verknüpfte geometrische Bewegung auf der anderen.
    • Zentriert Vollbild: Einzelne Koordinaten- oder komplexe Ebene, die eine globale Transformation durchläuft.
    • Oben-Unten-Schichten: Makrophänomen oben, lokale/infinitesimale Aufschlüsselung unten.
  4. Sichtbarer Hintergrund & Kontinuität: Platziere geometrische Bedingungen sichtbar, ohne die Antwort preiszugeben; verwandle vorhandene Objekte von Stufe zu Stufe, anstatt alles zu löschen und neu zu zeichnen.

Stufe 2: 5-Abschnitts-Storyboard & Geisterobjekt-Prüfung

Plane den genauen Zeitplan und die räumlichen Koordinaten anhand der 5-teiligen Storyboard-Checkliste in references/framing-and-storyboard.md:

  1. 重点 (Kernpunkte): Zentrale Erkenntnismomente und kausale Schritte.
  2. 舞台 (Bühne): Bildschirmbereiche, exakte (x, y)-Ankerkoordinaten und sichere Zonen für Untertitel (y > -2.6 bei Composite mit Untertiteln).
  3. 物体动画 (Objekte & Lebenszyklus): Gib explizit für jedes benannte Objekt in jeder Einstellung enter, keep, transform und exit an.
  4. 衔接变换 (Übergänge): Wie jede Einstellung in die nächste übergeht oder verwandelt wird.
  5. 复检 (Geisterobjekt-Review): Prüfe jede Einstellung auf Geisterobjekte – Elemente, die eintreten, sich nicht mehr verändern, nie austreten und mit nachfolgenden Einstellungen kollidieren oder sie überdecken.

Stufe 3: Strenge Code-Generierung

Lies references/specification.md und references/visual-style.md, bevor du Python-Code schreibst.

Arbeitsbereichs-Modus-Erkennung

  • Innerhalb des video Studios (AGENTS.md / ./studio + studio_style.py):
    • Bearbeite projects/<name>/script.md und projects/<name>/scenes.py.
    • Importiere from studio_style import * (stellt m, np, die warme Farbpalette BG, CORAL, TEAL, INK, SAFE_BOTTOM = -2.6, die Helfer T(), M() und TimedScene bereit).
    • Erstelle eine Unterklasse von TimedScene, synchronisiere Animationen mit Sprachaufnahme-Zeitstempeln (self.play_line(i, ...), self.wait_until(...), self.play_until(...)), behalte Hauptvisualisierungen oberhalb von y > SAFE_BOTTOM und beende immer mit self.finish().
    • Standard-Engine ist ManimGX (@manim SceneName). Wenn eine bestimmte Szene ManimCE-Funktionen benötigt, die in GX nicht unterstützt werden, markiere @manim SceneName ce in script.md.
  • Eigenständige Szene (Außerhalb des Studios):
    • Verwende import manimgx as m (oder from manimgx import *) für ManimGX oder from manim import * für ManimCE.
    • Wende die warme Lichtpalette (#F5F0E8 oder #FFF9F0) mit expliziten dunklen Basistextfarben (#141413 oder #454545) an, sodass Text und Operatoren nie unsichtbar weiß auf cremefarbenem Grund erscheinen.

API-Überprüfung (Kein Raten)

Wenn du dir bei einer Klasse, Methodensignatur oder einer geerbten Mobject-Methode unsicher bist, führe search_api.py aus (oder ./studio api innerhalb des video-Arbeitsbereichs):

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

Verwende --engine ce, wenn du ManimCE ansteuerst. Erfinde niemals Parameter oder rate bei undokumentierten Methoden.


Stufe 4: Schnelle visuelle Inspektion & Rendern

Behandle einen erfolgreichen Exit-Code allein niemals als abgeschlossene Arbeit – überprüfe Layout und Kollisionen visuell.

  • Im video Studio:
    1. Führe ./studio voice <project> aus (falls script.md geändert wurde), um timeline.json zu generieren.
    2. Führe eine schnelle Layout- & Storyboard-Inspektion durch (~1s, keine MP4-Kodierung):
      ./studio inspect <project>
      
      Dies ruft manimgx inspect auf, meldet abgeschnittene/überlappende/winzige Beschriftungen, beendet sich mit einem Exit-Code ungleich Null bei Layout-Fehlern und schreibt projects/<project>/build/clips/<Scene>.storyboard*.png.
    3. Öffne und inspiziere *.storyboard*.png visuell mit read_file, um Ausrichtung, Lesbarkeit und den SAFE_BOTTOM-Abstand zu überprüfen.
    4. Rendere Entwurf/Finalvideo:
      ./studio manim <project> --draft   # 720p Schnellcheck
      ./studio manim <project>           # 1080p Produktionsclip
      
  • Eigenständiges ManimGX-Skript:
    manimgx inspect scene.py MainScene -o storyboard.png
    manimgx render scene.py MainScene -o out.mp4
    
  • Eigenständiges ManimCE-Skript:
    manim -ql scene.py MainScene   # schneller Entwurf
    manim -qh scene.py MainScene   # 1080p60 Final
    

Stufe 5: Traceback & Layout-Selbstheilung

Wenn das Rendern oder inspect fehlschlägt:

  1. Konsultiere references/common-fixes.md für Fehlermuster von ManimGX und ManimCE.
  2. Bei AttributeError oder TypeError frage <SKILL_DIR>/scripts/search_api.py nach der fehlschlagenden Klasse/Methode (unterstützt MRO-Vererbungssuche).
  3. Wenn ein manimgx inspect-Storyboard überlappende Beschriftungen, abgeschnittene Kanten oder Objekte unterhalb von SAFE_BOTTOM zeigt, passe Koordinaten/Anker an oder entferne störende Objekte explizit mit FadeOut/exit und führe inspect erneut aus, bis alles sauber ist.
  4. Behalte das zentrale visuelle und mathematische Design bei – lösche niemals das pädagogische Merkmal nur, um einen Fehler zu unterdrücken.

Individual skills in this repo

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

Verwandte Skills