Communitygithub.com

知識ビデオ

1つのトピックを、最後まで見たくなる知識解説動画に変えます。調査からコピー、画像、ルック&ストーリーボード、レンダリングまでの実績あるパスと、音楽編集、ビートタイミング、効果音、自己チェックのための小さなツール群を提供します。デザインは各トピックに合わせて自由に作れます。

知識ビデオ とは?

このスキルは、任意のトピック(知識、科学、歴史、仕組み解説など)を、Douyinの「Vibe知識大賞」で流行したような、音楽に乗せたオンスクリーンテキスト形式の短尺解説動画に変換するための包括的なワークフローを提供します。HyperFramesをレンダリングエンジンとして使用し、調査(article.md)→ スクリプト作成(script.md)→ 画像生成(images.md/image-prompts.md)→ ルック&ストーリーボード(looks/、storyboard.md)→ レンダリング(opening-preview.mp4、final.mp4)という段階的なパスに従います。各ステップでは、Anthropicのプロンプトガイドに従い、ロール、タスク、スタイル、チェックリストをXMLタグで分離したプロンプトを生成し、サブエージェントに委譲することも可能です。また、ビート解析、音楽ループ、効果音ミックス、画面上のテキストとビートのタイミング調整、QA用の連絡シート生成といった補助スクリプトも提供し、品質を担保します。事実のソース明示、アセットのライセンス確認、乱数シード固定などのMust Hold項目を厳守し、レンダリング前に自己チェックを行うことで、信頼性の高い動画制作を支援します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Win-Hao/knowledge-video/tree/HEAD/skills/knowledge-video

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

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

ドキュメント

知識ビデオ は何をしますか?

1つのトピックを、最後まで見たくなる知識ビデオに変えます。以下は実績のあるパスであり、固定された手順ではありません。ステップの統合、スキップ、順序変更は自由です。また、このトピックに合わせて、文章、ルック、モーションを自分でデザインしてください。

ユーザーとはその言語で話してください。以下のファイル名はデフォルトです。

大まかなパス

  1. 調査 → article.md: ソースを見つけ、ソース付きの記事を書きます。まずトピックがどのような形か(タイムライン、原因の連鎖、概念、比較、神話、1つのストーリー)を確認し、カバーするポイントを決定します。ユーザーが数を決めます。音楽の長さに基づいて2つか3つの選択肢を提示し、1つをおすすめします。
  2. コピー → script.md: 記事を、人がスクロールしながら見たくなるビデオに書き直します。
  3. 画像 → images.md または image-prompts.md: 実際の画像、またはAIイラスト用のプロンプト(画像APIは呼び出せないと仮定し、ユーザーが自身のツールを実行します)。
  4. ルックとストーリーボード → looks/, storyboard.md: ユーザーにいくつかの方向性を示し、音楽に合わせてストーリーボードを作成します。
  5. レンダリング → opening-preview.mp4 → final.mp4: 最初に短いオープニングを、確認できたらフルビデオをレンダリングします。

デフォルトでは、各ステップの結果を次に進む前にユーザーに表示します。間違った方向性は、レンダリング後に最もコストがかかります。ユーザーが「最後まで進めて」と言った場合は、そのまま進み、storyboard.md に選択内容と理由を記録します。

各ステップ: プロンプトを埋め、それに従う

