Communitygithub.com

cgallic/kai-cmo-harness

フルスタック動画制作:スクリプト作成からレンダリングMP4まで。TikTok/YouTube/Reelsに最適化されたスクリプト生成と、RemotionによるAI動画レンダリング、AI音声(Qwen3-TTS/ElevenLabs)、音楽生成(ACE-Step)、ブラウザベースデモ録画を統合。マルチセッションプロジェクト追跡と自動意図調整機能搭載。「動画作成」「動画制作」「デモ動画」「製品動画」など、生成・レンダリングを含む動画リクエストに使用します。

kai-cmo-harness とは?

このスキルは、AIエージェントがスクリプトからレンダリング済みMP4までフルスタックの動画制作を行うための強力なツールです。TikTok、YouTube、Reelsなどのプラットフォーム向けに最適化されたスクリプト生成から始まり、Remotionを使用したコードベースの動画レンダリング、Qwen3-TTSやElevenLabsによるAI音声、ACE-Stepによる音楽生成、そしてPlaywrightを使用したブラウザデモ録画までを統合しています。特に重要なのは、ファイルシステムを信頼できる情報源とし、複数セッション間でプロジェクトの状態を自動的に調整・復元する点です。事前に「バリアントラボ」でフック、構成、CTAのバリエーションを評価し、人間の承認を得てからフルレンダリングに進むことで、計算リソースを効率的に使用します。ModalやRunPodなどのクラウドGPUを活用し、60〜90秒の動画を約0.20ドルで制作可能で、高価なプレミアムサービスは明示的に選択した場合のみ使用します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgallic/kai-cmo-harness/tree/HEAD/harness/skills-v2/kai-video-production

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

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

ドキュメント

/kai-video-production — レンダリングされたMP4、それはレンダリングに値するスクリプトから始まった

Kai ルートノート: このスキル内の knowledge/、harness/、scripts/ パスは、Kai インストール内に存在し、ユーザープロジェクト内にはありません。それらは、この SKILL.md の最初の祖先ディレクトリで knowledge/ フォルダを含むもの(Kai プラグインルート、~/.claude/kai、または kai-cmo-harness リポジトリ)に対して解決します。MARKETING.md、memory/、および出力ファイルは現在のプロジェクト内に存在します。参照された scripts/ コマンドがこのインストールで利用できない場合は、その旨を伝え、スキップし、ファイルベースのガイダンスを続けてください。決してその出力を捏造しないでください。

スタジオ品質のモーションスポット(コードレンダリングされたハイプローンチスポット、実際のスクリーンショットからのウォークスルー、またはサイト向けのペインポイントビデオで、ドロップカットからリビールへ)には /kai-motion-spot を使用してください。このスキルは Remotion テンプレート制作をカバーします。

目的

完成した動画:承認されたスクリプト、必要なアセット、同期されたオーディオ、プラットフォーム仕様に準拠したレンダリング済みMP4。そして project.json がディスク上のプロジェクトの実際の状態を記述しているため、次回のセッションは再構築なしで再開できます。

制作は優れたスクリプトを増幅しますが、悪いスクリプトを救うことはできません。スクリプトの品質は、アセットが生成される前に確定されます。スコープは3つに分割されます:スクリプトのみ(スクリプトで停止、ユーザーが録音)、自動制作(フルレンダリングパイプライン)、ハイブリッド(音声とスライドを生成、ユーザーがデモを提供)。

完了条件

ワークタイプ social-post — フロア E5/C2/O3(harness/eco-floors.yaml)、契約 harness/skill-contracts/social-post.yaml。有料クリエイティブとして実行されるレンダリングは、代わりに paid-ad-campaign(E5/C4/O4)に従い、クリエイティブが提出される前にプラットフォームポリシーリファレンスを読み込む必要があります。

  • E5 — 動画がターゲットプラットフォームで公開され、非アクターが承認されたカットに対してパーマリンクを読み上げた。out/ 内のMP4はE1。勝利バリアントと最終カットの人間による承認はE3。このスキルはレンダリングしますが、アップロードはしません。
  • C2 — スクリプトに対して banned_word_check と four_us_score(10/16)がクリーン、さらに以下の両方のレンダリングチェックリスト。
  • O3 — リーチ、エンゲージメント率、プロフィールクリック、リンククリックが、公開前に記録されたベースラインに対して7日後にプラットフォームインサイトから読み取られる。

