Communitygithub.com

manimater-components

JSON駆動の再利用可能なManimコンポーネントライブラリ(manimater-components)を使用します。ユーザーがManimで概念をアニメーション化・説明したい場合、ストーリーボードJSONを構築・検証したい場合、90以上のコンポーネント(電気、電力、信号、マイクロエレクトロニクス、機械学習、コンピュータサイエンス、金融、物理学、化学、データベース)からトピックに合ったものを検索したい場合、コンポーネントをプレビューしたい場合、または新しいコンポーネントを作成してライブラリに貢献したい場合に使用します。また、コードを書かない人がアニメーションを説明して貢献用のコンポーネントを入手したい場合にも使用します。

manimater-components とは?

manimater-componentsは、JSONによって駆動されるテスト済みManimコンポーネントのライブラリです。コンポーネントとは、名前とパラメータの組み合わせであり、ユーザーはアニメーションコードを一切書く必要がありません。リポジトリは https://github.com/bishnt/manimater-components (MITライセンス)で、Manimaterアプリも同じライブラリを使用しています。 このスキルは主に2つのタスクを処理します:(1)既存のコンポーネントを使ってストーリーボードを構築・検証する「コンポーネントの使用」、(2)新しいコンポーネントを作成しテストして貢献する「コンポーネントの追加」です。90以上のコンポーネントが電気、電力、信号、マイクロエレクトロニクス、機械学習、コンピュータサイエンス、金融、物理学、化学、データベースなど多様な分野をカバーしています。 コンポーネントの使用時は、カタログから適切なものを選び、最大12シーン・各300文字以内の制約に従ってJSONストーリーボードを作成し、バリデーターでチェックします。プレビューは `manimate.preview` コマンドで行えます。新規コンポーネント追加時は、テンプレートに従い最大5パラメータ、Manimに依存しない純粋なPythonロジックで実装し、テストを書く必要があります。コードを書けないユーザー向けにはGitHubのIssueフォーム経由で簡単に貢献できる仕組みも用意されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bishnt/manimater-components/tree/HEAD/skills/manimater-components

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

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

ドキュメント

manimater-components は何をしますか?

JSON駆動のテスト済みManimコンポーネントライブラリ。コンポーネントは名前とパラメータの組み合わせであり、アニメーションコードは一切必要ありません。リポジトリ: https://github.com/bishnt/manimater-components (MIT)。Manimaterアプリも同じライブラリを使用しています。

あなたに依頼される可能性のある2つのタスク:

  1. コンポーネントを使用する: トピックに適したコンポーネントを選び、有効なストーリーボードを作成し、プレビューする。
  2. コンポーネントを追加する: ルールに従ってコンポーネントを作成し、テストし、貢献する。

ユーザーがどちらを望んでいるかを判断してください。既存のコンポーネントで実現できないアニメーションをユーザーが説明した場合は、「コンポーネントを追加する」に進んでください。

1. コンポーネントを使用する

適切なコンポーネントを見つける

  1. references/catalog.md を読む: 各コンポーネントの1行説明とパラメータが記載されています。 (リポジトリのクローン内にいる場合、ルートの catalog.json に完全なパラメータ詳細と各コンポーネントの example が含まれています。)
  2. トピックだけでなく、説明したいアイデアに合致する説明を持つコンポーネントを選びます。汎用的なコンポーネントよりも特定のコンポーネントを優先します(モーターの説明には bullet_points より synchronous_motor)。ストーリーを構築するために複数を組み合わせることもできます: title_card、次にコンセプトコンポーネント、最後に callout で最終的な要点を示す。
  3. 選択したコンポーネントの catalog.json 内のエントリを読み、正確なパラメータ名、型、choices、example を確認します。

ストーリーボードを作成する

ストーリーボードはJSONです。ライブラリが自動的にチェックします:

{ "title": "同期モーターの仕組み",
  "scenes": [
    { "component": "title_card", "params": { "title": "同期モーター" }, "narration": "なぜこのモーターは決して滑らないのか?" },
    { "component": "synchronous_motor", "params": { "poles": 2, "frequency_hz": 50 }, "narration": "回転子が回転磁界にロックオンします。" },
    { "component": "callout", "params": { "text": "速度は周波数と極数によって決まる。", "kind": "takeaway" }, "narration": "つまり速度は周波数のみに依存します。" }
  ] }

