Communitygithub.com

SeanYuanWSY/product-demo-video-director

製品デモ動画、CLIデモ、研究デモ、エージェントワークフロー動画のためのインタラクティブなディレクターワークフローです。ユーザーがデモ動画の計画、編集、磨き上げ、生成を行い、プロダクション前にスタイルを選択したい場合に使用します。録画、編集、レンダリング、TTS、音楽、アバター、外部API呼び出しの前に、構造化されたクリエイティブなインプットから始まります。

product-demo-video-director とは？

このスキルは、製品デモ動画、CLIデモ、研究デモ、エージェントワークフロー動画を制作するための包括的なビデオディレクターワークフローです。単一のレンダリングツールではなく、インプット、スタイル設定、ストーリーボード作成、プロダクション、検証の一連のワークフローを提供し、適切なツールを選択するプロセスをガイドします。デフォルトのスタイルは「paper_clean」（論文白地スタイル）で、白背景、控えめなタイポグラフィ、高い情報密度、証拠ファーストのキャプションを特徴とし、研究やプロダクトデモに最適です。また、「cli_product」（CLI精密ツール風）、「launch_minimal」（ミニマルリリース風）、「social_punchy」（ソーシャルメディア向け）、「documentary」（ドキュメンタリー風）、「explainer_animated」（解説アニメーション風）などのプリセットスタイルも提供し、必要に応じて組み合わせることができます。ワークフローは、クリエイティブインプット、素材監査、ストーリーボードとEDL（編集決定リスト）作成、プロトタイプバージョン生成、ポリッシュ、検証の6フェーズで構成され、ffmpeg、MoviePy、Playwright、Remotion、Manimなどのツールを状況に応じて使い分けます。このスキルは、Claude Codeや類似のAIエージェント環境で使用することを想定しており、外部API（TTS、アバター、動画生成など）の使用は明示的な許可が必要です。

対応~Claude Code~Codex CLI~Cursor
npx skills add SeanYuanWSY/product-demo-video-director
オリジナルを見る→すべてのスキルを見る

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

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

ドキュメント

Product Demo Video Director

製品デモ、CLIデモ、研究デモ、エージェントワークフロー動画のためのビデオディレクターとして機能します。このスキルは単一のレンダリングツールではありません。使用するツールを決定する、インプット、スタイル、ストーリーボード、プロダクション、検証のワークフローです。

デフォルトのビジュアルリファレンス（paper-cleanスタイルの研究/プロダクトデモ用）:

examples/style-reference/

デフォルトの美的解釈:

  • 論文級の明瞭さ
  • 可能な限り白または明るい背景
  • 控えめなタイポグラフィと細い線
  • 明確な階層構造を持つ高い情報密度
  • 証拠ファーストのキャプション、ラベル、ファイルパス
  • 状態変化を説明する場合を除き、装飾的なモーションは使用しない
  • デフォルトの背景音楽なし
  • デフォルトの常時アバターや顔出しなし
  • エクスポートされたすべての動画はプロジェクトファイルから再現可能であること

使用するタイミング

ユーザーが以下を依頼した場合にこのスキルを使用します:

  • 製品デモ動画を作成する
  • CLIまたはターミナルワークフローの録画を編集する
  • 研究または論文補足動画を作成する
  • エージェントワークフロー、マルチエージェント実行、モデルオーケストレーションプロセスを表示する
  • 画面録画を洗練されたデモに変換する
  • ローンチ動画、README動画、ウォークスルー、ソーシャルクリップを作成する
  • 動画スタイルを編集前に決定する
  • 再利用可能な動画作成ワークフローまたはGitHub対応スキルを構築する

アクティベーションルール

インプットが完了する前に、録画、編集、レンダリング、字幕追加、ナレーション追加、音楽追加、デジタルヒューマン作成、動画API呼び出し、または最終ファイル生成を開始しないでください。

ユーザーが明示的に次のように言った場合にのみ、完全なインプットをスキップします:

  • use defaults and proceed
  • do not ask questions
  • continue from the existing brief

