Communitygithub.com

マルチビデオバリアント

承認済みのマスタービデオを複数のアスペクト比、フックバリアント、プラットフォーム向け出力に変換し、共有ミックスと厳格な命名規則、マニフェストによる管理を提供します。

マルチビデオバリアント とは?

このスキルは、1つの承認済みマスタービデオから、複数のアスペクト比(9:16、1:1、4:5、16:9)やフックバリアント(フル、ノーミュージック、ノーキャプション)、プラットフォーム別(Meta、TikTok、YouTube、Instagram、LinkedIn、X)の出力を生成するためのワークフローを定義します。各バリアントはマスターのコピーをリレイアウトして作成され、クロップやスケーリングは禁止されています。共有ミックス(cues.jsとmix.wav)はすべてのバリアントで統一され、バリアントごとにオーディオが再構築されることはありません。レンダリングは1度に1つの重いジョブのみ実行可能で、マニフェストチェックによってすべてのバリアントが最新のマスター状態から生成されていることが保証されます。マスターに変更があった場合は、すべてのバリアントに同時に適用され、再レンダリングされます。このスキルは、Claude CodeやCursorなどのAIエージェント環境で動作し、ビデオ制作のバリアント管理における一貫性と追跡可能性を提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/multi-video-variants

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

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

ドキュメント

マルチビデオバリアント は何をしますか?

承認済みマスター1つからN個の出力を生成します。どのファイルがどのソース状態から来たのか、制御を失うことなく管理します。バリアントマトリックス、マスターフリーズ、リレイアウトコピー、共有ミックス、命名規則、1度に1レンダリングのキュー、エージェント監視ルール、マニフェストゲートを担当します。マスターのデザイン(タイプスキルが担当)は行わず、ファイルごとのQA(render-qa-deliver)も置き換えません。

このファイルよりも優先されるルール

  1. マスターが先、その後フリーズ。 派生ファイルは、自身の完全なQAを通過し、manifest_check.py freezeで記録されたマスターからのみ作成されます。後で修正が必要な場合は、マスターで修正し、changeで記録し、同じラウンドですべてのコピーに適用し、すべての派生ファイルを再レンダリングして再記録します。コピーのみを修正することは禁止されています。
  2. リレイアウト、クロップは禁止。 各アスペクトはマスターソースのコピー(hf_9x16/、hf_1x1/ ...)であり、独自のキャンバス、安全ゾーン、タイプスケール、キャプションレール、カメラキー、フェイスセンタリングを持ちます。レンダリング済みマスターをFFmpegでクロップまたはスケールすることはバリアントではありません。
  3. 1つのミックス。 リレイアウトとフックバリアントは、同じcues.jsとassets/mix.wavのバイトを使用し、その1つのファイルからマックスされます。バリアントごとにオーディオが再構築されることはありません。独自のミックス(ノーミュージック、独自ボイスオーバー、再カット長)が本当に必要なバリアントは、マニフェストで理由を宣言します。
  4. マシン全体で1度に1つの重いジョブ(レンダリング、check、マット、ASR、Blender)をrender_lockの下で実行します。並行作業は、非重いタスク(レイアウト、仕様、QA読み取り)に制限されます。最大4エージェントの並列、各エージェントは最大2サブエージェント。
  5. 「準備完了」は計算され、主張されません。 この単語は、manifest_check.py checkが0で終了した場合にのみ許可されます。タイムアウト、空のフォルダ、欠落したハッシュ、qa: not_runまたは欠落した証拠はblocked / INSUFFICIENT_EVIDENCEであり、passではありません。
  6. 有料アクションはpaid-generation-gateなしでは行わないでください。別のClaudeセッションにメッセージを送信しないでください。ユーザーとプロジェクトの制限がこの手順を上書きします。安全ゾーン、-14 LUFS、キャンバスはハウスプリセットv1(決定デフォルトQ5)であり、プラットフォームの法則ではありません。

入力 -> 出力

入力:承認済みマスター(hf/、PROMPT.md、DESIGN.md、cues.js、assets/mix.wav)とインテークからのバリアントマトリックス。出力:final/<name>_<platform>_<hook>_<aspect>.mp4 x N、final/manifest.json(最終ファイル+マニフェストのみ)、ファイルごとのQAレポート(_work/qa/<aspect>/<round>/の下)、_work/agents/<agent>.progress.md、_work/STATE.md(キュー)。 命名:<name>_<platform>_<hook>_<aspect>.mp4、<name>は小文字のASCIIスラッグ(アンダースコア許可)、<platform> = meta|tiktok|yt|ig|linkedin|x|all、<hook> = master | hookA | hookA-nomusic | hookA-nocaps、<aspect> = 9x16|4x5|1x1|16x9。また、ショート形式<name>_<aspect>.mp4(プラットフォームall、フックmaster)も受け入れます(配信プレイブックと同様)。ユーザーが元帳で指定した名前は規則を上書きし、元帳IDとともに記録されます(record --name-ledger-id)。

手順