バリデーターが強制するルール: シーンは最大12、文字列は300文字まで、リストは最大8項目、未知のパラメータは削除、必須パラメータは存在しなければならない、choices は一致しなければならない。コンポーネント名やパラメータを決して捏造してはいけません。不足しているものがあればその旨を伝え、新しいコンポーネントを作成することを提案してください。

検証とプレビュー

pip install -e ".[dev]"                       # クローン内で実行; Manimに必要なffmpeg、Cairo、Pangoが必要
python - <<'PY'
import json
from manimate.storyboard import validate
sb, errors = validate(json.load(open("storyboard.json")))
print(errors or "有効")
PY
python -m manimate.preview <コンポーネント名>                        # そのexampleから previews/<コンポーネント名>.mp4 をレンダリング
python -m manimate.preview <コンポーネント名> --params '{"...": 1}'  # 独自のパラメータで
python -m manimate.preview --list

この環境でコードを実行できない場合は、ストーリーボードJSONと正確なコマンドを生成し、検証もレンダリングも行っていないことを明確に伝えてください。

2. コンポーネントを追加する

最初に references/component-template.py を読んでください。完全に動作するコンポーネントのテンプレートです。

判断する

  • 1つのアイデア、再利用可能。 「変圧器の仕組み」は1本の動画全体ですが、「2つの単語間のアテンション重み」はコンポーネントです。パラメータ(数値、ラベル、リスト)は多くの例で役立つように設定します。
  • references/catalog.md を確認し、既存のコンポーネントと重複しないようにします。
  • 自分で判断できないことはユーザーに尋ねます(誰のためのものか、何を調整可能にするかなど)。ただし質問は2つまでにし、それ以外は妥当な選択をしてその旨を明示します。

作成する

manimate/components/community/<名前>.py として保存します(スネークケース、ユニーク)。自動的に登録されます。テンプレートに正確に従い、以下のルールを守ります:

  1. パラメータは最大5つまで。各パラメータに説明(AIが読む)、デフォルト値または required=True、不正な入力に対して平易な英語のメッセージを返す validator が必要。値をクランプ、トリム、フォールバックし、変な入力でもクラッシュしない。
  2. example 辞書は有効であり、レンダリングできなければならない。
  3. 数学、アルゴリズム、レイアウトは Manimを使わないプレーンなPython関数 で記述し、単体テスト可能にする。
  4. 色は manimate.theme のものだけを使用(theme.ACCENT など)、16進数は不可。画面上のテキストは短く平易に。ctx.fit(...) を使用して何もステージからはみ出さないようにする。
  5. 完成した絵全体を1つの FadeIn でフェードインし、その後意味を伝えるアニメーションを行う。与えられた時間(ctx.remaining、Ctx.beat)を使用する。ctx.play / ctx.wait を使用し、scene.play は使用しない。
  6. 純粋な描画コード: ネットワーク、ファイル、サブプロセス、eval、exec、getattr、ダンダーアクセスは禁止。インポートは manim、numpy、標準ライブラリ、およびライブラリ自身のモジュールに限定。CIとボットがこれら以外を拒否する。
  7. Manimプラグインのラップは、MITまたはクリエイティブ・コモンズライセンスの場合のみ許可。docs/WRITING_A_COMPONENT.md に従うこと。

プレーンPythonロジックのテストを tests/community/test_<名前>.py に作成します(エッジケース: 空、1項目、最大値、長いラベル)。汎用テストですでに全コミュニティコンポーネントのexampleをドライランしています。

確認する

python -m manimate.preview <名前>
python -m pytest tests/community
python -m manimate.catalog > catalog.json
python scripts/gen_docs.py

実行した内容と結果を報告してください。何も実行できなかった場合はその旨を伝えます。

貢献する

ユーザーに、どちらの方法が適しているかを平易な言葉で伝えてください:

最後に、ユーザーがフォームに貼り付けられる3行の要約を提供します: 何を教えるか、パラメータ、処理した失敗ケース。

制限事項

  • カタログに存在しないコンポーネントが存在すると主張しないでください。レンダリングしていないのに見た目が正しいと主張しないでください。
  • MITライセンスまたは互換性のあるライセンスで、かつ出典を明記する場合を除き、他のリポジトリからのコードを貢献にコピーしないでください。manim-engのソース、ドキュメント、例はAIトレーニングデータとして使用してはいけません(docs/THIRD_PARTY.md を参照)。

関連スキル