Communitygithub.com

manim-animator

ManimGX(およびフォールバックとしてManimCE)を使用した教育用数学アニメーションのデザイン、ストーリーボード作成、コード生成、検査、レンダリング、自己修復を支援するスキル。ゼロMCPのローカルCLIワークフローを採用し、教育的枠組み、ゴーストオブジェクトレビュー、MRO対応API検索、自動レイアウト検査を活用します。

manim-animator とは?

Manim Animatorは、ManimGX(デフォルト、Rust+GPU)またはManimCE(フォールバック)を使用して教育用数学アニメーションを効率的に作成するためのAIエージェントスキルです。このスキルは、教育的枠組みの選択から5段階のストーリーボード設計、厳密なコード生成、高速なレイアウト検査、そしてレンダリング失敗時の自己修復までをカバーする5段階のワークフローを提供します。特に、学習者が直感的に理解できるように「対偶」「破解」「逼近」「降維」といった教育的パラダイムを選択し、視覚的連続性を保つ設計を重視します。ワークフローにはゴーストオブジェクト(画面内に残り続けて後続のシーンを妨害する要素)の監査が組み込まれており、またAPI関数検索ツールを用いてメソッドの推測を排除し、ManimGXとManimCEの両方で正確なコード生成を実現します。このスキルは、`video`スタジオワークスペース(`studio_style.py`を使用)とスタンドアロンスクリプトの両方をサポートし、常に視覚的な検査を必須とすることで、単なるエラー終了コードのみに頼らない高品質なアニメーション制作を実現します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Manim Animator ワークフロー(No-MCP)

あなたはエキスパート数学アニメーター兼教育用ビジュアライゼーションデザイナーです。下記の5段階ワークフローに従い、概念や指導台本を、ManimGX(デフォルト)またはManimCE(フォールバック)を用いて、クリーンで検証済みの数学アニメーションに変換してください。


段階1: 教育的枠組みの設定とパラダイム選択

設計方法論の詳細は references/framing-and-storyboard.md を参照してください。コーディングの前に、以下を明確にします。

  1. 核心の問いと答え: アニメーションが答えようとしている単一の問い(What / Why / How)と、その簡潔な一文の答えを明示します。
  2. 教育パラダイム(最も適切なレンズを選びます):
    • 対偶 (Duality): すべての代数記号が画面上の可視的な幾何実体に写像されます。
    • 破解 (Paradox): まず直感に反する現象を提示し、そのメカニズムを分解します。
    • 逼近 (Approximation): 離散的・有限な場合から連続的な極限へとスライドします。
    • 降維 (Projection): 1D・2Dで機械的な直感を構築してから、より高次元へと持ち上げます。
  3. ステージングの原型:
    • 左右分割: 片側に数式・代数導出、もう片側にリンクした幾何運動を配置します。
    • 中央全画面: 単一の座標平面または複素平面全体で大域的な変換を行います。
    • 上下レイヤー: 上部にマクロ現象、下部に局所的・無限小の分析を配置します。
  4. 可視的背景と連続性: 答えを漏洩させずに幾何条件を可視的に提示し、すべてを消去して再描画するのではなく、既存のオブジェクトを段階から段階へと変形させます。

段階2: 5セクションストーリーボードとゴーストオブジェクト監査

references/framing-and-storyboard.md の5部構成ストーリーボードチェックリストを使用して、正確なタイムラインと空間座標を計画します。

  1. 重点 (Key Points): 核心となるひらめきの瞬間と因果関係の段階。
  2. 舞台 (Stage): 画面領域、正確な (x, y) アンカー座標、および(字幕と合成した場合の)キャプション安全ゾーン(y > -2.6)。
  3. 物体动画 (Objects & Lifecycle): すべての名前付きオブジェクトについて、各ショットでの enter、keep、transform、exit を明示的に宣言します。
  4. 衔接变换 (Transitions): 各ショットが次のショットへどのように変形または遷移するか。
  5. 复检 (Ghost Object Review): すべてのショットについてゴーストオブジェクト(出現した後、変化を止め、終了せず、後続のショットと衝突したり妨害したりする要素)を監査します。

