Communitygithub.com

C4KEBX/motionexplainers

ユーザーが金融、投資、歴史に関する60秒の縦型アニメーション解説動画の作成を依頼した際に使用します(「Xについての動画を作成」「/make-explainer <トピック>」)。リサーチ、ソース付きの事実、検証済みストーリーボード、人間によるレビューの承認、最終的なナレーション付きレンダリングまでを実行します。

motionexplainers とは?

このスキルは、指定されたトピックから1080x1920の60秒縦型アニメーション解説動画を完全自動で生成するパイプラインを提供します。ユーザーが「/make-explainer <トピック>」と指示すると、まずWeb検索とWebFetchを使って信頼できる一次情報源(BLS、連邦準備制度、SEC、企業の財務報告、Wikipediaなど)から事実を収集し、数値や日付、引用のすべてにソースを明記した`facts.json`を作成します。その後、155語程度のナレーションと6~10シーンのストーリーボードを生成し、専用ツールで事実とストーリーボードの整合性を検証します。検証が通ったら、人間がレビューシートを確認して承認するまで「レビューゲート」で停止し、承認後に`npm run produce`で最終的なナレーション付き動画をレンダリングします。動画内のすべての数値・日付・引用は、ユーザー自身が実際に開いて確認したWebページからのみ取得され、記憶に基づく数字は一切使用されません。金融や投資の内容は教育・歴史的なものに限定され、アドバイスや予測は含まれません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/C4KEBX/motionexplainers/tree/HEAD/.claude/skills/make-explainer

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

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

ドキュメント

60秒の解説動画を作成する

このリポジトリのパイプラインを使って、トピックを完成した1080x1920の動画に変換します。コストはかかりません。リサーチ、執筆、修正はあなたが行い、スクリプトがチェックとレンダリングを行います。リポジトリのルートディレクトリから作業してください。ストーリーボードを書く前に.claude/skills/make-explainer/rules.mdを読んでください。

絶対ルール

  • 画面上のすべての数字、日付、名前、引用はfacts.json内の事実に基づき、そのソースはあなたがWebFetchで実際に開いたものに限ります。記憶から数字を入力してはいけません。主張にソースが付けられない場合は、それを削除してください。ナレーションはあなたが開いたページに書かれていることのみを述べ、読んでいない背景情報を補足してはいけません。
  • ストーリーボードを通すためにsrc/、tests/、バリデーター、またはこのスキルを編集しないでください。ストーリーボードまたは事実を修正してください。ソースを再度読まずに、事実のデータをストーリーボードに合わせて変更したり、その逆を行ったりしないでください。
  • レビューゲート(ステップ6)で停止してください。ユーザーがレビューシートを承認するまでnpm run produceを実行しないでください。
  • 金融と投資は教育と歴史に限定されます。アドバイス、予測、「あなたは~すべき」は禁止です。すべての数字について、期間とソースを明記してください。

ワークフロー

動画に関するすべてのデータはvideos/<スラッグ>/(小文字、数字、ハイフン)に保存されます:facts.json、storyboard.json、review/。

  1. ブリーフィング。 トピック、動画が証明する一文の主張、視聴者を決めます。主張が不明確な場合のみ、質問を1つ行います。デフォルトの音声はen-US-AndrewNeural、音楽はnullです。
  2. リサーチ。 WebSearchで検索し、次にWebFetchで一次情報源(BLS、連邦準備制度、SEC、企業の財務報告、Wikipedia、博物館や図書館のページなど歴史的な日付用)を開きます。ページから数字をコピーします。5~8個の事実を書きます:id、claim(ソースが述べているままの単位と期間を含む完全な文)、value(一つの数値の場合)またはdataset(グラフやリストが表示する正確なデータ)、source(名前とURL)。主張に「デモデータ」という文言を残さないでください。
  3. 検証。 npm run verify-facts -- --facts videos/<スラッグ>/facts.json --out videos/<スラッグ>/verify.jsonを実行します。not-found、partial、unreachableのすべてについて、ソースを再度開き、事実を修正または削除してください。このツールは参考用です。正確性はあなたの責任です。小さな整数(8、9、27など)はほとんどのページに現れるため、supportedはそれだけでは信頼できません。自分でソース行を読んでください。何らかの理由でfacts.jsonを編集した後は、verify-factsを再度実行してください。レビューシートは古い結果をマークします。
  4. スクリプトとストーリーボード。 ナレーション全体で約155語(55~60秒)、6~10シーン、シーン1にフック、1シーンにつき1つのアイデア、シーンタイプは多様に(連続して3つ同じタイプを避ける)。storyboard.schema.jsonで正確なフィールドと制限を確認し、fixtures/finance.storyboard.json、fixtures/history.storyboard.json、fixtures/ancient.storyboard.jsonの形をコピーしてください。videos/<スラッグ>/storyboard.jsonを書き込みます。
  5. チェックと修正。 npm run check -- --storyboard videos/<スラッグ>/storyboard.json --facts videos/<スラッグ>/facts.jsonを実行します。すべての問題(各メッセージはシーンIDと修正方法を示します)を修正し、再実行します。最大6ラウンドまで。それでもブロックされるものがあれば、正確に報告してください。警告(長さ、アドバイスの表現、トレースされていないテキスト)は、修正するか正当化する必要があります。長さの見積もりは約10%の誤差(実際の語速は毎秒2.5~3.2語)なので、55~60秒を目指してください。produceが最終的な判断を下し、長さが拒否された場合はナレーションを調整して再実行するだけです。
  6. レビューゲート。 npm run sheet -- --storyboard videos/<スラッグ>/storyboard.json --facts videos/<スラッグ>/facts.json --verify videos/<スラッグ>/verify.json --out videos/<スラッグ>/reviewを実行します。ユーザーにvideos/<スラッグ>/review/review.htmlを開くよう伝えます。要約を提供します:主張、シーンリスト、語数と推定長さ、各事実とそのソースチェック、すべての警告。承認または編集を求めます。停止して待ちます。
  7. 制作。 承認後:npm run produce -- --storyboard videos/<スラッグ>/storyboard.json --facts videos/<スラッグ>/facts.json --out out/<スラッグ>を実行します。約2分かかります。長さが拒否されたり、シーンが短すぎる場合は、ナレーションを変更し、checkを再実行し、再度制作します(音声テキストはキャッシュされます)。ファイルパス、長さ、ラウドネスを報告します。あなたが判断しなかったことを明確に述べてください:音声の品質、発音、ペース、味わい。ユーザーに動画を見るよう依頼します。

問題が発生した場合

  • 理解できないチェックメッセージ: シーンIDが示されています。rules.mdでそのシーンの制限を確認してください。修正方法を推測しないでください。
  • 事実とシーンが矛盾する場合: ソースを再度開いてください。ソースに基づいて間違っている方を修正し、一方を他方にコピーしないでください。
  • 地図の地域が見つからない場合: メッセージが提案する表記(「アメリカ合衆国」など)を使用してください。地域はfocusボックスと重なる必要があります。
  • 音声の問題(ネットワーク): npm run produceはEdge TTSのためにインターネット接続が必要です。--voice standinは、ドライラン用にほぼ無音のプレースホルダー音声を提供します。
  • セットアップが不足している場合: npm installとnpm run setup:ttsを一度実行してください。

ユーザーへの出力

簡潔に保ちます:ファイルパス、動画が主張している内容、長さ、ラウドネス、使用された事実とソース、およびあなたが受け入れて理由を説明した警告。

関連スキル