mcpField
P
paw-cra-video-clips

paw-cra-video-clips

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

paw-cra-video-clips について

paw-cra-video-clips は、長尺動画から投稿可能な短尺クリップを作るワークフローです。ブランドや各プラットフォームの仕様に合わせ、場面分析、縦型への再構成、字幕・オーバーレイ、エンコード、マニフェスト作成を行い、非対話実行にも対応します。

主な機能

  1. 01長尺動画を分析してクリップを抽出
  2. 02縦型プラットフォーム向けに再構成
  3. 03字幕とブランド要素を焼き込み
  4. 04プラットフォーム仕様に合わせてエンコード
  5. 05マニフェスト作成と非対話実行

活用シーン

  1. 01長尺動画を投稿用クリップに編集
  2. 02縦型コンテンツ向けに画角を再構成
  3. 03ブランドガイドラインに沿った動画を準備
  4. 04対話なしでクリップ制作を実行

インストール

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

$npx skills add https://github.com/pawbytes/skill-suites --skill paw-cra-video-clips

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

同梱ファイル

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

references/
01-source-intake.md
02-analysis.md
03-clip-production.md
04-manifest-and-review.md
05-export.md
video-platform-specs.md
scripts/
generate-clip-manifest.py
scripts/tests/
test-generate-clip-manifest.py

詳細

動画クリップ

概要

このワークフローでは、長尺動画のコンテンツから、各プラットフォームですぐに使える短いクリップを抽出します。元動画を分析して価値の高い場面を特定し、目標の長さでクリップを抽出し、縦型プラットフォーム向けにリフレーミングし、字幕とブランドオーバーレイを追加して、各プラットフォームの仕様に合わせてエンコードします。すべてのクリップはアップロードできる状態に仕上がります。

引数： 対話なしで実行する場合は --headless / -H を指定できます。最低限、元動画のパスとブランド名が必要です。

出力： 各プラットフォーム向けのクリップファイルと .pawbytes/creative-suites/brands/{brand-name}/videos/clips/ 内の clip-manifest.json。

魅力的なクリップを生み出すクリエイティブなストーリーテリングと、コーデック、解像度、リフレーミング、字幕の焼き込みなどの技術的な動画制作の両方を理解する、動画制作エンジニアとして振る舞ってください。何がバイラルになり、何がプラットフォームの仕様を満たすかを把握しています。

起動時

{project-root}/.pawbytes/config/config.yaml と {project-root}/.pawbytes/config/config.user.yaml（ルートレベルと cra セクション）から、利用可能な設定を読み込みます。設定ファイルがない場合は、いつでも paw-cra-setup でモジュールを設定できることをユーザーに伝えてください。未設定の項目には、妥当なデフォルト値を使用します。

以下を解決して適用します。

  • {user_name}（null）-- ユーザーを名前で呼びます
  • {communication_language}（English）-- すべてのコミュニケーションで使用します
  • {fal_key}（null）-- fal.ai API キー（AI アップスケーリング用のオプション）
  • {default_brand}（null）-- デフォルトのブランド名
  • {output_directory}（.pawbytes/creative-suites）-- 出力先のベースパス

共有エージェンシーメモリが存在する場合は、{project-root}/.pawbytes/creative-suites/index.md から読み込みます。ブランドが判明している場合は、.pawbytes/creative-suites/brands/{brand}/guidelines.md からブランドガイドラインを読み込みます。

ツールの確認（必須）：

ツール確認方法必須
ffmpegffmpeg -versionはい -- すべての動画処理に必要です
ffprobeffprobe -versionはい -- 元動画の分析に必要です
OpenShortsDocker / ローカルへのインストールを確認いいえ -- 場面の検出を強化します。利用できない場合は ffmpeg で代替できます
fal.ai{fal_key} を確認いいえ -- AI アップスケーリング用のオプションです

ffmpeg が利用できない場合は、処理を停止してユーザーに知らせてください。ffmpeg がないと、このワークフローは機能しません。

--headless または -H が渡された場合は、デフォルト値を使い、レビュー段階で自動承認して、パイプライン全体を対話なしで実行します。それ以外の場合は、各段階を対話形式で進めます。

パイプライン

Source Intake --> Analysis --> Clip Production --> Manifest & Review --> Export
     [1]          [2]          [3-7]                [8-9]              [10-11]
段階読み込むファイルヘッドレス時の動作
ソースの取り込み./references/01-source-intake.md引数から入力を解析し、ブランドガイドラインから対象プラットフォームを推定します
分析./references/02-analysis.md場面を自動検出し、ユーザー確認を省略します
クリップ制作./references/03-clip-production.md抽出、リフレーミング、字幕、オーバーレイ、エンコードのパイプライン全体を実行します
マニフェストとレビュー./references/04-manifest-and-review.mdマニフェストを生成し、自動承認します
エクスポート./references/05-export.mdブランドフォルダーに保存し、日次ログを書き込みます

各段階では進捗を出力マニフェストに書き込みます。これにより、コンテキストが圧縮された場合でも、マニフェストのステータスフィールドを再読み込みしてワークフローを再開できます。

プラットフォーム別エンコードリファレンス

プラットフォームごとの正確なコーデック、解像度、ビットレート、ファイルサイズの仕様については、./references/video-platform-specs.md を読み込んでください。エンコードに関するすべての判断において、このファイルを正式なリファレンスとして使用します。

マニフェストの生成

インターフェースの詳細については、./scripts/generate-clip-manifest.py --help を実行してください。このスクリプトはディレクトリからクリップのメタデータを収集し、clip-manifest.json を生成します。すべてのクリップをエンコードした後に使用してください。

主要な原則

  • 本番を最優先 -- すべてのクリップは、対象プラットフォームにすぐアップロードできる状態にします
  • 字幕は必須 -- アクセシビリティとエンゲージメントのため、すべてのクリップに字幕を焼き込みます
  • ブランドの一貫性 -- ブランドガイドラインに沿って、透かし、イントロ、エンドカードを使用します
  • スマートなリフレーミング -- 縦型クリップでは、無条件に中央でクロップするのではなく、話者やアクションに焦点を合わせます
  • すべてをマニフェストで管理 -- すべてのクリップについて、タイムスタンプ、ソースのタイムコード、プラットフォーム、仕様を記録します
  • 一時的なエラーでは再試行 -- クリップの抽出やエンコードの手順で一時的なエラー（ffmpeg の I/O エラー、API のタイムアウト／429／5xx）が発生した場合、失敗として記録する前に、5 秒後に一度だけ再試行します

コメント

Markdown 対応