Communitygithub.com

デモ動画作成

端末・ブラウザの操作を録画し、ナレーション・字幕付きMP4やハイライトGIFに編集します。画面配置、高解像度キャプチャ、シーン検出、Edge-TTS音声合成、YouTube字幕、GIFサイズ制限などに対応。

デモ動画作成 とは?

このスキルは、ターミナルやブラウザ、アプリケーション上での実際の作業を、以下の形式に変換するためのものです。 - **YouTube動画**: TTS(テキスト読み上げ)ボイスオーバー付きMP4、字幕ファイル(.en.srt)を含む。 - **ハイライトGIF**: 主要な手順のみを抜き出した、READMEに適したサイズのGIF(無音、字幕なし)。 - **字幕焼き込み版MP4**: 字幕表示機能がない環境向け。 スクリプトは`scripts/`ディレクトリにあり、テンプレートとして利用します。実際の動画用にフォルダ(リポジトリ外、録画データは数百MB単位)にコピーして設定を編集します。 動作には、`ffmpeg`(PATH通し、または`FFMPEG`/`FFPROBE`環境変数)、Python 3、音声合成用の`pip install edge-tts`が必要です。 プロセスは、ユーザーとの綿密な計画から始まります。画面の配置、WindowsでのDPIや不可視ボーダーへの対応、Desktop Duplicationを用いた高解像度キャプチャ、コンタクトシートを使った瞬間の特定、Edge-TTSによるナレーション、そしてシーン分割と速度調整による動画・GIFのビルドまでをカバーします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shannonbay/claude-demo-video-skill/tree/HEAD

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

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

ドキュメント

デモ動画:録画、カット、ナレーション、字幕、GIF

画面上の実際のワークフロー(端末、ブラウザ、アプリ)を次の形式に変換します:

  • YouTube用動画:TTSボイスオーバー、字幕焼き込みなしのMP4、および .en.srt ファイル。
  • ハイライトGIF:主要な手順のみ、無音、字幕なし、READMEに適したサイズ。
  • オプションで字幕焼き込みMP4(字幕非対応環境向け)。

scripts/ 内のスクリプトはテンプレートです。動画用のフォルダ(リポジトリ外:録画ファイルは数百MBになります)にコピーし、設定ブロックを編集して使用します。ffmpeg(PATH を通すか、FFMPEG/FFPROBE 環境変数)、Python 3、音声合成に pip install edge-tts が必要です。

1. ユーザーと計画を立てる

  • ストーリーをステップに分割し、ユーザーが操作するステップ(クリック、タイピング)と待機ステップを明確にします。押すべきキーを含むステップリストを作成し、ユーザーが録画中に操作できるようにします。
  • 見た目に変化があるテーマ(Issue、ToDoなど)を選びます。
  • 環境を整えます:デモで作成するものの重複を削除し、個人用タブを閉じ(新しいブラウザウィンドウを開き、該当サイトのみ表示)、通知を非表示にします。ノイズになるもの(更新バナーなど)に注意します。
  • 録画中にClaudeに入力する内容は画面に表示されることを伝え、「次へ」/「完了」程度に留めるよう指示します。

2. 両方のウィンドウを1つのキャプチャ枠に収める

デモで使用するすべてのウィンドウをまったく同じ矩形(1920×1080推奨)に配置し、その枠を録画します。前面にあるウィンドウがそのまま映像になるため、ウィンドウ切り替えが編集になります。

Windowsでは scripts/rec.ps1 place -X <px> -Y <px> で配置できます。注意点:

  • DPIスケーリング:DPI非対応プロセスからの座標はスケーリングされます(125% → 「1920」ウィンドウは物理的に1536)。place はモニターごとのDPI対応を設定(SetThreadDpiAwarenessContext(-4))するため、物理ピクセルで動作します。モニター一覧は rec.ps1 monitors で表示。
  • 不可視ボーダー:Windows 10/11のウィンドウには約7ピクセルの不可視ボーダーがあります。GetWindowRect ではなくDWMの可視境界(DWMWA_EXTENDED_FRAME_BOUNDS)でサイズを取得します。place はこれを測定・補正します。
  • 録画前に1フレームをキャプチャして確認する(PNGを読んでください)。

3. 録画