レンダリング前: スクリプトが承認され、強力なフックがあり、AIスロップがない · すべてのアセットが存在し、欠落したデモや画像がない · シーンの長さがナレーションと一致 · 音声がビジュアルに合わせられている · ブランドカラー、フォント、ロゴが正しい · トランジションがスムーズ · テキストのコントラストとサイズが読みやすい · Remotion Studio でプレビューがウォークスルーされている。

レンダリング後: 解像度が指定通り · 音声が音楽の上で聞こえる · ファイルサイズがプラットフォーム制限以内 · フォーマットがターゲットプラットフォームで再生可能。

制約

  • バリアントラボからフルレンダリングに移行するには、人間の承認が必要です。 レンダリングには計算時間とコストがかかります。承認されていないコンセプトにはどちらも提供されません。

  • プリフライトバリアントラボは、アセット作成またはレンダリングの前に実行されます。 — 3つのフックバリアント(それぞれプラットフォーム、期待される最初のフレームのビジュアル、視聴者への約束を含む)、シーン順序またはペーシングのための2つの構造バリアント、キャンペーン目標に一致する2つのCTAバリアント、およびサポートされていないクレーム、ブランド不一致、承認ニーズをカバーするバリアントごとの1つのリスクノート。workspace/video/projects/{name}/PREFLIGHT-VARIANTS.md に書き込み、1つの勝者を選び、拒否されたバリアントを同じファイルにキルリストとして保持します。

    要素スコア質問
    フックの強さ1-5冒頭は即座に注意を引きますか?
    メッセージの明確さ1-5コアアイデアは一度見たら明らかですか?
    証拠の密度1-5クレームはデモ、引用、データ、またはソースによって裏付けられていますか?
    制作への適合性1-5利用可能なアセットとタイムラインで制作可能ですか?
    ブランドの安全性1-5偽の権威、リスクのあるクレーム、不明確な権利を回避していますか?
  • ユーザーに何かを尋ねる前に、プロジェクトルートから MARKETING.md を読んでください。 存在しない場合は、コードベース(CLAUDE.md、README.md、PROJECT.md、package.json、ランディングページ、メール/広告/アナリティクス設定)から、/kai-email-system のテンプレートを使用して構築し、ドラフトを確認してください。

  • 制作前にこれらを知っておくこと: トピック、プラットフォーム、形式(トーキングヘッド、スクリーンレコーディング、Bロール、アニメーション、スライド)、長さの帯、目標、ユーザーがスクリプトのみかフルレンダリングを望んでいるか。

  • ファイルシステムが信頼できる情報源です。 再開時には、プロジェクトディレクトリをスキャンし、project.json と比較し、ステータスを修正します — ファイルが存在する asset-needed は asset-present に、ファイルが欠落している ready は asset-missing になります。すべての不一致をユーザーに報告し、その周りでレンダリングしないでください。調整後、プロジェクトの CLAUDE.md ステータスドキュメントを再生成します。

  • ブランドプロファイルは自動適用されます。 色、フォント、ロゴは brands/{brand}/brand.json から取得され、音声設定は voice.json から取得されます。ブランドファイルが既に定義している色やフォントをインラインで再指定しないでください。

  • 前提条件は実際のブロッカーです: Node.js 18+(Remotion)と FFmpeg(エンコーディング)が必要です。クラウドAI機能には Modal アカウント(月額30ドルの無料コンピュート)または RunPod(秒単位の課金)が必要です。ElevenLabs はプレミアム音声用のオプションです。/video-setup が設定を処理します。ツールがこのインストールにデプロイされていない場合は、その旨を伝えてください — それが生成しなかった出力を決して説明しないでください。

  • 無料または安価なツールを優先します。 Qwen3-TTS と ACE-Step でほとんどの作業をカバーします。プレミアムプロバイダーは明示的な選択であり、デフォルトではありません。

  • 公開しません。 レンダリングは out/ に配置され、アップロードは別の承認されたステップです。

