Communitygithub.com

training-video

エージェントが「研修ビデオ」の企画、制作、編集を行い、具体的なコピーやスクリプトを成果物として出力する方法を示します。手順は「研修ビデオ」「4つの承認 – これなしでは時間とお金を無駄にする」「実行」の流れで進みます。新しいタスクでこのスキルが必要なときに使用してください。

training-video とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が研修ビデオを一貫した手順で制作するための包括的なガイドです。音声が主導し、映像がそれに従うという原則に基づき、まずスクリプトと音声を準備し、その後スライドや録画を同期させます。ユーザーは技術に詳しくないことが多いため、エージェントは専門用語やコマンドを避け、シンプルな言葉でユーザーとコミュニケーションをとります。主な特徴は「4つの承認」プロセス(スクリプト、コスト、音声サンプル、ビジュアル)で、リソースを無駄にしないためのゲートとして機能します。対応プラットフォームはmacOSとWindows(Bash/PowerShell)で、Gemini APIキーを使用した音声合成、Playwrightを使ったスライドレンダリング、アプリケーション画面の録画をサポートします。スキルはプロジェクトフォルダ内に`.training-video/`という設定ファイルと、専用スクリプト(`scripts/`ディレクトリ)を使って動作します。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/erida-ai/training-video/tree/HEAD/skills/training-video

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

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

ドキュメント

研修ビデオ

音声が主導し、映像はそれに従います。最初にスクリプトと音声、次にスライドまたは録画を、各セリフの長さに合わせて同期します。

誰と話しているか。 相手は技術に詳しくない可能性があります。相手は日本語(またはあなたに指示を出している言語)で、簡単な言葉を使い、コマンドやファイルパスは避けます(尋ねられた場合を除く)。技術的な手順はあなたが実行します。相手の決定が必要なことだけを尋ねてください。内容、対象者、言語、ビジュアル、承認などです。

スクリプトは ${CLAUDE_SKILL_DIR}/scripts/ にあり、python3 -B ${CLAUDE_SKILL_DIR}/scripts/<スクリプト名>.py … で実行します。Windows では python3 の代わりに doctor.py が「Python コマンド」行で示すコマンド(python または py -3)を使用します。スライドとレンダリングは node ${CLAUDE_SKILL_DIR}/deck/render.cjs …、アプリケーションの録画は ${CLAUDE_SKILL_DIR}/screencast/ を使用します。テーマは ${CLAUDE_PLUGIN_ROOT}/themes/ にあります。macOS と Windows(Bash および PowerShell)で動作します。コマンドはパイプ、&&、リダイレクトなしのシンプルなものを使用します。

プロジェクトとは、作業中のフォルダ(製品のリポジトリまたはドキュメントフォルダ)です。各プロジェクトには独自の Gemini キーがあり、ユーザーのコンピュータにのみ保存されます(キーチェーン / 資格情報マネージャー)。プロジェクトのマーカーは .training-video/project.json(ID と名前、秘密情報は含みません)です。

4つの承認 — これなしでは時間とお金を無駄にしない

  1. スクリプト(セリフのテキストとスライド/画面の計画)。
  2. コスト — cost.py による表。短いサンプル(最大3~4セリフ)は承認不要、フルナレーションは必要。
  3. 音声サンプル — 最初の3セリフ(narrate.py --sample 3)。ユーザーが聴きます。
  4. ビジュアル — レンダリング全体の前に、完成したスライドまたは録画の1~2フレーム。

実行

  1. 環境とキー — 毎回の実行時に、他のすべての前に。
    • doctor.py <プロジェクト>。不足しているものがあれば、ユーザーの許可を得て、doctor.py がそのシステム用に指定するコマンド(brew / winget)で修正します。レンダリングの場合は ${CLAUDE_PLUGIN_ROOT} で npm ci(Claude Code が実行していない場合)、そして npx playwright install chromium を実行します。
    • プロジェクトキー: key.py check <プロジェクト>。
      • OK → 続行します。
      • プロジェクトなし → フォルダに小さなファイル .training-video/project.json(プロジェクトの名前と番号、秘密情報なし、git に保存可)が作成されることをユーザーに伝え、プロジェクト名を尋ねます(フォルダ名を提案します)。その後ウィザードを実行します。
      • キーなし → 古い共通キーがあると表示された場合、「これまでの Gemini キーをこのプロジェクトにも使用しますか?」と尋ねます(はい → key.py setup <プロジェクト> --use-legacy)。それ以外の場合はウィザードを実行します。
      • 拒否されました → --replace 付きでウィザードを実行します。
    • ウィザード: まず次の手順を簡単な言葉で説明します。「Google AI Studio のページが開きます。このプロジェクトの音声料金を支払うアカウントで API キーを作成し、コピーしてください。その後、キーを貼り付けるためのウィンドウが表示されます。キーはこのコンピュータにのみ保存されます。」key.py setup <プロジェクト> [--name "<名前>"] を実行します。ウィザードはページとウィンドウを開き、Gemini でキーを確認して保存します。チャットでキーを要求したり、どこにも書き込んだりしないでください。 ユーザーがキーをチャットに貼り付けた場合は、Google AI Studio で削除して新しいキーを作成するように指示してください。
    • 技術に詳しいユーザーは Vertex を使用できます(gcloud auth application-default login と GOOGLE_CLOUD_PROJECT)。環境変数の GEMINI_API_KEY はすべてのプロジェクトに適用されます — CI 専用です。
  2. 受け入れ — 自分で状況を把握し、明確でないことだけを尋ねてください。
    • 何があるか: チャットまたはディスク上のファイル/フォルダ、Google Drive のリンク(接続された Google Drive コネクタがある場合)、ウェブリンク、製品の git リポジトリ(.training-video/profile.md が含まれている場合、製品はビデオ用に準備されています)。
    • PDF があり、doctor.py が「poppler (PDF): なし」と表示する場合 → 次のように1つの質問で尋ねます。「PDF からテキストと画像を抽出するには、小さなプログラム(poppler、約35 MB)が必要です。インストールしますか?」「はい」の場合 — doctor.py のコマンド(brew / winget)を実行します。「いいえ」の場合 — PDF を直接読み取り、画像は取得しません。
    • モード: 素材ベース → reference/materials.md。コードベース(アプリケーションの録画) → reference/code.md。両方ある場合は、どちらのビデオかを尋ねます。
    • コードベース — どのロール用か。 ビデオはアプリケーションの1つのロール(オペレーター、マネージャー、管理者など)向けです。録画はそのロールで行われ、そのロールの画面のみを表示します。ロールは製品プロファイルまたはコードから取得します(reference/code.md の「ロール — コードから」)。アプリケーションが表示するラベルを選択肢として用意し、ユーザーに尋ねます。survey.cjs によるロールとしてのプレビューが完了するまで、スクリプトを作成しないでください。
    • 複数の質問をまとめて(選択肢付きで)尋ねます: ビデオの対象者と、視聴後に何ができるようになるべきか。音声の言語(デフォルトは日本語)。字幕の言語。長さ(デフォルトは3~8分)。テーマ(themes/、デフォルトは「ニュートラル」。素材に独自のブランドがある場合は、そのテーマを提案します)。完成品の保存先(Drive またはコンピュータ上のフォルダ)。
  3. ビデオフォルダ — プラグインと製品リポジトリの外。デフォルトはユーザーの「ドキュメント」フォルダ内: <ドキュメント>/研修ビデオ/<短い名前>-<日付>/(Mac では ~/Documents、Windows では `%USERPROFILE% enants est est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08

関連スキル