Communitygithub.com

編集ワークフロー (有料ソーシャル広告向け)

クライアントのオファー、製品、映像を、正確なオファー表示、ランク付けされたフック、コンプライアンス審査、ライセンス審査を経て、ヘブライ語の有料ソーシャル広告に仕上げます。Meta、Instagram、TikTok向けの15~60秒の広告、スポンサード投稿、ブランドプロモーションに対応。

編集ワークフロー (有料ソーシャル広告向け) とは?

これは、クライアントから提供されたオファー、製品、映像素材を元に、ヘブライ語の有料ソーシャル広告(Meta、Instagram、TikTok向け、15~60秒)をスクリプト作成、編集、レビューするためのAIエージェントスキルです。主な特徴は、クライアントが確認した台帳と完全に一致するオファー文言の厳格な遵守、ランク付けされた複数のフックバリアントの生成、12項目からなる包括的なコンプライアンスチェック(ブロッキングあり)、音楽・効果音・ブランドアセットのライセンス審査、セーフゾーンの自動チェック、そして最終的なバッチ出力(フックバリアント、エンドカード、マニフェストファイル)です。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで動作するように設計されており、`ad`、`promo`、`sponsored`、`campaign`といったトリガーワード(ヘブライ語:`מודעה`、`פרסומת`、`קמפיין`、`ממומן`、`פרומו`、`מבצע`、`הנחה`、`הוק`)によって起動します。手順は、映像素材の取り込み、オファー台帳の作成、コンプライアンステーブルの生成、スクリプト作成、スタイルフレームの作成、人間による承認(PROMPT.md)、ビルド、各ゲート(自動チェック)の通過、バッチ出力、プレゼンテーションという流れで、各段階で品質を保証します。特に、コンプライアンステーブルで1つでも`fail`または`blocked`があるとプレゼンテーションが停止される点と、ライセンス不明のアセットは使用できない点が重要です。

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

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

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

ドキュメント

edit-ad-promo

クライアントのオファー、製品、映像をヘブライ語の有料ソーシャル広告に変換します。この広告はオファーを正確に伝え、ランク付けされたフックで始まり、コンプライアンスレビューとライセンスレビューを通過し、1つのボディに複数のフックバリアントを含むバッチとして納品されます。オファー、クレーム、ライセンスは、ピクセルを磨く前にチェックされます。

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

  1. オファー、価格、CTAは、書面で与えられたものと正確に一致させること。 文字列と数字はクライアントが確認した台帳から取得し、何も発明したり、丸めたり、「改善」したりしてはいけません。緊急性は、それが真実である場合にのみ含めます。クライアントからオファーがない場合は、抵抗の少ないオファーを提案し、質問すること。絶対に自分で作成してはいけません。
  2. コンプライアンステーブルはブロッキングです。 12のトピックすべてにステータスがあり、failまたはblockedの行があると、ルーブリックの内容にかかわらず、下書きの提示は停止されます。ラベル(AI開示、免責事項)は、欺瞞的なクレームを決して治癒しません。
  3. ライセンス: License: unknown = クライアントまたは広告作業に含まれていない(デシジョンデフォルトQ2:所有者の古い「オーガニックのみ」は、彼自身のアカウントに対するリスク姿勢であり、ライセンスではありません)。音楽と効果音は、ファイル自体の行が、そのプレースメントと地域での広告を許可している場合にのみ使用します。サードパーティのブランドサウンドとロゴは、広告用の書面によるブランド許可が必要です。楽曲のマッチングはライセンスではなく、トレンドのサウンドはクリアされていません。
  4. 普遍的なフックの法則はありません。 3秒のしきい値や固定されたリテンション数を検証する情報源はなく、フックは明示された理由によってランク付けされ、クライアント自身の結果によってテストされます。
  5. セーフゾーンはハウスプリセットv1(日付あり、デバイスで未検証、デシジョンデフォルトQ5)であり、合格にはジオメトリだけでなく、表示されたオーバーレイが必要です。
  6. 支出とプライバシー: paid-generation-gate(日付入りの見積もりと承認)なしに有料生成は行いません。AIショットはムードまたは不足しているBロールとしてのみ使用し、開示します。クライアントの映像は、クライアントごとの決定なしにクラウドツールに送信してはいけません。snapshot --describe false。
  7. PROMPT.mdは、ビルドコードの最初の行の前に人間によって承認されます。 自律実行の場合も同様です(デシジョンデフォルトQ6)。スキルは手順であり、許可ではありません。ユーザーとプロジェクトの制限がこのファイルよりも優先されます。他のClaudeセッションにメッセージを送信してはいけません。