コンテキスト

必要なもの読み込み / 実行
動画コンテンツの仕組みknowledge/playbooks/video-content-creation.md
TikTok · YouTube · Reelsknowledge/channels/tiktok-algorithm.md · knowledge/channels/youtube.md · knowledge/channels/instagram.md
スライドシーンデザインの洗練knowledge/frameworks/design/frontend-design.md
製品、ICP、ボイス、チャンネルMARKETING.md(プロジェクトルート)
セットアップ、録画、オーディオ、レビュー、デザイン、クローン/video-setup · /record-demo · /generate-voiceover · /scene-review · /design · /voice-clone

テンプレート: product-demo(タイトル、問題、解決策、デモ、CTA) · explainer(タイトル、概要、セクション、まとめ) · demo-walkthrough(ナレーション付きスクリーンレコーディング) · social-short(15〜60秒縦型) · testimonial(引用 + ビジュアル) · announcement(ローンチ、リリース、ニュース)。リファレンス資料はそれらと一緒に配置されます — templates/product-demo/、templates/explainer/、templates/social-short/、そして examples/digital-samba-skill-demo/ と examples/schlumbergera/ の完成例には、それぞれソース、レンダリング済みMP4、制作ノートが含まれています。

プロジェクトレイアウト:

projects/{name}/
├── project.json          # 状態、シーン、アセット、セッション
├── VOICEOVER-SCRIPT.md   # 完全なナレーション
├── src/                  # Root.tsx、scenes/、config/(タイミング、ブランド、アセット)
├── public/               # audio/、demos/、images/、videos/
└── CLAUDE.md             # 自動生成ステータス

project.json は name、template、brand、created、updated、phase、scenes[] 配列(id、type、duration、visual、narration、status)、audio ブロック(voiceover: file/status/provider/speaker; music: file/status/preset)、estimates.totalDurationSeconds、および sessions[] ログ(日付、フェーズ、概要)を保持します。ライフサイクル: planning → assets → review → audio → editing → rendering → complete。

シーンタイプ: title · overview · demo · split-demo · problem · solution · feature · stats · testimonial · cta · credits。

アセット。 スライド(タイトルカード、箇条書き、統計可視化、CTA画面)はブランドプロファイルから生成されます。デモは /record-demo(Playwright ブラウザ録画、--script demo-script.md --auto でスクリプト化自動化)、public/demos/ にドロップされた外部MP4/MOV、または Playwright スクリーンショットから取得します。画像:生成には python tools/flux2.py --prompt "..." --cloud modal、編集には python tools/image_edit.py --input photo.jpg --style ...。

オーディオ。

python tools/voiceover.py --provider qwen3 --speaker Ryan --script VOICEOVER-SCRIPT.md --scene-dir public/audio/scenes --json
python tools/voiceover.py --provider elevenlabs --voice-id {ID} --script VOICEOVER-SCRIPT.md
python tools/music_gen.py --preset corporate-bg --duration 120 --bpm 90 --key "D Minor"
python tools/music.py --prompt "Upbeat corporate" --duration 120
python tools/sfx.py --preset whoosh   # 他: pop, success

Qwen3 スピーカー: Ryan, Brad, Ava, Lily, Emily, Sam, Alex, Kevin, Zoe。音楽プリセット: corporate-bg, upbeat-intro, dramatic-reveal, ambient-subtle, tension-build, inspirational-montage, tech-minimal, celebration-end。/voice-clone でカスタムブランドボイスを生成します。

