mcpField
V
video-content-engine

video-content-engine

github.com/ericosiuクリエイティブ・メディア3.7k50 回インストール5 週間前に更新
リポジトリ

video-content-engine について

素材を評価し、動画や関連コンテンツの構成を計画・制作するスキルです。利用許可のある素材をコンテンツにするチーム向けに、編集、権利確認、品質チェック、公開承認の手順を定めています。

主な機能

  1. 01素材・主張・権利の棚卸し
  2. 02編集モードとアセット形式の選定
  3. 03カット・字幕・パッケージの計画
  4. 04納品ファイルとマニフェストの検証
  5. 05レビューと公開状況の管理

活用シーン

  1. 01制作前の動画素材の監査
  2. 02録画から独立したクリップを作成
  3. 03レビュー用アセットと納品ファイルの準備
  4. 04公開操作を管理しながらリリースを計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ericosiu/ai-marketing-skills --skill video-content-engine

インストール後、Claude Code で/video-content-engineを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
requirements.txt
agents/
openai.yaml
references/
delivery-contract.md
editing-workflow.md
editorial-review.md
format-modes.md
opportunity-routing.md
quality-gates.md
scripts/
audit_edit_boundaries.py
validate_delivery.py
tests/
test_scripts.py

詳細

動画コンテンツエンジン

1つの根拠あるソースを、正当化できる最も強力なポートフォリオに変えます。派生コンテンツの数をあらかじめ固定しないでください。独自の価値提案を見つけ、それを実現できる形式を選び、各アセットにポートフォリオ内での役割を与えます。

前文

利用可能な場合は、リポジトリのプライバシーを保護するバージョンチェックとテレメトリー初期化処理を実行します。

python3 telemetry/version_check.py 2>/dev/null || true
python3 telemetry/telemetry_init.py 2>/dev/null || true

リモートテレメトリーはオプトインです。コンテンツ、URL、パス、認証情報、名前、業務データは決して記録しないでください。

作業上の取り決めを明示する

作業を始める前に、正確なソース、所有者、チャンネル、保存先、依頼されたモジュール、納品形式、このターンで作成する成果物、停止条件、既知のブロッカーの種類を明示します。

ソースは読み取り専用のまま保持します。新たな証拠がない限り、レンダリング、アップロード、プレビュー、公開、QC 合格を主張しないでください。パフォーマンス目標は予測ではなく、実験として扱います。

根拠のあるあらゆるソースを受け付ける

公開または利用許可を得た URL、アップロードされたファイル、ローカルファイル、文字起こし、音声録音、ソースフォルダーを受け付けます。run this skill on this video のような簡単な依頼は、自動制作ではなく、診断と提案を既定の対応とします。

リンクの場合:

  1. 正確なページ、所有者、チャンネル、タイトル、長さ、アクセス可能なメディアまたは文字起こしを特定します。
  2. オリジナルファイル、許可されたダウンロード可能なマスター、公開済みストリームの順に優先します。
  3. ミラー、別のアップロード、アカウント、エピソード、文字起こしで代用しないでください。
  4. 認証、権限、DRM、メディアの欠落、または文字起こしが利用できないために根拠に基づく分析ができない場合は、アクセス可能なソースを依頼します。メタデータだけをもとに編集上の提案をしてはいけません。

制作を依頼されていない場合は、ソースの評価スコア、推奨する編集モードと運用モード、機会の件数、最初のリリース波、修正事項と依存関係、制作の複雑さ、ポートフォリオ内での役割、着手に必要な承認を含む概要を返します。

ソースをインベントリ化する

  1. 利用可能な場合は、パスまたは URL、サイズ、長さ、ストリーム、SHA-256 を記録します。
  2. 話者を識別したタイムスタンプ付きの文字起こしを作成します。名前、製品、数値はソースと照合して修正します。
  3. 以下を作成します。
    • 実績、推定、逸話、予測、目標を区別する主張台帳。
    • 第三者のメディア、ロゴ、同意、情報解禁条件、スポンサーを記録する権利台帳。
    • タイムスタンプ、視聴者、価値提案、根拠、緊張感、フレームワーク、成果、ビジュアル、注意事項、依存関係を含むコンテンツ要素のインベントリ。
  4. references/opportunity-routing.md を読み、実現可能な要素を評価して、選んだ機会と却下した機会を記録します。