入力 -> 出力

入力: 書面でのオファー(価格、条件、期限、免責事項)、CTAチャネル(ボタン、WhatsApp、コード、アドレス)、プラットフォームとルート(オーガニック、オークション広告、Spark)、長さ(デフォルト15 + 30秒)、製品とブランドアセット、映像と同意。出力: hf/OFFER 台帳行(PROMPT.md内)、hf/ad_gates.json(オファー表示面、フック、コンプライアンス、アセット)、1つのボディ+エンドカード上のN個のフックバリアント、コンプライアンステーブル、ファイルごとのQA、命名 <name>_<platform>_<hook>_<aspect>.mp4 とマニフェスト(multi-video-variants)。

手順

#行うことアーティファクト
0video-intake で受け付け:オファー+条件+期限、CTAチャネル、プラットフォーム/ルート、長さ、アスペクト比、フック(3つ)、クライアントアセットチェックリスト(references/ad-blueprint-and-hooks.md)、同意。参考広告がある場合は、最初に reference-style-transfer を実行。ソースフォルダ全体を ls する。BRIEF + 台帳
1オファー台帳:正確な文字列ごとに1行(ヘブライ語の原文、通貨記号、期限、CTA)、それが表示されるべき面(音声、スーパー、エンドカード)とともに。台帳行
2スクリプト作成前にブリーフからコンプライアンステーブルを作成(references/compliance-table.md):クレーム、価格条件、ビフォー/アフター、レビュー、個人属性フック、健康/金融、ブランドアセット、AI開示、音楽ライセンス、人物の同意、偽のUI、プラットフォームポリシー。ad_gates.json コンプライアンス
3スクリプト:理由付きでランク付けされた3つのフック、長さごとのビートシート(フック、問題、解決策、証明、オファー、CTA)、オファーを3回、15秒と30秒のカット。ペーパーエディット用にナレーションを文字起こし。SCRIPT.md
4セーフゾーンオーバーレイ付きのスタイルフレーム:フック、プライスタグ、ビフォー/アフター、エンドカード。それぞれにライセンス行があるアセット(references/sound-and-licences.md)。paid-generation-gate を通じてのみ有料生成を行う。スタイルフレーム、SOURCES.md
5PROMPT.md + DESIGN.md(すべてのフレーム:内容、ピクセル単位の位置、フレーム単位のタイミング、イージング、サウンド)→ 人間による承認 → ビルド:カット、グラフィックス(価格バッジ、UIはコードで再構築、ストックは使用しない)、キャプション、カラー、ミックス。hf/ プロジェクト
6機械的ゲート:python scripts/ad_gate_check.py hf/ad_gates.json と python scripts/safe_zone_check.py elements.json --aspect 9x16 --overlay-evidence <表示されたスナップショット>。両方とも exit 0。レポート
7確認:render-qa-deliver(最終ファイルの全フレームQA)、ルーブリックA1-A8(references/rubric-and-benchmarks.md)、ミュートテスト、セット全体に対する1つの批評家。ラウンドごとに1つの完全なレンダリング。QAエビデンス
8バッチ:共有ミックス上のフックバリアント、nomusic / nocaps バージョン、multi-video-variants を介した他のアスペクト比(manifest_check.py exit 0)。final/ + マニフェスト
9提示:ファイルを一度に、番号付きの変更点、コンプライアンステーブル、台帳チェックマーク、正直なギャップ(デバイステストされていないもの)。メッセージ