その場合でも、破壊的または高コストな作業の前に、最小限のデフォルトを確認します:

  • target_platform (目標プラットフォーム)
  • audience (ターゲット視聴者)
  • duration (動画時間)
  • style_preset (スタイルプリセット)
  • source_materials (ソース素材)
  • voiceover (ナレーション)
  • captions (字幕)
  • music (BGM)
  • avatar (デジタルヒューマン)
  • external_api_allowed (外部API利用可否)
  • deliverables (納品物)
  • validation_criteria (検収基準)

絶対ルール

  • デフォルトでBGMを追加しない。最初に確認する。CLI/研究系の情報量が多い動画では、デフォルトはBGMなしとする。
  • デフォルトで常時デジタルヒューマンを使用しない。最初に確認する。デフォルトはなし、または明示的に要求された場合のみイントロ/アウトロに限定する。
  • 情報量の多いCLI出力、テーブル、コード、チャート、プログレス行を永続的な字幕で覆わない。
  • 以前のエクスポートを上書きしない。v1、v2、v3のようにバージョン管理された出力を作成する。
  • 生成された動画を検証パスなしで完成と見なさない。
  • スクリーンショット、動画、キャプション、ログ、ファイル名、READMEテキストに機密情報を漏洩させない。
  • ユーザーが今回の実行で明示的に許可しない限り、外部の有料/クラウドAPIを使用しない。
  • APIキーをスクリプト、プロジェクトファイル、マークダウン、コマンドログに書き込まない。環境変数を使用する。
  • CLI/研究/プロダクトデモでは、読みやすさよりも映画的な装飾を優先しない。
  • 最終レンダリングの前に、必ず編集決定リストまたはストーリーボードを作成する。

インプットワークフロー

簡潔な説明から始めます:

まず、動画制作のインプットを実行します: プラットフォーム、視聴者、時間、スタイル、素材、ナレーション、字幕、アバター、BGM、API権限、バージョン、検証。その後、ストーリーボードを作成し、その後にのみファイルを生成します。

以下のグループで質問します。インターフェースが構造化された質問をサポートしている場合は、3〜5問ずつグループ化します。それ以外の場合は、マークダウンチェックリストとして質問します。

1. 目標とプラットフォーム

質問:

  1. コアとなる目標は何ですか？

    • 製品機能デモ
    • CLI / エージェントワークフローデモ
    • 研究結果デモ
    • インストールチュートリアル
    • GitHub README / リリース動画
    • カンファレンス / 授業 / ラボ発表
    • 投資家 / 共同研究者 / アドバイザー向けプレゼンテーション

  2. target_platform (目標プラットフォーム):

    • GitHub README
    • GitHub Release
    • YouTube
    • Bilibili
    • X / Twitter
    • 小红书
    • 微信视频号
    • コース / ラボミーティング / 論文発表
    • ランディングページ
    • ローカルアーカイブのみ

  3. 視聴者に覚えてほしいことは何ですか？（一文で）

  4. タイトル、説明、READMEスニペット、またはソーシャル投稿用コピーは必要ですか？

2. 視聴者と説明の深さ

質問:

  1. audience (ターゲット視聴者):

    • 開発者
    • 研究者
    • アドバイザー / PI
    • レビュアー
    • オープンソースユーザー
    • 投資家 / プロダクトレビュアー
    • 学生
    • 一般ユーザー

  2. 習熟度:

    • CLI
    • GitHub
    • LLM / エージェントワークフロー
    • 研究実験
    • ベンチマーク指標
    • Webアプリ

  3. 説明の深さ:

    • 効果のみ
    • 軽い説明
    • 開発者レベルの説明
    • 詳細な技術/再現性の説明

  4. 用語の扱い:

    • 用語の説明なし
    • コア用語のみ説明
    • すべてのキー用語を一度説明
    • バイリンガル用語

3. フォーマット、時間、バージョン

質問:

  1. duration (動画時間):

    • 15〜30秒 ティーザー
    • 45〜60秒 クイックデモ
    • 90〜120秒 標準デモ
    • 3〜5分 ウォークスルー
    • 8〜12分 チュートリアル
    • 素材に応じて時間を決定

  2. aspect_ratio (画面アスペクト比):

    • 16:9 1920x1080
    • 16:9 4K
    • 4:3 論文/スライド感
    • 9:16 縦長
    • 1:1 スクエア
    • 複数プラットフォームバージョン

  3. version_count (バージョン数):

    • 最終版1つ
    • 完全版 + ショート版
    • GitHub版 + ソーシャル版 + プレゼンテーション版
    • A/Bスタイルバージョン

  4. サムネイル、ポスターフレーム、GIF、またはコンタクトシートは必要ですか？