#ステージ実行内容成果物
0インテーク時のマトリックスファイルごとに1元帳行:アスペクト、プラットフォーム、ルート(オーガニック/広告/スパーク)、フック、バージョン(フル、ノーミュージック、ノーキャプション、長さ)、マスターアスペクト。後発の「可能性のある」アスペクト比:レイアウトノートを今書いておき、後でリクエストがあっても1エージェントで対応でき、再構築を防ぐ(references/variant-matrix-and-layout.md)PROMPT.md <inputs> 内のマトリックス、マニフェスト内のmatrixリスト
1マスターゲートマスター承認済み、render-qa-deliverの全フレームQA通過、manifest_check.py freeze <project> --hf hf --matrix ...フリーズされたsrc_hash + mix_sha256
2リレイアウトコピーアスペクトごとに1エージェントがコピー上で作業。同じキューとミックス。レイアウトテーブルを埋める(要素ごとの変更点、references/variant-matrix-and-layout.md)。プリフライトエラー0。フック、オファー、エンドカードのスナップショットオーバーレイ(--describe false、呼び出しごとに最大5タイムスタンプ)hf_<aspect>/、_work/qa/<aspect>/layout.md
3フック/バージョンバリアントフック = アスペクトのコピー内の変数にバインドされたサブコンポジション、バリアントごとに1行。最初に1つのバリエーションをテスト(バッチ変数はプロジェクトで未テスト)。共有ミックスをマックス。ノーミュージック/ノーキャプション = 宣言されたミックスまたはレイヤーバリアントrows.json、バリアントファイル
4キュー_work/STATE.mdにレンダリング順序を書き込む(マスター、次に各アスペクト、次にバリアント)。各レンダリングの前にmanifest_check.py stamp。レンダリングはhf_deliver / render_lock runを通じて1度に1つ。レンダリング所有者は2つ目の重いジョブを開始しないロックログ、スタンプ
5記録各レンダリング後:record(ハッシュ、適用されたマスター修正、ミックスバリアント、QA状態、最終ファイルで測定されたラウドネス)manifest.json
6出力ごとのQAframe_qa、caption_qa --band <top>:1450(9:16)、motion_qa(レイアウトがモーションを変更した場合)、face_center audit(スピーカーフッテージ用)、qa delivery。ビジュアルレビュー軸1(コンポジション/クロップ)と4(可読性)のみ。軸2-3はモーションが変更されない限り継承レポート + 証拠パス
7準備完了ゲートmanifest_check.py check <project> --jsonが0で終了。ソースハッシュ、QA状態、LUFS/TPとともにファイルリストをユーザーに表示。ギャップを正直にリストREADYレポート
8学習ファイルごとのタイミング元帳行、受信トレイへの教訓_work/timing_ledger.jsonl

ゲート

状態は、理由とともにpass | fail | blocked | n/aです。タイムアウト、空のサンプル、または入力欠落はblockedであり、passではありません。成功したツール呼び出しは実行証拠です。表示されたレンダリングは外観証拠です。