機会のインベントリを唯一の情報源とします。ソースが支えられるアセット数を提案し、ノルマを既定にしないでください。

編集前に、トラック全体の網羅、根拠を示す冒頭、アセット全体のレビューについて、references/editorial-review.md を読んでください。カメラ、画面共有、プレゼンテーション、再生音声の各トラックを個別にインベントリ化します。カメラ映像の合成版には、話者が論じている根拠が含まれていない場合があります。

変換方法を選ぶ

references/quality-gates.md を読みます。フック、明瞭さ、根拠、テンポ、成果をそれぞれ 0~20 点で評価します。

最も破壊性の低い編集モードを選びます。

  1. 整える — 誤り、無音部分、技術的な妨げを取り除きます。
  2. 引き締める — 構成を保ちながら、繰り返しや脱線を取り除きます。
  3. 再構成する — 冒頭を作り直し、根拠の提示位置を移動し、セクションを並べ替え、欠落をつなぎます。
  4. 再構築する — 差し込み収録、ナレーション、実演、グラフィックを追加して、実質的に新しい製品を作ります。

「引き締める」「再構成する」「再構築する」の場合、最終カットの前に、ソースに忠実な単語または文単位のタイムスタンプ付き文字起こしを作成します。メモのタイムスタンプはセクションの目安であり、文字どおりのカット位置ではありません。

references/format-modes.md を読みます。主となるモードを1つと、根拠のある補助モジュールを選びます。モードが指定されていない場合は、ポートフォリオ監査を既定とし、役に立つ最小限のリリース波を提案します。

ポートフォリオの軸を固定する

次のように記述します。

[Viewer] should believe [verdict] because [proof], then use [framework] to reach [outcome].

選定した各アセットに、1つずつ約束、視聴者、プラットフォーム、役割、得られる価値、親アセット、誘導先、パッケージングの意図を設定します。約束の重複、不完全な抜粋、裏付けのない主張、単独で成立しないアセットは却下します。

選定したモジュールを制作する

長尺

レンダリングの前に、カット/並べ替えマップとEDLを作成します。正確なトランスクリプトに照らしてクリップを確認し、完全な内容の始まりと終わりにします。次を実行します。

python3 scripts/audit_edit_boundaries.py \
  --transcript <exact-source-transcript.json> \
  --clips <retained-clips.json> \
  --output <boundary-audit.json>

レンダリング後、マスターを文字起こしし、すべてのつなぎ目を確認します。左側の末尾、右側の冒頭、トランジション、結論、修正内容を記録します。技術的なデコードは、意味のレビューの代わりにはなりません。以前のレンダリングは、バージョン管理されたファイルとして保持します。

中尺

1つのフレームワーク、ケーススタディ、問い、議論、またはデモンストレーションを軸に、自立した3~12分の動画を作成します。それぞれに独自のフック、背景、根拠、得られる価値、パッケージ、誘導先を用意します。

短尺・マイクロ

完全なまとまりからのみ、15~90秒の縦型アセットを作成します。フックから始め、主張の文脈を保ち、1080×1920でレンダリングし、映像に焼き込んだ字幕とSRTを含め、得られる価値か有用な問いで締めくくります。

6~20秒のティーザー、フックのテスト、ストーリー用素材、有料配信用の短縮版、引用のモーション化は、事実に忠実な誘導ができる場合にのみ作成します。宣伝用クリップには別のラベルを付けます。

字幕とオープニングの演出

ユーザーが不要と指定しない限り、マスターには読みやすく映像に焼き込んだ字幕と、それに一致するSRTを標準で付けます。キューが単調増加で重複せず、最大2行で、モバイルのセーフマージン内に収まり、キューの終了がマスターの終了以前であることを検証します。

オープニングのオーバーレイ時間には、承認済みのブランドブリーフを使用します。ブリーフがない場合は、4秒を開始時の目安とするか、素材に合う場合はオープニングをすっきりさせます。オーバーレイで弱い話し言葉のフックを補うことはできません。主張を強めずに、話し言葉の約束を補強します。字幕、ローワーサード、チャプターカード、限定条件との重なりを確認します。主張に関する限定条件を優先します。

カルーセルと文章への派生

形式によって理解や配信が改善する場合は、スワイプ形式のストーリー、ニュースレター、記事、投稿、スレッド、番組ノート、チェックリスト、または要約を作成します。提供されたブランド素材を必須とし、なければニュートラルなシステムを使用します。記憶を頼りに人物、マスコット、ロゴ、またはアイデンティティを再現してはなりません。