ブランドファイル。 brand.json:colors(KaiCalls の例では primary #3B82F6、secondary #10B981、background #111827、text #F9FAFB)、fonts.heading / fonts.body(ファミリー + ウェイト)、logo、style。voice.json:provider、speaker、tone、pace、および elevenlabs ブロック(voice_id、stability、similarity_boost)。

トランジション — 7つのカスタムと4つのRemotion公式、@/lib/transitions からインポート:

トランジション効果使用例
glitch()デジタル歪み + RGBシフトテック美学
rgbSplit()色収差エネルギッシュなカット
zoomBlur()ラジアルモーションブラードラマチックなリビール
lightLeak()シネマティックレンズフレアプロフェッショナルな仕上げ
clockWipe()ラジアルスイープリビール時間ベースのコンテンツ
pixelate()デジタルモザイクレトロ/8ビット
checkerboard()グリッドリビール(9パターン)クリーンで幾何学的
slide() fade() wipe() flip()公式Remotion標準、微妙、方向性、遊び心

レビューとレンダリング。

cd projects/{name} && npm run studio     # Remotion Studio → localhost:3000
npm run render -- --quality=low          # プレビュー
npm run render                           # 最終 → out/{name}.mp4

レンダリングオプション: --codec=h264(デフォルト)または h265(より小さい) · --resolution=1080p(デフォルト)または 720p · --fps=30(デフォルト)または 60。タイミング調整は config.ts にあります。

ポストプロダクション: tools/addmusic.py(既存のMP4に音楽を追加) · tools/redub.py(音声を差し替え) · tools/dewatermark.py --preset sora --cloud modal · tools/upscale.py --scale 2x --cloud modal。

クラウドGPU。 Modal は /video-setup 経由でデプロイされます: qwen3_tts(約$0.01/動画)、flux2(約$0.02/画像)、music_gen(約$0.05/トラック)、sadtalker(約$0.10/動画)、ltx2(約$0.23/クリップ)、image_edit(約$0.03/画像)、upscale(約$0.01/画像)、dewatermark(約$0.10/動画)。RunPod は秒単位の代替手段です(ツールごとに python tools/<tool>.py --setup)。60〜90秒の動画の総コストは約$0.20 — スクリプト ~$0.10、Qwen3 音声 ~$0.01、ACE-Step 音楽 ~$0.05、FLUX.2 画像 ~$0.04、ローカル Remotion レンダリング $0.00。プレミアム追加: ElevenLabs 音声 +$0.30、LTX-2 クリップ +$0.23、SadTalker +$0.10。Modal のスターター無料ティアは月100本以上の動画をカバーします。

出力 は workspace/video/ に配置されます: _video-projects.md(インデックス)、projects/{name}/(out/{name}.mp4 を含む)、scripts/ は tiktok/、youtube/、reels/ に分割、および _production-guide.md。

エントリポイント: /kai-video script --platform tiktok --topic "..."(スクリプトのみ) · /kai-video produce --template product-demo --brand kaicalls(フルパイプライン) · /kai-video resume {name}。下流: クリップ用に /kai-repurpose、スケジューリング用に /kai-social、リリースタイミング用に /kai-content-calendar、パフォーマンス用に /kai-analytics。

一般的な障害: 「アセットが見つかりません」 — project.json のパスがファイルシステムと矛盾している、調整してください · 「オーディオが同期していない」 — config.ts のタイミングを調整するか、現在のスクリプトに対して音声を再生成します · 「レンダリングに失敗する」 — ffmpeg -version を確認し、アセットが存在することを確認し、最初に低品質プレビューを実行します · 「Modal でツールがタイムアウト」 — コンピュートクレジットと modal app list を確認するか、RunPod にフォールバックします · 「ブランドカラーが適用されていない」 — brand.json が brands/ にない、project.json でブランド名が一致しない、または src/config/brand.ts の再生成が必要です。

エスカレーション条件

  • バリアントラボの勝者が承認されておらず、次のステップでレンダリングまたはGPUコンピュートが消費される可能性がある場合。
  • デモ映像に顧客データ、サードパーティUI、または権利が確認されていないものが含まれている場合。
  • ナレーション内のクレームにソースのない数字が必要な場合。
  • 調整により、プロジェクトが予期していなかったアセット、または消えてしまった予期されていたアセットが見つかった場合。
  • 前提条件が不足している(Node 18+、FFmpeg、デプロイされたクラウドツールがない)にもかかわらず、ユーザーがレンダリングファイルを期待している場合。
  • 動画が有料配置向けである場合 — 提出前にプラットフォームポリシーリファレンスと paid-ad-campaign フロアが適用されます。

Individual skills in this repo

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

関連スキル