ゲート前提条件証拠偽の場合所有者再チェック時期
G1 マトリックスすべての出力に、構築前に元帳行(アスペクト、プラットフォーム、ルート、フック、バージョン)があるPROMPT.mdとマニフェスト内のmatrix不足している軸を今すぐ尋ねる。構築しないこのスキル + video-intake新しいアスペクト比/バリアントリクエスト時
G2 マスター凍結マスターが完全なQAを通過。freezeが記録済み。派生ファイルがそれより早く開始されていないマニフェストのmaster.src_hash、frozen_utcがすべてのスタンプより古い派生ファイルを停止。フリーズこのスキルマスターソースの変更時
G3 リレイアウト各派生ファイルが独自のルートキャンバス、要素ごとのレイアウト行、そのアスペクトの安全ゾーンを持つ。クロップされたマスターレンダリングがないlayout.md行 + オーバーレイスナップショット + プリフライト0エラー失敗している要素をリレイアウト。フレーム全体をスケールしないアスペクトのエージェントマスターレイアウトの変更、新しいコピー時
G4 共有アセットcues.*とassets/mix.wavがすべてのリレイアウト/フックコピーでマスターと同一。フックバリアントはマックス、リミックスしないmanifest_check.py check:M035/M041なしマスターのキュー/ミックスをコピーして戻す。再レンダリングこのスキルマスターキューまたはミックスの変更時
G5 出力ごとのQA各ファイルがqa: passで証拠ファイルとLUFS -14 +/- 0.5、TP <= -1(最終ファイルに対して)を持つ(ハウスゲート)マニフェスト内のqa_evidenceパス、lufs、tp数値そのファイルのみ修正して再レンダリングrender-qa-deliver再レンダリング時
G6 重いジョブの規律一度に正確に1つの重いジョブ。<= 4エージェント、各<= 2サブエージェント、各エージェントはファイルリスト、出力ファイル、期限、進捗ファイルを持つrender_lockログ、_work/agents/*.progress.mdのmtimeキューに入れる、余分なジョブを停止(自身のプロセスのみ)このスキル各エージェント起動時
G7 マニフェスト準備完了古い / 孤立 / 欠落 / レンダリング後に変更されたものすべてが存在しないmanifest_check.py check終了コード0失敗しているファイルをユーザーにリスト。古いものを再レンダリングmanifest_check.py「準備完了」と言う前、変更後

数値(ハウスプリセットv1、日付2026-10-02、詳細はreferences/house-presets.md)

  • キャンバス:9:16 1080x1920、4:5 1080x1350、1:1 1080x1080、16:9 1920x1080。H.264 SDR yuv420p、AAC 48 kHz、30 fpsデフォルト。
  • 安全ゾーン、キーテキスト/CTA/ロゴ/価格:9:16 上300 / 下672(y <= 1248)/ 左140 / 右192、キャプションレール下 <= y 1450。16:9 x <= 1824、上54、下162。4:5と1:1は各側54 px。デバイスで未確認:オーバーレイ演習を実行。
  • ラウドネス:-14 LUFS統合 +/- 0.5、トゥルーピーク <= -1 dBTP、最終ファイルで測定。ミックス中間TP <= -1.5。
  • 監視:約15分ごとにハートビートチェック。20分間沈黙または期限超過 = チェック、交換または停止。沈黙が約10分続いたらユーザーにステータス行。レンダリングタイムアウト = 測定ETAの3倍。(出典:distilled 02ワークフロー§13.6、2026-10-01)

決定ルール

もしならば
派生ファイルが存在した後にマスター修正が必要マスターを修正、change、パッチをすべてのコピーに適用、すべてを再レンダリングして再記録
コピーに異なるタイミングやキューが必要それはマスター変更。または、独自の元帳行を持つ新しい編集(recut)。静かなフォークは禁止
フックに異なる話し言葉が必要理由とともにown-voを宣言。他のすべてのバリアントは共有ミックスを維持
アスペクト比が後でリクエストされたレイアウトテーブルを書き込み、凍結されたマスターのコピー上で1エージェントを起動。マスターに触れない
2つのレンダリングが同時にリクエストされたキューに入れる。ロックが決定。STATE.mdに順序を書き込む
エージェントが期限を過ぎて沈黙進捗ファイルを確認し、その後交換または停止(自身のプロセスのみ)、その後render_lock status
finalsフォルダに古いレンダリングがある_work/delivered/v<N>/に移動。「準備完了」はフォルダがマニフェストと一致するまでブロックされる
ユーザーがファイルに名前を付けるユーザーの名前が優先。--name-ledger-idで記録し、platform/hook/aspectフィールドは明示的に維持

ブロック状態(報告し、回避しない)

manifest_check.py BLOCKED または INSUFFICIENT_EVIDENCE。from_masterが古い、またはマスター修正が欠落している派生ファイル。レンダリング後に変更されたソース。共有キューまたはミックスのずれ。qaがpassでない。約束されたバリアントが欠落。計画外のファイルが存在。どのファイル、どのコード、修正方法を伝える。

それぞれ実際の時間を浪費する落とし穴

配信時の後発16:9リクエスト(完全なリレイアウト、ドロップ)。3.7秒のマスター修正が1:1に適用されなかった。古いレンダリングが新しいものの横に残され、誰もフラグを立てなかった。派生エージェントがマスターバグを見つけて自分のコピーのみを修正した。3つのエージェントが同時にレンダリング(並行Blenderジョブがレンダリングを2倍にし、11.5分が21.5分に、所有者のラップトップ)。MetaとTikTokのカット間での命名衝突。1つのフックバリアントが静かに異なるミックスを運んだ。各アスペクトの表示されたコンタクトシートは依然として必要:ハッシュは顔にかぶったキャプションを見ることができない。

参照(必要なときに読み込む)

  • references/variant-matrix-and-layout.md - マトリックスの書き方、アスペクトのリレイアウト、フック/ノーミュージック/ノーキャプション/長さバリアント。
  • references/manifest-schema.md - ファイルの記録、manifest_check.pyの結果の読み取り、古い派生ファイルのライフサイクル。
  • references/parallel-and-agents.md - エージェントの起動、キュー、ロック、ハートビート、停止、トークンバジェット。
  • references/house-presets.md - キャンバス、安全ゾーン、ラウドネス、プラットフォーム番号を引用する前に(日付付きモジュール)。
  • agent-content/references/platform-specs.md(正規のプラットフォーム事実、他で所有)およびagent-content/playbooks/wf-08-deliver.md(配信プレイブック:命名、マニフェストルール) - エクスポートプリセットとプレイブック。数値が異なる場合、正規ファイルが優先され、references/house-presets.mdが更新される。
  • 他のスキル:render-qa-deliver(ファイルごとのQA)、hebrew-captions-asr(キャプションレール)、edit-ad-promo(フックランキング)、revision-round(アスペクト間のノート)、paid-generation-gate。
  • スクリプト:scripts/manifest_check.py(--self-check 29ケース、終了コード0 READY / 1 BLOCKED / 2 INSUFFICIENT_EVIDENCE)およびscripts/test_manifest_check.py(単体テスト)。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

関連スキル