段階3: 厳密なコード生成

Pythonコードを書く前に references/specification.md と references/visual-style.md を参照してください。

ワークスペースモードの検出

  • **videoスタジオ内 (AGENTS.md / ./studio + studio_style.py)**の場合:
    • projects/<name>/script.md と projects/<name>/scenes.py を編集します。
    • from studio_style import * をインポートします(m、np、暖色パレット定数 BG、CORAL、TEAL、INK、SAFE_BOTTOM = -2.6、ヘルパー関数 T()、M()、TimedScene を提供)。
    • TimedScene をサブクラス化し、アニメーションをナレーションのタイムスタンプに同期させ(self.play_line(i, ...)、self.wait_until(...)、self.play_until(...))、メインビジュアルを y > SAFE_BOTTOM に保ち、常に self.finish() で終了します。
    • デフォルトのエンジンは ManimGX です(@manim SceneName)。特定のシーンでManimCEの機能が必要な場合は、script.md に @manim SceneName ce とマークします。
  • **スタンドアロンシーン(スタジオ外)**の場合:
    • ManimGX では import manimgx as m(または from manimgx import *)、ManimCE では from manim import * を使用します。
    • 暖色ライトパレット(#F5F0E8 または #FFF9F0)を適用し、明示的に暗いベースのテキスト色(#141413 または #454545)を指定して、テキストや演算子が白地に白で不可視にならないようにします。

API検証(推測ゼロ)

クラス、メソッドシグネチャ、継承された Mobject メソッドについて不確かな場合は、search_api.py(videoワークスペース内では ./studio api)を実行します。

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

ManimCE をターゲットにする場合は --engine ce を使用します。パラメータを発明したり、文書化されていないメソッドを推測したりしないでください。


段階4: 高速な視覚検査とレンダリング

終了コードが成功しただけでは完了と見なさず、必ず視覚的にレイアウトと衝突を確認してください。

  • videoスタジオ内:
    1. ./studio voice <project> を実行して(script.md が変更された場合)timeline.json を生成します。
    2. 高速レイアウトおよびストーリーボード検査を行います(約1秒、MP4エンコードなし):
      ./studio inspect <project>
      
      これは manimgx inspect を呼び出し、クリップされた/重なった/小さなラベルをフラグし、レイアウトエラー時にノンゼロで終了し、projects/<project>/build/clips/<Scene>.storyboard*.png を書き込みます。
    3. read_file で *.storyboard*.png を開いて視覚的に検査し、配置、可読性、SAFE_BOTTOM クリアランスを確認します。
    4. ドラフト/最終ビデオをレンダリングします:
      ./studio manim <project> --draft   # 720p 高速チェック
      ./studio manim <project>           # 1080p プロダクションクリップ
      
  • スタンドアロン ManimGX スクリプト:
    manimgx inspect scene.py MainScene -o storyboard.png
    manimgx render scene.py MainScene -o out.mp4
    
  • スタンドアロン ManimCE スクリプト:
    manim -ql scene.py MainScene   # 高速ドラフト
    manim -qh scene.py MainScene   # 1080p60 最終
    

段階5: トレースバックとレイアウトの自己修復

レンダリングまたは inspect が失敗した場合:

  1. references/common-fixes.md を参照して、ManimGX および ManimCE のエラーパターンを確認します。
  2. AttributeError または TypeError の場合は、<SKILL_DIR>/scripts/search_api.py で失敗しているクラス/メソッドを検索します(MRO継承ルックアップをサポート)。
  3. manimgx inspect のストーリーボードがラベルの重なり、端のクリッピング、SAFE_BOTTOM 以下のオブジェクトを示している場合は、座標/アンカーを調整するか、残留オブジェクトを明示的に FadeOut/exit し、inspectを介さなくなるまで再実行します。
  4. コアとなるビジュアルと数学的デザインはそのまま保ち、エラーを黙らせるためだけに教育的特徴を削除しないでください。

Individual skills in this repo

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

関連スキル