scripts/rec.ps1 start <名前> / stop / mark <テキスト> を使用。注意点:

  • gdigrabはDPI非対応で、スケーリングされたモニターでは縮小されたデスクトップをキャプチャします(__COMPAT_LAYER=HighDpiAware でも修正不可)。Desktop Duplication(ddagrab)を使用します。こちらはモニターごとにネイティブピクセルでキャプチャし、offset_x/y はそのモニター基準です。
  • 2つ目のGPU(ノートPC+外部ディスプレイなど)上のモニターはアダプター0ではありません:-init_hw_device d3d11va=dx:<アダプター> -filter_hw_device dx に ddagrab=output_idx=<n> を -filter_complex で指定します。rec.ps1 start は -Adapter と -Output パラメーターを受け取ります。「Failed to enumerate DXGI output」の場合は0/1を試してください。
  • MPEG-TS(-f mpegts)で出力:録画停止時にプロセスを強制終了するため、MP4やMKVではヘッダーが壊れます。
  • 自然な区切り(セットアップ/ユーザーの入力/待機の長回し)でクリップを分割します。遅い処理の長回しは問題ありません。編集で待機時間を短縮します。
  • ユーザーが操作中は、各バックグラウンドステップの報告と次に押すべきキーを簡潔に伝えます。

4. 瞬間を見つける

動画をスクラブ(早送り/巻き戻し)しないでください。タイムスタンプ付きのコンタクトシートを作成して読みます: python scripts/sheets.py <clip.ts> --every 10(クリップ全体)、その後 --from 170 --to 236 --every 2 --crop 900:560:1020:0 で各クリック周辺を指定し、提案が表示される秒数、ボタンが押される秒数、ページが読み込まれる秒数を正確に特定します。 各ステップの(クリップ、開始、終了)と、待機区間を書き留めます。

5. ナレーション

lines.txt:シーン(ストーリーの1ステップ)ごとに1行、キャプションテキストとして記述します。話し言葉の英語、短い文、「何を」ではなく「なぜ」を述べます。voice.py には記号の読み上げマップ(SAY)があります(#92 → 「ninety-two」、/goal-new → 「goal new」、CI → 「C I」)。キャプションは原文を保持します。デフォルト音声は en-US-AndrewNeural、速度+4%です。音声一覧は python -m edge_tts --list-voices で表示。特定の行だけ音声を変更するには --only N を使用します。

6. ビルド

scripts/build.py:SCENES はシーンのリストで、各シーンは (クリップ, 開始, 終了, 速度) のセグメントリストです:

  • ユーザーのクリック:1–2倍速。ブラウザページ:2–4倍速。マシン作業:6–40倍速で、▶▶ N× バッジ表示(速度3以上で描画)。
  • LEAD + その行の長さ + TAIL より短いシーンは、最後のフレームを保持(tpad)し、音声が途切れないようにします。
  • 出力:youtube/<名前>-youtube.mp4(映像+音声、-c copy)、youtube/<名前>-youtube.en.srt(各行を約70文字のキューの文字数比率で分割)、サムネイル。
  • --burn オプションで <名前>-captioned.mp4(字幕焼き込み版)も出力。

動画の長さは1.5〜3.5分を目指します。ナレーションに長い無音が生じる場合は、言葉を足すよりシーンを早めます。

7. GIF

GIFは動画をそのまま圧縮したものではありません。主要な手順のみです。scripts/gif.py:HIGHLIGHTS = (クリップ, 開始, 終了, 速度, クロップ)、各3〜7秒、クロップ(フレームの1280×720領域:ペイン、Webページ、メニューなど)、960×540にリサイズ、8fps、パレット最適化(palettegen stats_mode=diff、paletteuse dither=none diff_mode=rectangle)。字幕・バッジなし。サイズは10MB以下(GitHubの画像制限)、長さは約60秒以下に抑えます。各ハイライトの最終フレームをタイル表示して確認します。

8. 引き継ぎ

動画フォルダに README.md を作成:動画の内容、出力ファイル一覧、各ソース/スクリプトの説明、録画環境の設定(フレームやキャプチャの注意点)、再ビルド手順(再音声合成 → ビルド → GIF)。フォルダの場所を記憶しておくことを提案します。

関連スキル