Communitygithub.com

motion-educator

コードで構築された高品質な教育用モーションビデオ(解説、レッスン、コンセプトフィルム、ショート、ビデオエデュカシ)を作成します。常にストーリーボードを最初に作成し、ナレーションはインドネシア語または英語のトークとして書き、ワンテイクで録音し、映像は音声に合わせてカットされます。

motion-educator とは?

Motion Educatorは、Claude CodeやCodexなどのAIエージェントが、まるで高級なスタジオで制作されたかのような教育用モーションビデオをコードで作成するためのスキルです。ユーザーが「◯◯はどのように動作するのか」といった説明動画やアニメーションレッスンを依頼した際に使用します。このスキルは、Three.jsやGSAPを用いたレンダリングエンジン、ストーリーボード管理ツール、ElevenLabsによる音声生成機能、音楽ミックスツールなど、動画制作に必要なすべてのツールキットを提供します。ワークフローは厳格で、まず詳細なストーリーボード(描画済みのフレームを含む)を作成し、人間の確認を得た後にのみ動画の構築を開始します。動画はWebページとして構築され、シーク可能なタイムライン上で1フレームずつレンダリングされるため、修正や再レンダリングが容易です。最終出力はMP4(1080p60、ランドスケープ16:9またはポートレート9:16)で、BGM、効果音、ナレーションを含むフルミックス版と、ミュージックのみの版の両方を提供します。このスキルは、ワークスペース内のプロジェクトにコピーして使用することを前提としており、Node.js、Playwright、FFmpeg、Python 3といった外部依存関係があります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeative/motion-educator/tree/HEAD

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

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

ドキュメント

Motion Educator

あなたは、20~120秒の短い教育用フィルム(ランドスケープの解説動画またはポートレートのショート動画)を作成します。見た目は高価で、一つのことをうまく教えます。フィルムは、一時停止されたタイムラインを持つWebページです。すべてのフレームはシークすることで描画されるため、フレーム落ちはなく、どのショットも個別に修正して再レンダリングできます。このスキルに含まれるキットが、そのエンジンです。examples/ には、このスキルに従って作成された完成フィルムが、それぞれのストーリーボード、ソース、キューシート、ナレーションとともに保存されています。まず読むべきものは langit-biru(キャプションのみ、最もレビューされたもの)と petir-guntur(ナレーション付きショート)です。

現在のステップに必要なリファレンスのみを読んでください。

ステップ読むもの
何をどの順序で教えるか決めるreferences/pedagogy.md
ストーリーボードの作成と描画(ゲート)references/storyboard.md
ルック、アクセント、ステージライト、3Dの選択references/look.md
キットを使用したフィルムの構築references/engine.md、次に references/motion.md
ナレーションの作成:トーク(キャプションではない)、インドネシア語と英語のレジスターreferences/narration.md
音声:選択、ElevenLabsでのワンテイク収録、フィルムの音声へのカットreferences/voice.md
音楽、効果音、ミックスreferences/sound.md
レンダリングの確認、独立したレビューreferences/review.md
ブラウザではなくraeaでのレンダリングreferences/raea.md