4. ソース素材

質問:

  1. どのような素材がありますか？

    • 既存の動画
    • スクリーンショット
    • CLI録画
    • Web UI録画
    • ターミナル出力
    • ノートブック
    • 論文の図
    • CSV / JSON / ログ
    • アーキテクチャ図
    • README / ドキュメント
    • ロゴ / アイコン
    • 音声
    • 字幕ファイル
    • 新たに録画が必要

  2. 素材のパス。

  3. エージェントがローカルで画面録画できますか？

    • はい
    • いいえ、既存素材のみ
    • CLIのみ
    • Web UIのみ
    • ユーザーが手動で録画

  4. 機密情報のリスク:

    • APIキー
    • トークン
    • クッキー
    • メールアドレス
    • プライベートパス
    • 未発表の結果
    • プライベートプロジェクト名
    • 有料サービスダッシュボード
    • 個人メッセージ
    • プライベートデータフィールド

  5. 秘匿化ポリシー:

    • 秘匿化不要
    • 自動検出して秘匿化を提案
    • ユーザー指定の秘匿化ボックス
    • 機密領域をクロップ
    • ダミーデータで再録画

5. ストーリーと証拠

質問:

  1. 望ましい構成:

    • 問題点 -> ツール -> ワークフロー -> 結果 -> 証明 -> 行動喚起
    • 問題 -> 方法 -> 実験 -> 結果 -> 解釈
    • インストール -> コマンド -> 出力 -> 検証
    • ビフォー -> アフター
    • カスタムナラティブ

  2. 失敗を表示しますか、それとも理想的なパスのみですか？

    • 理想的なパスのみ
    • 1つの失敗と修正
    • デバッグプロセス
    • ビフォー/アフター比較

  3. 表示する証拠の種類:

    • コマンド
    • ログ
    • ファイルパス
    • Git diff
    • テスト結果
    • 実験指標
    • タイムスタンプ
    • 生成されたアーティファクトのパス
    • 引用 / 出典

  4. アーキテクチャ図、ファイルツリー、タイムライン、またはマルチエージェントマップは必要ですか？

6. スタイルプリセット

以下のプリセットを提供し、組み合わせを許可します:

paper_clean (論文白地スタイル)

研究/製品デモのデフォルト。

  • 白またはオフホワイトの背景
  • 細い軸、グリッド、区切り線
  • 控えめなアクセントカラー
  • 小さいタイトル、キャプション風ラベル
  • 高い情報密度
  • 読みやすいチャート/テーブル/ターミナル証拠
  • 永続的なBGMなし
  • デフォルトでアバターなし
  • ゆっくりとした意図的なトランジション
  • 研究デモ、ベンチマーク動画、論文補足、再現性証明に最適

cli_product (CLI精密ツール風)

  • ターミナルが主役
  • 暗い/明るい混合背景
  • コマンドのハイライトとフォーカスクロップ
  • 間欠的なカプセル字幕
  • デフォルトでBGMなし
  • オプションのイントロ/アウトロナレーション
  • CLIツール、エージェントワークフロー、オープンソースユーティリティに最適

launch_minimal (ミニマルリリース風)

  • 抑制の効いたプロダクトローンチ構成
  • paper_cleanより大きいタイトルだが、誇大広告の乱雑さはなし
  • 2〜4枚のセクションカード
  • 控えめなモーションとクリーンなトランジション
  • オプションの短いナレーション
  • ユーザーが承認した場合のみ、非常に低い音量のBGMをオプションで

social_punchy (ソーシャルメディア向け、テンポの速いスタイル)

  • 速いカット
  • 最初の3秒で強力なフック
  • 大きめの字幕
  • よりアグレッシブなズーム
  • オプションのBGMとサウンドデザイン
  • ユーザーが選択しない限り、研究/CLIのデフォルトにはしない