ゲート

状態は pass | fail | blocked | n/a で、理由を伴います。タイムアウト、空のサンプル、または入力がない場合は、pass ではなく blocked です。ツールコールの成功は実行の証拠であり、表示されたレンダリングは外観の証拠です。

ゲート述語証拠偽の場合所有者再チェック時期
G1 オファーの正確性すべての台帳の文字列/数字が、必要な各面に原文のまま表示される。台帳にない価格やパーセンテージが画面に表示されない。CTAが存在する。ad_gate_check.py のオファー検出結果がクリア(OFFER_NOT_EXACT、UNLEDGERED_AMOUNT、NO_CTA がない)。テキストを修正する。クレームを発明したり丸めたりしない。クライアントに確認する。ad_gate_check.py + 人間テキスト、価格、またはカードの編集があった場合。
G2 コンプライアンス12のトピックすべてが評価されている。fail/blocked がない。pass の行には証拠が添付されている。n/a の行には理由が添付されている。ad_gates.json 内のテーブル。ad_gate_check.py exit 0。クレームを削除または置き換える。準拠する文言を提案する。レンダリングしない。このスキル(ブロッキング)新しいクレーム、アセット、またはプレースメントがあった場合。
G3 フックのランク付け3つ以上のフックが明確な理由でランク付けされている。普遍的な3秒ルールの主張がない。禁止されているオープナーがない。ad_gates.json 内のフックリスト。再ランク付けする。理由を編集上の根拠として書き直す。このスキルフックの編集があった場合。
G4 セーフゾーンキーテキスト、CTA、価格、ロゴが各アスペクトのハウスゾーン内にある。9:16でキャプションレールの下部のy座標が1450以下。safe_zone_check.py が exit 0 であり、かつ、フック、オファー、エンドカードで表示されたオーバーレイスナップショットが添付されていること。要素を再レイアウトする。オーバーレイが表示されなかった場合は blocked を報告する。このスキルレイアウトの変更があった場合。デバイステストの結果があった場合。
G5 ライセンス各音楽/効果音/映像/ロゴに、広告許可、プレースメントカバレッジ、CC-BYの場合は帰属表示、サードパーティブランドアセットの書面による許可を示す行がある。AIアセットは開示されている。ad_gate_check.py のアセット検出結果がクリア。SOURCES.md。ライセンスされたアセットに交換する。ブランドに問い合わせる。このスキル + paid-generation-gateアセットまたはプレースメントの変更があった場合。
G6 バッチとエンドカードフックバリアントは1つのミックスを共有する(最初の数秒のみ異なる)。エンドカードは2~3秒で、ロゴ、オファー、連絡先、CTA、音楽が最後まで含まれる。1人の批評家がセット全体をレビューする。マニフェスト check exit 0。エンドカードフレームが表示された。重複排除、再マックス、失敗したファイルのみを再レンダリングする。multi-video-variantsマスターまたはフックの変更があった場合。
G7 ルーブリックとミュートテスト平均 >= 4.0、どの次元も < 3 ではない、ゲートA1/A2/A6が2以上。ミュートでもオファー、ブランド、CTAが理解できる。最終 -14 +/- 0.5 LUFS、TP <= -1。タイムコード付きの批評家レポート。qa delivery。変更された範囲のみを修正し、再レビューする。批評家 + このスキル各ドラフト。

数値(ハウスのデフォルト値と市場中央値、およびその制限)

  • ブループリント:フック 0-2/0-3秒、オファー 7-9秒(15秒カット)/ 19-22秒(30秒カット)、エンドカード 12.5-15秒 / 27-30秒。オファーとCTAで30秒広告の30~45%を占める(市場 31-42%)。
  • 少なくとも1.4秒ごとに視覚的な変化。約36カット/分(市場、16:9)および34.5カット/分(所有者、9:16)。ブランドは約1秒以内、製品は約3秒以内に表示。ラウドネスピークはロゴに1つ。
  • セーフゾーン 9:16:上 300 / 下 672(キーテキスト y <= 1248)/ 左 140 / 右 192、キャプションレール下部 y <= 1450:ハウスプリセットv1、日付 2026-10-02(references/safe-zone-presets.md)。
  • フックバンドの見出し:最大6ワード(音声オフの有料9:16に対するハウス推奨)。