絶対に曲げないこと

  1. ストーリーボードが先であり、それは描かれる。 storyboard.json が kit/tools/storyboard.mjs でエラーゼロで合格し、ユーザーがボードを確認するまで、フィルムファイルは一切書き込まれません。すべてのショットには描画されたフレーム(どのように始まり、何が起こり、どのように終わるか)があり、実際のフレーム座標でスケッチされているため、ビルドはそれらから直接カットできます。ユーザーが無人実行を依頼した場合は、ボードを送信して続行します。それ以外の場合は、承認を待ちます。
  2. 真実であり、出典を明示する。 画面上のすべての数字と主張は、ストーリーボードのファクトシートに、その出典とともに記載されます。出典が不明な場合は、述べてはいけません。描かれたものは書かれたものと一致します。数値を表す棒、メーター、またはパスはその数値から計算され、縮尺通りでない図はその旨を画面上に表示し、数値はその値で表示されます(誤った値を経由するカウントアップはしません)。
  3. ミュートでも説明が成立する。 画像と画面上のテキストが説明を担い、音声とサウンドがそれを確実なものにします。初めて見る人が音声をオフにしても、何を学んだかを言えるようにします。説明全体の要となるステップは、メカニズムとして描かれ(何が入り、何に遭遇し、何が出てきて、どこに行き着くか)、決してキャプションだけに任せません。
  4. 一つの時計。 すべてのアニメーション値は、タイムラインの時間の関数です。CSSアニメーション、requestAnimationFrame ループ、Date.now()、シードなしのランダム性は使用禁止です。
  5. ストーリーボードが時間の源泉である。 フィルムは storyboard.json からショットの開始と終了を読み取ります。キャプションとチャプターレールはそこから生成されます。計画はそこで変更し、フィルム内で手動で変更してはいけません。音声があるフィルムの場合、録音されたテイクがそれらの時間を書き込みます(voice.mjs)。
  6. 自分の作品を自分で評価してはいけない。 フルレンダリングの前にすべてのショットの静止画を確認し、レンダリングに対して測定を実行し、ビルドを行っていない新しいレビューアーが結果を判断します(references/review.md)。
  7. 音声があるフィルムは、トークとして書き、ワンテイクで収録する。 スクリプトは全体を書き、ショットが存在する前に声に出して読み上げます。それは最初から最後まで一回で収録され、画像は音声に合わせてカットされます。ショットごとに一文、一文ごとに録音、計画に合わせてポーズをトリミングすることは絶対にありません。
  8. チェックしなかったことを述べよ。 あなたは聞くことができません。ミックスは測定によって設定されたこと、人が何を聞くべきかを名前を挙げて伝え、フルミックスに加えて音楽のみのバージョンを提供します。

ワークフロー

0. ワークスペース

キットはスキル自身のフォルダからではなく、ユーザーのプロジェクトにコピーして使用します。

node <skill>/kit/tools/new.mjs <workspace> <film-name>   # kit/ と package.json をコピー(存在しない場合)、films/<film-name>/ をスキャフォールド
cd <workspace> && npm install                            # three.js, GSAP, フォント
sh kit/audio/fetch.sh                                    # サウンドライブラリ(コミットされない:ライセンス)

Node 20+、Chromium 付き Playwright、FFmpeg、およびミックス用のPython 3(numpy が必要)が必要です。node kit/tools/doctor.mjs でこれらすべてをチェックし、インストールすべきものを指示します。new.mjs に --portrait を追加すると、1080x1920 のショート動画用になります。

1. ブリーフ(数行、ストーリーボードのヘッダーに)

誰が見るのか、彼らがすでに知っていること、そして 約束:視聴後に言えるようになる一文。一つのフィルムに一つの約束。トピックが二つの約束を必要とするなら、それは二つのフィルムです。観客が読む言語、フォーマット(レッスン用はランドスケープ、ショート用はポートレート)、そしてフィルムが音声を使うか、キャプションのみで説明するかを選択します。

2. リサーチとファクトシート

フィルムが行うすべての主張を、それぞれの出典とともに、storyboard.json の facts としてリストアップします。一次資料・公的機関の資料を優先します。算術は自分で行い、それを示します(「5,9倍」のような数値は、それが何から計算されたかを明記します)。何を単純化しているかを書き留め、フィルムがそれについてどのように正直に扱うかを決定します。

3. スクリプト(フィルムに音声がある場合)

references/narration.md に従います。一つの質問、観客自身のレジスターで書かれた継続的なトークとして、ショットリストの前に声に出して読み上げ、時間を計ります。その後、ショットに分割します。各音声ショットの voice は、スクリプトの該当部分です。

4. ストーリーボード:ゲート

references/storyboard.md に従います。簡潔に言うと、幕、次にショット(約3秒ごとに新しい画像)、各ショットには教える内容、キャプション、画面に表示されるもの、動き、次のショットに引き継ぐもの、トランジション、サウンド、確認すべきこと、引用するファクト、そして 2~3つの描画フレーム が含まれます。音楽のビートに合わせてカットします。

node kit/tools/storyboard.mjs films/NAME --png     # エラーゼロ、その後 films/NAME/storyboard/*.png を表示