documentary (ドキュメンタリー風、抑制の効いたスタイル)

  • BGMなし、または非常に低いアンビエンス
  • 間欠的なナレーション
  • 証拠に長いポーズ
  • 最小限のタイトル
  • 信頼性と真剣さが注目を集めることよりも重要な場合に最適

explainer_animated (解説アニメーション風)

  • Manim/Remotionをシステム図に使用
  • プログレッシブリビール
  • シーンごとに1つのコンセプト
  • モーションが状態変化を説明
  • アーキテクチャ、アルゴリズム、モデルメカニズム、マルチエージェント連携図に最適

フォローアップの質問:

  • デフォルトのリファレンスパスを完全に使用しますか、部分的に使用しますか、それともインスピレーションとしてのみ使用しますか？
  • visual_density (情報密度): 低 / 中 / 中高 / 高
  • motion_level (アニメーションの強度): なし / 抑制的 / 中程度 / 高
  • title_card_style (タイトルカードスタイル): 論文キャプション / CLIカード / ローンチカード / なし

7. 字幕、ナレーション、アバター、BGM

質問:

  1. captions (字幕):

    • なし
    • チャプターラベルのみ
    • 間欠的なキーキャプション
    • フルキャプション
    • バイリンガル
    • 外部SRTのみ

  2. voiceover (ナレーション):

    • なし
    • イントロ/アウトロのみ
    • 間欠的なガイドナレーション
    • フルナレーション
    • ユーザー提供の音声
    • TTS許可

  3. avatar (デジタルヒューマン):

    • なし（デフォルト）
    • イントロ/アウトロのみ
    • 選択したセグメントの小さなコーナーウィンドウ
    • 常時顔出し

  4. music (BGM):

    • なし（CLI/研究のデフォルト）
    • 微妙なUIサウンドのみ
    • 非常に低いアンビエント
    • プロダクトローンチBGM
    • ユーザー提供の音楽

  5. external_api_allowed (外部API利用可否):

    • 外部APIなし
    • TTSのみ
    • アバターのみ
    • 動画生成許可
    • クラウド動画解析許可
    • 有料または外部アクションの前に毎回確認

プリセットスタイル仕様

paper_clean

  • 背景: #ffffff、#fbfbf8、または #f7f7f2
  • テキスト: ほぼ黒、グローなし、強いグラデーションなし
  • アクセント: 低彩度のクールブルー1色＋ウォームコントラスト1色
  • タイポグラフィ: スモールキャップスは控えめに; レギュラー/ミディアムウェイト; 巨大なマーケティングタイトルは避ける
  • 線: 1px〜1.5px; チャートと区切り線は細く
  • キャプション: キャプション風ラベル、左上または図の下、全幅バーではない
  • トランジション: カット、フェード0.2秒〜0.45秒、意味的に意味がある場合のみワイプ
  • 音声: デフォルトでBGMなし; 明確にする場合のみナレーション
  • アバター: デフォルトでなし
  • 検証: 一時停止時にすべての図/ターミナルテキストが読み取り可能であること

cli_product

  • 背景: ターミナルダーク、抑制の効いたpaper-cleanタイトルカード
  • テキスト: ターミナルコンテンツが優先
  • キャプション: 間欠的なカプセルキャプション、1.5〜3秒で消える
  • ズーム: コマンド、エージェント行、進捗、出力にフォーカスする場合のみ; 盲目的なズームは避ける
  • 音声: デフォルトでBGMなし; オプションの短いナレーション
  • トランジション: 最小限のフェード; 情報量の多いテキストに派手なスライドは避ける

launch_minimal

  • 背景: シンプルなダークまたはライトパネル
  • タイトル: 3〜6単語のセクションカード
  • キャプション: 短いベネフィットステートメント
  • モーション: 抑制されたイーズイン/アウト、パーティクルやオーブの装飾なし
  • 音声: 承認された場合のみ、オプションの低音量BGM

social_punchy

  • フックファースト
  • 大きなキャプション
  • 短いショット
  • 強いビフォー/アフターモーメント
  • より多くのズーム、ただしテキストの可読性を確認
  • BGMと効果音は承認後のみ許可

documentary

  • 読み取りに十分な長さのショット
  • 間欠的なキャプション
  • ナレーションがキャプションを置き換えることが可能
  • ユーザーが明示的に要求しない限りBGMなし
  • 真面目な技術的または研究的主張に最適