Anthropicのプロンプティングガイドに従い、背景、要件、チェックを別々のXMLタグに、各行に理由を付けて保持します。分離された部分は混ざり合わず、理由を知ることでモデルが書かれていないことにも一般化できます。タグは、このトピックとユーザーが言ったことから、あなた自身が埋めます。

  • ブリーフ prompts/brief.md: 最初に1度埋め、各ステップ後に更新します。<context> だけ:トピック、オーディエンス、テイクアウェイ、長さ、向き、音楽、ユーザーの好き嫌い、以前のステップで確定したこと、ファイルの場所。

  • このステップのプロンプト prompts/<step>.md、4つのタグ:

    • <role>: このステップがどの役割を担い、その役割が何を最も気にするか。役割はステップごとに異なります。このステップに1つ選んでください。例:調査は知識編集者(ソースを最も気にする)、コピーは脚本家(視聴者がスワイプして離れるかどうかを最も気にする)、画像は写真編集者またはイラストレーター、ルックはアートディレクター、ストーリーボードはストーリーボードアーティスト、コンポジションはモーションデザイナー(各動きが何を説明するかを最も気にする)。
    • <task>: このステップが何を生成し、どこに出力するか。
    • <style>: 推奨アプローチ。各々に理由を添えて。推奨であってルールではありません。references/ の例から選ぶか、このトピックのために新しいものをデザインしてください。ユーザーが望むことを言った場合はそれに従い、望まないこともここに記録します。
    • <check>: 検証すべき項目を、ステップが完了したと見なされる前に1つずつ確認します。「Must hold」の項目も含めます。

    <role>、<task>、<check> は毎ステップ書き、<style> は不要な場合(通常は調査とレンダリング)は省略します。ユーザーが言わなかったことはトピックから推測し、不明な点はレポートで質問します。記入したプロンプトをステップの出力とともに表示します。ユーザーが編集した場合は、編集バージョンからステップをやり直します。

誰がそれに従うか: ユーザーとのやり取りが必要なステップ(ポイント数、どのルックか)は自分で行います。大規模な自己完結型のステップ(調査、画像の検索や画像プロンプトの作成、コンポジションの作成とレンダリング)はサブエージェントに委譲します。ブリーフとこのステップのプロンプト、ファイルパスのみを与え、コンテキストをクリーンにし、このステップに必要なものだけを保持します。サブエージェントはあなたとユーザーが話し合ったことを知らないため、両方が完全である必要があります。サブエージェントが終了したら、その出力を読み、自己チェックを実行してからユーザーに表示します。サブエージェントがない場合は、自分でプロンプトに従います。

Must Hold

  • 事実はソース付き: すべての年、名前、数字、引用は、信頼できるソース(論文、機関、アーカイブ、本人の言葉)に遡り、article.md にリンクします。ソースがないものは削除し、推定値にはラベルを付け、伝聞情報は誰の説明かを明記します。画面上のすべてのテキスト(冒頭の質問とエンディングを含む)は article.md と一致します。
  • アセットは使用可能: 画像、音楽、効果音、フォントはこれにライセンスされています(ファイルページで確認)。クレジットは credits.md に記録します。
  • 実在人物のAI描画顔は禁止。AIイラストを使用する場合は、プラットフォームの「AI生成コンテンツ」ラベルをオンにします。
  • 画像は時間のみに依存: 乱数をシードし、フレームが毎回同じようにレンダリングされるようにします(HyperFramesに必要)。
  • 納品前に、自分で全体を視聴します:テキストが時間内に表示され読みやすいか、年号や数字が記事と一致しているか、音と画像が同期しているかを確認します。

利用可能なツール

画像にはHyperFrames(npx hyperframes init / docs / check / snapshot / render)。そのスキルがインストールされている場合は、コンポジションに従います。scripts/ 内の小規模ツール。使用するかどうかは任意です。

スクリプト機能
beats.py音楽のテンポ、ビート、小節線、小節ごとのラウドネス変化を出力
music_loops.py, cut_music.py繰り返しやシームレスにカットできる小節を見つけ、小節リストから新しい音楽を構築
timing.pyコピーの各画面をビートグリッドに配置し、キー画面を特定の小節に固定
sfx.pyKenneyのCC0フォーリーをダウンロードし、効果音のキューを1つのトラックにミックス
qa.pyすべての画面のコンタクトシートと、キービート周辺のフレームを生成

以前のビデオが残したもの

参考であり、ルールではありません。まずこのトピックのためにデザインします。不明な場合や同じ問題に直面した場合に参照してください。

  • references/example-ai-history.md: 最初のテスト実行、各ステップの出力とタイミング
  • references/prompt-examples.md: テスト済みビデオから記入済みプロンプト2つ。詳細度を確認するため
  • references/notes.md: コピーとペーシングに関する観察
  • references/images.md: ライセンス確認、プロンプト作成、レイヤー生成
  • references/visuals.md: 密集コラージュ、タイムラインモーメント、フォトカード、生成画面へのUI適合、コードで描画するもの
  • references/sound.md: 音楽編集、効果音、ラウドネス
  • references/pitfalls.md: レンダリングに失敗したときや画像がおかしいときに最初に確認するポイント

関連スキル