ページをユーザーに送信します。コンタクトシート(フィルム全体のフレーム)を最初に送ります。

5. テイク(フィルムに音声がある場合)

references/voice.md に従います。その言語のネイティブな音声を選択し(できれば2~3をユーザーに聞かせます)、スクリプト全体をワンテイクで収録し、フィルムをそれに合わせてカットします。以降、ストーリーボードの時間はテイクの時間になります。

node kit/audio/voice.mjs films/NAME --script                       # 収録するテイク
node kit/audio/voice.mjs films/NAME --generate                     # APIキーを使用:テイクとその単語の時間
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS     # 音声コネクタ使用:両方を手渡す
node kit/audio/voice.mjs films/NAME                                # 各ショットの時間と、聞くべき単語

6. ビルド、一度に一つのショット

references/engine.md に従います。各ショットに <section class="scene"> を与え、s.sNN.start と s.sNN.end の間でアニメーションさせます。ストーリーボードの順序でビルドし、各ショットが完成したら静止画を確認します。

node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9      # 完成フレーム、数秒の作業

各静止画を描画フレームと比較します。フレームが (x, y) に配置したものは、(x, y) にあります。

7. レンダリング

node kit/tools/render.mjs films/NAME                  # out/picture.mp4、4秒セグメントで出力
node kit/tools/render.mjs films/NAME --only 12-16     # 修正後:変更されたセグメントのみ

60fpsで1分のフィルムは、4つのCPUコアで約30分かかります。バックグラウンドで実行し、その間にキューシートを書きます。

8. サウンド

references/sound.md に従います。カットがすでに乗っているビートを持つ一つの音楽ベッドと、実際のイベントに対する小さくクリーンな効果音を、films/NAME/cues.json に記述します。フィルムが公開される場合は、ライブラリトラックよりもフィルム用に作曲されたベッド(kit/audio/music.mjs)の方が適しています。

python3 kit/audio/mix.py films/NAME                   # out/NAME.mp4、完成ファイルでラウドネス測定
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4

node kit/tools/make.mjs films/NAME は、ステップ4から9のコマンドを順番に実行し(チェック、音声、レンダリング、ミックス、測定、共有用コピー)、最初に失敗した時点で停止します。これはビルド中の静止画確認の代わりにはなりません。

9. レビュー、修正、確認

references/review.md に従います。node kit/tools/check.mjs films/NAME(コンタクトシート、時間の固定、ラウドネス)、その後、フィルム、ストーリーボード、ユーザー自身の言葉を持つ新しいレビューアーが確認します。最大のギャップを修正し、変更されたものだけを再レンダリングし、新しいレビューアーがリストを確認します。品質基準に達するか、改善が表面的になったところで停止します。修正がショットの表示内容を変更する場合は、ストーリーボードをそのように変更し、ボードを再描画します。計画とフィルムは決して矛盾しません。

10. 納品

MP4(H.264、1080p60、約 -14 LUFS、トゥルーピーク -1 dBFS 未満)、共有用の軽量コピー、音楽のみのバージョン、ストーリーボードのページ、そして短く正直なメモ:何を測定したか、何を目視しただけか、誰も聞いていないこと、次に何をするか。

フィルムのファイル

films/NAME/
  storyboard.json     計画:ファクト、幕、ショット、描画フレーム。フィルムはここから時間を読み取る
  storyboard.html     ボード(生成)、storyboard/*.png はそのページ
  index.html          ショットまたはショットグループごとに一つの <section class="scene">
  film.css            このフィルムの部品、kit/css/film.css の上に重ねる
  film.js             タイムライン、kit/engine/motion.js で構築
  cues.json           音楽ベッドとすべてのサウンド、フィルムの時計に基づく
  voice/              ナレーション:take.mp3、各単語の時間、カット(voice.json)、subtitles.srt
  out/                レンダリング(コミットしない)

作業スタイル

  • ユーザーが見える場所で計画する(ボード)、その後、すべてのステップを尋ねずに構築する。
  • 作業が長引く場合は、何をしているのかを一行で伝える。
  • 作業を見せる:ボード、静止画、コンタクトシート、測定値、レビューアーの判定。

関連スキル