mcpField
B
broll-catalog-builder

broll-catalog-builder

github.com/postplusaiクリエイティブ・メディア27281 回インストール1 日前に更新
リポジトリ

broll-catalog-builder について

Bロールのフォルダーやファイル一覧から、再利用できる素材カタログを作成するスキルです。意味タグ、使用可能な範囲、用途、証拠力を記録し、後続のマッチングに備えます。

主な機能

  1. 01ローカルフォルダーのメディア走査
  2. 02タグと用途の記録
  3. 03使用可能な範囲の特定
  4. 04証拠力と映像上のリスクを分類

活用シーン

  1. 01再利用可能なBロール素材一覧の作成
  2. 02キャンペーンの主張を支える映像の検索
  3. 03根拠映像とフィラー素材の区別

インストール

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

$npx skills add https://github.com/postplusai/postplus-skills --skill broll-catalog-builder

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

同梱ファイル

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

_postplus_shared/00-core/shared-runtime/scripts/
download_videos_from_manifest_with_ytdlp.mjs
postplus_workspace.mjs
_postplus_shared/00-core/shared-runtime/scripts/lib/
execution_approval.mjs
hosted_billing_summary.mjs
hosted_execution_protocol.mjs
creative_format.mjs
postplus_cloud_client.mjs
hosted_media_generation_bridge.mjs
network_runtime.mjs
local_skill_cli.mjs
skill_runtime.mjs
postplus_workspace_runtime.mjs
postplus_cli_config.mjs
_postplus_shared/40-creative/b-roll-family/references/
skill-architecture.md
edit-enhancement-contract.md
contracts.md
scripts/
run_build_broll_catalog.mjs

詳細

B-roll カタログビルダー

次の共有パブリックスキルルールに従ってください:

  • postplus-shared パブリックスキルルール

このスキルは、ユーザーが B-roll アセットを保有しており、編集を計画する前に再利用可能なアセットインベントリを必要としている場合に使用します。

このスキルは、ワークフローの B-roll 側のアセットマザーファイルを作成する必要があります。

デフォルトの出力:

  • broll-catalog.json

オプションの補助出力:

  • コンタクトシート
  • フレームマニフェスト
  • Markdown レビューサマリー

用途

  • B-roll フォルダーを再利用可能なカタログに整理する
  • ファイル名だけでなく意味的な意味で B-roll にタグを付ける
  • 長い B-roll クリップ内で使用可能な最適な範囲を特定する
  • 強い証拠クリップと弱いフィラークリップを分離する
  • 後のビートと B-roll のマッチングのためにアセットを準備する

トリガーシグナル

次のようなことをユーザーが求めた場合にこのスキルを使用します:

  • まずこれらの B-roll アセットを整理して
  • これらのアセットにタグを付けて
  • どのアセットが証拠として適しているか
  • 再利用可能な B-roll アセットテーブルをください
  • まずアセットライブラリを構築して

ユーザーがすでに良好なカタログを持っており、最終的なビートマッチングが必要な場合は、このスキルを使用しないでください。

それは次にルーティングしてください:

  • skills/40-creative/b-roll-family/broll-match-engine

これらのリファレンスを読む

  • ファミリーアーキテクチャ: ../references/skill-architecture.md
  • 共有コントラクト: ../references/contracts.md

役立つ場合は、これらの既存のローカルスキルを使用してください:

  • skills/40-creative/frame-extraction
  • 専用のビジュアル分析ワークフロー

中核原則

文字通りに見えるものだけでアセットをカタログ化しないでください。

また、次も捉えてください:

  • そのアセットが何を証明するか
  • どのような編集役割を果たせるか
  • 画面上でどれだけ新鮮さを保つか
  • 一次証拠として十分に強いか、それともサポートのみか

同じクリップは次のようになり得ます:

  • 強い証拠
  • 弱い証拠だが良いトランジションカバー
  • 純粋なペースリセット
  • UI デモ

使い方によって異なります。

必須入力

少なくとも次のいずれか:

  • B-roll ファイルのローカルフォルダー
  • B-roll ファイルのマニフェスト
  • ローカルファイルパスのリスト

オプションですが価値があります:

  • キャンペーンコンテキスト
  • トランスクリプトまたはスクリプト
  • ターゲットプラットフォーム
  • 既知の証拠目標

ワークフロー

1. アセットセットを復元する

次から作業ファイルリストを構築します:

  • フォルダースキャン
  • マニフェスト
  • 明示的なファイルリスト

ローカルパスを保持します。

2. アセットを検査する

各アセットについて、次を捉えます:

  • メディアタイプ
  • ビデオの場合は再生時間
  • 文字通りの説明
  • 最も強い使用可能範囲
  • セマンティックタグ
  • サポート役割
  • 視覚的リスク

役立つ場合は、軽量な抽出またはコンタクトシート生成を使用します。

3. 編集の有用性を判断する

各アセットについて、次を決定します:

  • 一次証拠、サポート証拠、またはフィラーか
  • どの主張をサポートできるか
  • 9:16、16:9、またはその両方に適合するか
  • テキストや UI が十分に読み取れるか
4. カタログをパッケージ化する

共有コントラクトを使用して broll-catalog.json を構築します。

カタログは複数の編集実行にわたって再利用可能であるべきです。

最小スクリプト

最初の実装スクリプト:

  • scripts/run_build_broll_catalog.mjs

現在の初版の動作:

  • ローカルフォルダーを再帰的にスキャンします
  • ビデオおよび画像アセットを保持します
  • 再生時間と寸法に ffprobe を使用します
  • 存在する場合、同じベース名の .md サイドカーを読み取ります
  • ファイル名とサイドカーテキストから保守的なセマンティックタグとサポート役割を推測します
  • broll-catalog.json を書き込みます

例:

node ${CLAUDE_SKILL_DIR}/scripts/run_build_broll_catalog.mjs \
  --input-dir /abs/path/to/b-roll-source \
  --output <work-folder>/broll-catalog.json

パブリックスキル実行コントラクト

  • フォルダースキャン、コンタクトシート入力、フレームマニフェスト、および中間 カタログビルドは <work-folder>/.postplus/broll-catalog-builder/ の下に保持します
  • 最終的なユーザー向け broll-catalog.json またはレビューエクスポートのみを .postplus/ の外に保持します
  • より広範なカタログ化の前に、1 つのフォルダーまたはショートリストで 境界のある最初のパスから始めます
  • このスキルには ffprobe が必要です。カタログ化の前に postplus-shared の ローカル依存関係ブートストラップルールに従ってください
  • ローカル依存関係のブートストラップが失敗した場合は、アドホックなシェル グルーに切り替えるのではなく、直ちに停止してください

出力標準

下流のマッチャーが以下に答えられるなら、カタログは良好です:

  • どのようなアセットが存在するか
  • それらがどの主張を裏付けるか
  • どれが実際に強力か
  • 有用なカット範囲がどこにあるか

出力が漠然としたタグ付きのファイル一覧だけでは、十分ではありません。

初版の境界

優先するもの:

  • ローカルファイルのスキャン
  • ffmpeg メタデータ
  • 必要に応じたフレーム抽出
  • Markdown と JSON のパッケージング

必須としないもの:

  • 重い CV パイプライン
  • 完全な物体認識
  • レビューなしの完全自動クリップスコアリング

レビューのルール

信頼度が低い場合は、その旨を明記してください。

弱い、あるいは汎用的なクリップを、強力な証拠映像であるかのように装ってはいけません。

アセットを次のようにマークする方が良いです:

  • generic filler

その有用性を誇張するよりも。

コメント

Markdown 対応