Communitygithub.com

解説動画スキル(Hellboy)

非技術者向けの2~3分の縦型(9:16)テック解説動画を作成します。アニメ風のキャラクター「Hellboy」が登場し、参照リールのスタイル(チャプター追跡、図解、カラオケ字幕、リップシンク、インド英語音声)を踏襲します。技術トピックに関する解説動画・リール・ショートの作成、スクリプト、ストーリーボード、レンダリング、改善を依頼されたときに使用します。

解説動画スキル(Hellboy) とは?

このスキルは、1つの技術トピックを非技術者でも初見で理解できる2~3分の完成度の高い縦型MP4動画(1080×1920)に変換するAIエージェント機能です。視覚スタイル、テンポ、スクリプト構造は、`docs/01-style-bible.md` で分析された参照チャンネルからクローンされています。動画制作において、テキストファイル(スクリプトとstoryboard.json)のみをAIが記述し、音声・字幕・アニメーション・キャラクター・音楽・レンダリングは `engine/` 内のエンジンが担当します。このスキルは、ユーザーからトピックが与えられたとき、追加の質問なしに、スクリプト作成(7ビート構造、360~470語)、ストーリーボード作成(20~32シーン)、検証、プレビュー、レンダリング、最終QAまでの全工程を自動的に実行します。非交渉事項として、キャラクター「Hellboy」の再描画禁止、固定音声、指定語数・時間内の収録、すべての文で画面変化を伴うこと、検証通過が必須です。対応プラットフォームは、このスキルが組み込まれたAIエージェント(Claude Code等)のコマンドライン環境です。`make_video.py` および `validate_storyboard.py` スクリプトを使用し、リポジトリルートからコマンドを実行します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bhuvanchandmaddi/video-generator-skill/tree/HEAD/skills/explainer-video

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

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

ドキュメント

解説動画スキル(Hellboy) は何をしますか?

あなたは1つの技術トピックを、非技術者が初見で理解できる2~3分の1080×1920 MP4に変換します。視覚スタイル、テンポ、スクリプト構造は、参照チャンネル(docs/01-style-bible.md で分析済み)からクローンされています。2つの要素は意図的にオリジナルです:キャラクター(Hellboy) と音声です。

あなたはテキストファイル(スクリプトと storyboard.json)のみを記述します。engine/ 内のエンジンが音声、キャプション、アニメーション、キャラクター、音楽、レンダリングを担当します。


ユーザーがトピックだけを指定した場合

追加の質問をせずに全工程を実行します:

  1. トピックからスラッグを作成し(例:how-dns-works)、python engine/make_video.py new videos/<slug> を実行します。
  2. videos/<slug>/script.md(docs/02)を作成し、次に videos/<slug>/storyboard.json(docs/03 + docs/04)を作成します。examples/upi-explained/ のパターンをコピーします。
  3. python engine/validate_storyboard.py videos/<slug> を実行します。すべてのERRORを修正し、0 error(s) と表示されるまで繰り返します。
  4. python engine/make_video.py preview videos/<slug> を実行します。画像が表示されたら、build/preview.png を docs/06 セクションBと照合し、修正します。
  5. python engine/make_video.py render videos/<slug> を実行します。パス output/<slug>.mp4、再生時間、2行の要約を返信します。

非交渉事項

  1. Hellboyは再描画されません。 彼は character/hellboy/hellboy.js からのみ提供されます。show、arm(down/point/explain)、expression の設定のみ許可されます。character/hellboy/CHARACTER_BIBLE.md を一度読んでください。
  2. 音声は固定されており、engine/config.json にあります。動画ごとに変更しないでください。
  3. 長さ:ナレーション360~470語、2:00~2:50。 1文は20語以下。
  4. すべての文で画面上の何かが変化します。 アイテムは、そのキーワードが話されるとき("at")に表示されます。
  5. 正確さはシンプルさに勝ります。 何かを省略することで単純化し、決して誤ったことを言って単純化しないでください。
  6. バリデーターが合格すること(0 errors)がレンダリングの前提条件です。

ワークフロー(この順序で実行)

#ステップ参照ドキュメント出力
1スキャフォールド–python engine/make_video.py new videos/<slug>
2スクリプトの計画と作成docs/02-script-writing.mdvideos/<slug>/script.md(360~470語、7ビート)
3ビジュアルの計画docs/03-visual-planning.mdシーンリスト:ナレーション → タイプ、見出し、キャラクター
4ストーリーボードの作成docs/04-storyboard-reference.mdvideos/<slug>/storyboard.json(または meta.json + scenes.jsonl → assemble)
5検証–python engine/validate_storyboard.py videos/<slug> → 0エラーになるまで修正
6プレビュー + QAdocs/06-qa-checklist.mdmake_video.py preview videos/<slug> → build/preview.png を確認、修正
7レンダリングdocs/05-production.mdmake_video.py render videos/<slug> → output/<slug>.mp4
8最終QAdocs/06-qa-checklist.mdスコア ≥ 85、すべてのMUST項目合格

小規模/ローカルモデル? ステップ2~5の代わりに docs/07-small-model-playbook.md に従ってください。作業を1シーンずつのプロンプトに分割します。

7ビートスクリプト(暗記)

フック(22語以内:「Xを解説。」/「Xは実際どう動く?」/ 驚きの主張 / 共感を呼ぶアクション)→ 緊張(謎)→ ロードマップ(「さあ、追ってみましょう…」)→ 本文(3~6チャプター:概念 → 平易な意味 → 日常例 → 結果;名前のある人物を使った1つの一貫した例)→ ひねり(「でも、ここが面白いところなんです…」)→ まとめ(「こんな風に覚えましょう」各チャプター1行)→ 決めゼリフ(フックと呼応する断片:「1回のスキャン。4つのプレイヤー。2秒。」)。

シーンのレシピ(暗記)

  • 1シーン = 1~3文(8~28語、3~8秒)。動画あたり20~32シーン。
  • visual.type は docs/03-visual-planning.md の判定表から選びます。動画あたり7~12種類の異なるタイプを使用します。
  • Hellboyは40~70%のシーンに表示します(常に:最初のシーン、ひねり、まとめ、最後のシーン)。sequence、hub、diagram、compare の場合は非表示にします。
  • 大きな図は2~4シーンにわたって構築し、"continue": true + "shown": true アイテムと同一の見出しを使用します。
  • 見出しは2~6語で、1つの *アクセント* 単語を含めます。画面上のラベルは1~4語。

コマンド(リポジトリルートから)

# 最初に有効化: source .venv/bin/activate   |   Windows: .\.venv\Scripts\Activate.ps1
python engine/make_video.py new       videos/<slug>   # テンプレート
python engine/make_video.py assemble  videos/<slug>   # meta.json + scenes.jsonl → storyboard.json
python engine/validate_storyboard.py  videos/<slug>   # 必須:0エラー
python engine/make_video.py preview   videos/<slug>   # build/preview.png(シーンごとに1フレーム)
python engine/make_video.py render    videos/<slug> [--fast]

初回実行時:./setup.sh(Linux/macOS)または setup.ps1(Windows)。完成した動画は output/<slug>.mp4 に保存されます。

参考資料

  • examples/upi-explained/(ウォームペーパー)と examples/load-balancer-explained/(ブループリント)— 完全な実例。これらのパターンをコピーします。
  • templates/ — script.template.md、storyboard.template.json。
  • docs/01-style-bible.md — 参照チャンネルの特徴を測定したもの(ルールの存在理由)。
  • engine/icon_names.txt — 許可されている全2,359個のアイコン名(Lucide)。

関連スキル