Communitygithub.com

MrRoam/explainer-video-skill

中文解説動画、科学普及動画、原理アニメーション、または3Blue1Brownスタイルのビデオ説明を作成します。Codexで脚本とストーリーボードを作成し、ローカルのManim、Kokoro音声、FFmpegを活用してMP4と字幕を出力します。

explainer-video-skill とは?

このスキルは、AIエージェント(特にCodex)が「Xについての解説動画を作って」というリクエストに応じて、完全なカスタム動画を生成できるようにするものです。Codexは動画の内容(脚本)とアニメーションコード(Manimを使用)の両方を担当し、音声合成(Kokoro)と動画レンダリング(FFmpeg)はローカル環境で実行されます。デフォルトでは中国語、初心者向け、約1分間、720p/30fpsで生成され、ユーザーからの特定の指示が優先されます。3Blue1Brownスタイルの視覚的推論(暗い背景、限られたアクセントカラー、連続的な形状変化、局所的な拡大、数式と図形の対応変換)を模倣し、直感的な理解を促してから数式を提示する構成をとります。スキルはローカルのPython、FFmpeg、音声モデル、中国語フォントの設定を必要とし、`runtime.local.json`または環境変数で構成を管理します。動画制作のワークフローは、`lesson.json`(脚本とストーリーボード)と`scene.py`(アニメーションコード)の同時編集に基づいており、具体的な例から原理へと進むアプローチを取ります。最終的な納品物には、MP4、SRT字幕、中国語の脚本、再現可能なソースコードが含まれます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add MrRoam/explainer-video-skill

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

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

ドキュメント

中文解説動画

カスタム動画を納品します。Codexが内容とアニメーションコードを担当し、ローカルツールが音声、レンダリング、合成を担当します。デフォルトは中国語、初心者向け、約1分間、720p、30fps。ユーザーのその場の指示を優先します。

デフォルトでは、3Blue1Brownのグラフィカル推論手法を参考にしています:暗い背景、少数の固定された意味を持つアクセントカラー、連続的な図形変化、部分的な拡大、そして数式と図形間の対応する変形。まず直感を構築し、その後で数式を示します。現在のトピックに合わせて、独自の脚本とビジュアルを作成します。

再利用ツール

本機の設定はスキルルートの runtime.local.json に保存されます。EXPLAINER_RUNTIME または --runtime で指定することもできます。まず設定内のPython、FFmpeg、音声モデル、利用可能な中国語フォントを確認します。設定が不足している場合は、README.md に従って既存の環境を設定するか、不足している依存関係をインストールします。お試し用に常駐サービスを立ち上げたり、再利用可能な環境を再インストールしたりしないでください。

Windowsで初めてインストールする場合は、scripts/setup.ps1 を実行します。これにより、必要なCPU依存関係が自動的にインストールされ、中国語モデルがダウンロードされ、ローカル設定が保存されます。有効な設定が既にある場合は、パスのみをチェックします。このスクリプトはPython、TeX、CUDAをインストールしません。既存のツールが別のディレクトリにある場合は、対応する環境とモデルへのパスを渡して再利用します。

python "SKILL_DIR\scripts\init_project.py" --workspace "WORKSPACE" --name concept-video

SKILL_DIR は現在のスキルディレクトリ、WORKSPACE は今回のワークスペースの絶対パスです。スクリプトは小さなテンプレートをコピーするだけで、依存関係はダウンロードしません。ソースコードは outputs/concept-video-project に、キャッシュは work/explainer/concept-video にあります。複数の動画には異なる name を使用します。ツールが移動された場合は、パスを再設定します。

脚本と制作

プロジェクト内の lesson.json と scene.py を同時に編集します。テンプレートは導関数の例です。タイトルを変更しただけでは新しいトピックになりません。フィールド、ストーリーボードの同期、および実行コマンドについては、references/pipeline.md を参照してください。

具体的な問題を選び、例から原理へと進みます。各ナレーションは観察可能な変化に対応します。例えば、点の移動、曲線の変化、変数の更新、関係性の段階的な顕在化などです。数学的な結論は成立条件を明確に記述し、字幕、数式、数字は台本と一致させます。フォントはローカル設定から取得します。テンプレート内のMathTexはTeXを必要とします。TeXがない場合は、代わりにTextと幾何オブジェクトを使用できます。

デフォルトでは、ローカルのKokoro中国語版、CPU、ダウンロード済みの音声を使用します。追加の大規模言語モデルや音声APIは必要ありません。ナレーション内の数学記号、LaTeX、英語の用語は、中国語の読み方に書き換えます。まず短いセクションで試聴し、その後全体を生成します。すべての音声を自動ダウンロードしたり、プロンプトなしで音声バックエンドを切り替えたりしないでください。他の音声は、references/pipeline.md に従って接続できます。

チェックと納品

まず低解像度のプレビューを生成し、中国語、数式、遮蔽、境界を確認してから、最終動画をエクスポートします。ナレーションが無音でないこと、各セグメントが完全であること、終了が途切れていないことを確認します。レンダリングスクリプトはサイズと時間の同期をチェックしますが、視覚と発音は実際に確認する必要があります。

MP4、SRT、中国語の台本、再実行可能なソースコードを納品します。納品ファイルはワークスペースの outputs に、中間ファイルは work に配置します。実際に使用した音声バックエンドと未解決の制限事項を説明します。スクリプトの成功をもって、ユーザーが音質に満足していると説明しないでください。

関連スキル