すべてのアセットをパッケージ化する

  • **長尺:**タイトル、サムネイルの概要、コールドオープン、最初の30秒で伝える約束、説明文、チャプター、固定コメント、終了画面。
  • **中尺:**ブラウズ/検索向けタイトル、カバー、冒頭の一文、シリーズラベル、説明文、親アセットへの誘導先。
  • **短尺/マイクロ:**最初のフレームのビジュアル、話し言葉のフック、見出し、カバー、投稿文、コメントを促す問い、CTA。
  • **カルーセル:**表紙で示す約束、スワイプの展開、キャプション、CTA、最終スライド、出典、代替テキスト。

見た目だけを変えるのではなく、約束の仮説を作成します。約束が果たされないパッケージは却下します。

配信を計画し、副作用を管理する

根拠のあるBロール、スクリーンショット、引用、図、ローワーサード、限定条件、チャプターカード、オーバーレイ、字幕、パンチイン、音楽、サウンドデザイン、追加収録、ナレーション、スポンサーの配置、終了画面の誘導をリストアップします。要素が重なる場合に、どのビジュアルレイヤーを優先するかを定義します。

依頼された場合は、公開順、間隔、プラットフォーム、誘導先、時事性の有無(エバーグリーンかどうか)、共食いへの警告、再編集の期間を含むリリースマップを作成します。

明示的な承認と、信頼できる情報源による確認なしに、公開、予約、アップロード、共有設定の変更、クォータの消費、キャンペーンの有効化を行ってはなりません。

編集可能なプロジェクトをレビューして引き継ぐ

プレビュー、修正、またはチームへの引き継ぎを計画する前に、references/editing-workflow.mdを読んでください。選択したすべてのアセットに全期間アクセスできるようにし、不変のバージョン、タイムスタンプ付きのフィードバック、編集可能なソースとの対応関係を用意してください。フックのテストやコンパクトなプレビューは、全体のレビューを補完するものです。ユーザーのストレージとフォアグラウンド再生に関する希望を尊重してください。

このパッケージには、運用スキルと2つのバリデーターが含まれています。ホスト型エディター、メディアストレージ、レンダリングサービス、マルチプレイヤーアプリケーションは含まれていません。利用可能で承認済みのエディターまたはレンダラーを使用し、利用できないインフラストラクチャについては明確に説明してください。リファレンスに記載された共有ワークスペースの設計は実装契約であり、デプロイ済みの機能ではありません。

仕上げて納品し、学びを得る

references/quality-gates.mdを適用してください。ソースの完全性、ポートフォリオとの整合性、メディアのデコードとタイミング、編集境界、レンダリングされた接続部分、キャプション、オーバーレイ、主張、権利、パッケージング、納品ファイルを確認してください。

technical integrity does not equal a coherent edit

references/delivery-contract.mdを読み、規定のモジュール式フォルダーとマニフェストを作成してから、次を実行してください。

python3 scripts/validate_delivery.py --root <delivery-folder>

納品バリデーターは、参照先のパス、ハッシュ、選択されたマニフェスト項目を確認します。PASSであっても、メディアの再生可能性、キャプションの品質、編集上の承認、公開準備が整っていることは証明されません。保留中および不合格の人間/エージェントによるレビューゲートは、見える状態にしておいてください。

スコア、モード、機会の件数、ポートフォリオマップ、再生時間、パッケージ、ソース、出力、QC、確認済みの納品先、公開状況、24時間後、72時間後、7日後の測定計画を提示してください。比較可能な結果が繰り返し得られた場合にのみ、教訓を昇格させてください。

エンジンを維持する

リクエストに応じて実行してください。このスキルはバックグラウンドジョブをインストールしません。各アセットの状態を、準備済み、レビュー候補、修正依頼、承認済み、レンダリング中、納品済みとして追跡してください。公開状況は、納品先の証拠とともに別途追跡してください。非公開のプロジェクト詳細を含めずに、修正内容を再利用可能な編集ルールとして記録してください。パフォーマンスに関する観察は、ブランドの好みと分けてください。該当するゲートを実際の成果物が通過した場合にのみ、ワークフローを昇格させてください。また、記録された代替ルールに置き換えられたルールは廃止してください。

コメント