決定ルール

もし〜ならばそうする
ブリーフにオファーがない書面でオファーを求めるか、抵抗の少ないオファーを提案して質問する。チェッカーは回答があるまで INSUFFICIENT のまま。
クライアントがトレンドの曲や映画のクリップを希望するライセンスされたトラックに置き換える。マッチングやトレンドはライセンスではないことを説明する。置き換え時間を予算に計上する。
フックが「最初の3秒で機能しなければならない」場合理由を編集上の根拠として書き直す。普遍的なしきい値は検証されていない。
クレームに証明がない(「最高」、「100%保証」)コンプライアンス行は blocked になる。文書化された文言を提案する。レンダリングしない。
9:16広告用に16:9のアセットしかないmulti-video-variants を通じてレイアウトを再構成する。フレームをゾーンに合わせてトリミングしたりスケールダウンしたりしない。
MetaとTikTokのカットが異なるファイル名にプラットフォームトークンを含め、プレースメントごとにライセンス行を設ける。
広告が主にAIショットで構成されているedit-ai-generated もロードし、ルートごとに開示し、ゲートを通じてのみ支出する。
クライアントの承認済みルックがスキルの署名と矛盾するクライアントのルックを優先する。ルーブリックの逸脱を注記する。

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

台帳と異なるオファー文字列。台帳にない画面上の金額。fail/blocked のコンプライアンス行。unknown、NC、または広告許可がないアセット。書面による許可がないサードパーティブランドアセット。表示されたオーバーレイがないセーフゾーンの主張。manifest_check.py が READY でない。それぞれが停止理由であり、何が解除するかを示す。

それぞれがラウンドまたはキャンペーンを台無しにする落とし穴

30秒広告の21.6秒に埋もれた割引。キャプションとしてスタイル設定された価格。「大幅な割引」という数字の代わりの表現。最後にしか登場しないブランド。カット内の商業的な曲やアニメクリップ。TikTok用にライセンスされたトラックをMetaで使用。有料広告内のサードパーティ決済サウンド。AIで加工されたビフォー/アフター。0 dBTPを超えるトゥルーピーク。ブランド名や住所のスペルミス。15 + 30秒が要求されたのに46~53秒の広告を提出。理由なしに「最高」と評価されたフック。異なるミックスを密かに持つフックバリアント。

参考文献(以下の場合にロードすること)

  • references/ad-blueprint-and-hooks.md - スクリプト作成:ブループリント、フックラダー、オファー/CTA/エンドカード、ビジュアルグラマー、クライアントアセットチェックリスト。
  • references/compliance-table.md - ステップ2および提示前:12のトピック、証拠、準拠した文言、プラットフォームメモ(日付あり)。
  • references/safe-zone-presets.md(+ references/safe_zone_presets.json、スクリプトが読み込む)- 任意のレイアウト。「合格」と言う前に(日付付きプリセット)。
  • references/sound-and-licences.md - 音楽/効果音の選択、ライセンス行、ミキシングとレベル。
  • references/rubric-and-benchmarks.md - 提示前。下書きの採点。数値テーブル。
  • 他のスキル:video-intake、reference-style-transfer、multi-video-variants、render-qa-deliver、revision-round、paid-generation-gate、edit-ai-generated(主にAIショットで構成された広告)。プラットフォームの事実:agent-content/references/platform-specs.md(他で管理、日付あり)。ベンチマークルーブリック agent-content/benchmarks/ad-promo.rubric.md(他で管理)。
  • スクリプト:scripts/ad_gate_check.py、scripts/safe_zone_check.py(stdlib、Usage docstring、--self-check、exit 0 / 1 / 2)。

Individual skills in this repo

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

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

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

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).

関連スキル