Communitygithub.com

aleksanderstevens191-sudo/course-video-skill

学生自身の講義資料(講義録、スライド、ノート、問題集)をもとに、ナレーション付きのアニメーション学習動画を作成します。グラフ、例題、クイズ、キャプション、効果音、オプションでBlender 3Dシーンも含められます。動画内のすべての数字は講義資料に基づいており、チェッカーがその正当性を検証します。学生が「勉強用動画」や「復習動画」を作ってほしいと依頼したときに使用します。

course-video-skill とは?

このスキルは、学生が提供したコース資料(講義録、スライド、ノート、問題集など)のみを使って、ナレーション付きアニメーション学習動画を自動生成するエージェントスキルです。最大の特徴は、「動画内のすべての数字、例、主張は、学生のコース資料にのみ基づき、決して創作しない」というルールです。そのため、学生が実際にその教授の試験で出題される内容を正確に復習できる動画ができます。 このスキルは、主にClaude CodeやCodexのようなターミナルベースのAIエージェントで動作します。ワークフローは、1) ソース資料の収集、2) JSON形式でのスクリプト作成、3) 数字の出自チェック、4) 動画のビルド・レンダリング、という順序で進みます。スキルはtools/check_sources.pyという専用ツールを使って、動画内のすべての数字がソース資料に存在する数字か、そこから計算可能かを検証します。 対応プラットフォームは、Python 3、ffmpeg、Playwrightを前提とし、必要に応じてBlender 4.2以上を利用した3Dシーンや、XAI APIを使ったGrok音声(代替として無料のMicrosoft Neural Voice)も利用可能です。出力は1080pのMP4動画とSRT字幕ファイルで、オプションでチャプター付きのWebページも生成できます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/aleksanderstevens191-sudo/course-video-skill/tree/HEAD

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

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

ドキュメント

コース動画

あなたは学生のコース資料を学習動画に変換します。このスキルを他と差別化する唯一のルールは次の通りです。

すべての数字、例、主張は学生のコース資料に由来するものでなければなりません。何も創作してはいけません。 学生はこれらの動画を、自分の教授が採点する試験勉強に使用します。たとえ正しい経済学・物理学などの知識であっても、架空の数字を使った「わかりやすい」例や、異なる表記の公式、コース外の事実はバグです。

0. 必要条件(1回確認)

python3 -m pip install -r requirements.txt && python3 -m playwright install chromium
ffmpeg -version | head -1          # brew install ffmpeg  /  apt install ffmpeg

オプション:3Dシーンとマスコットプレゼンター用のBlender 4.2以上(PATHにない場合はBLENDER=/path/to/blender)、 PDFスライド読み取り用のpdftotext(poppler)またはpip install pypdf、録音の文字起こし用のopenai-whisper、 Grok音声用のXAI_API_KEY(指定しない場合は無料のMicrosoft Neural Voiceが使用されます)。

1. ソースの収集

<course>/sources/フォルダを作成し、コース資料のみを入れます: 講義録(.txt/.srt/.vtt)、スライド(.pdfまたはエクスポートされたテキスト)、学生のノート、問題集、模擬試験。

  • 録音はあるが文字起こしがない場合 → whisper lecture.mp4 --model base --output_format txt --output_dir sources/
  • .docx → textutil -convert txt file.docx(macOS)または pandoc file.docx -t plain -o file.txt
  • どの講義・トピックを動画で扱うか学生に確認してください。依頼がない限り、他の週の資料で水増ししないでください。

書き始める前にソースを完全に読んでください。教授の正確な表記、用語、例題、数値をメモしてください。

2. スクリプトの作成(コンテンツJSON)

engine/SCHEMA.md(ビジュアルタイプ、キューワード、クイズ形式、レイアウト制限)に従って、<course>/<name>.jsonを作成します。 examples/lemonade/は完全な小規模サンプルです。

ルール:

  • 例題:講義で使われている例題を、講義と同じ数字で使用します。講義で「価格4ドル、3単位」と扱っている場合、動画でも「価格4ドル、3単位」であって「価格10ドル、5単位」ではありません。
  • クイズ:コースの練習問題、クリッカー問題、または例題から出題します。新しい問題を作成する場合は、ソース内の数字のみを使用し、クイズのラベルにその旨を明記します(「模擬試験」ではなく「練習問題」など)。
  • 派生数字(計算した合計、差など)は問題ありませんが、それぞれをトップレベルの`

関連スキル