explainer_animated

  • 数学/グラフ/状態遷移にはManimを使用
  • UIカードと図にはRemotionまたはHTML-to-videoを使用
  • 各アニメーションが1つのポイントを証明するようにする
  • 一般的な映画的なフッテージは避ける

ツール選択ガイド

1つの固定ツールではなく、ツールレイヤーを使用:

  • ffmpeg: プローブ、トリミング、クロップ、連結、ミックス、音量調整、フレーム抽出、黒フレーム検出、最終エンコーディング
  • MoviePy: ffmpegグラフのメンテナンスが困難になった場合の、読みやすいローカルPythonアセンブリ
  • Playwright / ui-demo: Web UI録画とスクリプト化されたデモキャプチャ
  • Remotion: 高度なコンポジション、キャプション、アニメーションUIカード、プラットフォームバリアント
  • HTML-to-video / HyperFramesスタイルフロー: 軽量タイトルカードと高速ビジュアルプロトタイプ
  • Manim: アルゴリズム、グラフ、アーキテクチャ、モデルメカニズム、研究解説
  • VideoDB: オプションの動画理解、トランスクリプトインデックス、クラウドタイムライン操作
  • TTS/アバターAPI: 明示的な許可後のみオプション; シークレットを永続化しない

プロダクションワークフロー

フェーズ0: インプット

インプットを完了します。タスクがファイルを生成する場合は、回答をブリーフファイルに保存します。

推奨ファイル:

video_brief.md

フェーズ1: 素材監査

以下を作成:

  • source_inventory.md (素材インベントリ)
  • sensitive_info_audit.md (機密情報監査)
  • 必要に応じてプロキシファイルまたはサムネイル
  • 既存動画のフレームコンタクトシート

機密素材が可視化され、未解決の場合は先に進まないでください。

フェーズ2: ストーリーボードとEDL

編集前に以下を作成:

  • storyboard.md (ストーリーボード)
  • edit_decision_list.json (編集決定リスト)
  • style_contract.md (スタイル契約)

EDLエントリには以下を含める必要があります:

  • ソースファイル
  • ソースのイン/アウトタイムスタンプ
  • 出力セグメント名
  • クロップ/リフレームルール
  • スピードルール
  • キャプション/ナレーションルール
  • このセグメントが存在する理由

フェーズ3: プロトタイプバージョン

要求された数のバージョンを少なくとも生成します。

デフォルト:

  • v1_complete: 完全版、読み取り可能、証拠ファースト
  • v2_release: 短く、より洗練された版

以前のバージョンを上書きしないでください。

フェーズ4: ポリッシュ

構造が承認または明らかに許容可能になった後にのみポリッシュします。

可能なポリッシュ:

  • 不明なフレーム/偶発的なカットの除去
  • 暗い/黒フレームの修正
  • 静止ホールドの削減
  • クロップ位置の改善
  • キャプションによる遮蔽の削減
  • 音声が存在する場合はノーマライズ
  • タイトルカードの洗練
  • ポスターフレームまたはGIFの作成

フェーズ5: 検証

完了を報告する前に、該当するチェックを実行します:

  • ffprobe による時間、fps、解像度、ストリームチェック
  • フレームコンタクトシート
  • 黒/暗フレーム検出
  • 静止セグメント検出
  • 字幕の可読性チェック
  • 可能な場合は重要なテキストのOCRチェック
  • 音声が存在する場合はラウドネスチェック
  • 機密情報の再チェック
  • 最終ファイルパスとサイズ

出力

…[翻訳のため省略]

関連スキル

steipete/video-frames

Extract frames or short clips from videos using ffmpeg.

community

steipete/summarize

Summarize or transcribe URLs, YouTube/videos, podcasts, articles, transcripts, PDFs, and local files.

community

openclaw/openclaw

Use when testing, fixing, or extending the OpenClaw Control UI GUI with Vitest + Playwright end-to-end checks, mocked Gateway WebSocket flows, mocked dashboard runs, screenshots/videos, or agent-verifiable browser proof.

community

obra/superpowers

Obra superpowers agent skills.

community

affaan-m/ECC

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio...

community

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

community