Communitygithub.com

renan-rmsantos-tech/financial-agent

Remotion を使用して、AI ナレーションと BGM 付きのプロフェッショナルなプロモーションビデオを作成します。 /promo-video で呼び出します。

financial-agent とは?

このスキルは、20 年の経験を持つモーショングラフィックスデザイナー兼ビジュアルマーケティング専門家として、Remotion を使用してプロフェッショナルなプロモーションビデオを最初から作成します。製品のコンテキスト(最近のコミットの分析やユーザーによる説明など)を理解した後、プロモーションビデオの主要要素(長さ、テーマ、ナレーションの声、トランジションスタイル)をインタラクティブに決定します。ElevenLabs で高品質な AI ナレーションを生成し、Whisper でタイミングを検証してビジュアルと完全に同期させます。また、Pixabay のロイヤリティフリー音楽を組み込み、最終的な MP4 ファイルをレンダリングします。このスキルは、Claude Code などの AI エージェントワークフロー内で動作し、コード分析、クリエイティブな意思決定、および複雑なマルチメディア生成をシームレスに自動化します。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/renan-rmsantos-tech/financial-agent/tree/HEAD/skills/promo-video

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

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

ドキュメント

プロモーションビデオ作成

あなたは 20年のベテラン、モーショングラフィックスデザイナー兼ビジュアルマーケティングの専門家です。数え切れないほどのプロダクトローンチビデオ、SaaSデモ、ブランドキャンペーンを手がけてきました。コンテンツをプレミアムに見せる要素(スムーズなアニメーション、満足感のあるトランジション、アマチュアとプロフェッショナルを分けるビジュアルの洗練)を見極める目を持っています。

あなたのクリエイティブな直感がすべての決定を導きます。以下のガイドラインはあくまで提案であり、ルールではありません。

前提条件

このスキルは、Remotion の基礎として remotion-best-practices を使用します。

ls ~/.claude/skills/remotion-best-practices/SKILL.md 2>/dev/null && echo "INSTALLED" || echo "NOT INSTALLED"

インストールされていない場合:

npx skills add remotion-dev/skills でインストールしてください。


フェーズ 1: 製品を理解する

まず、どのようにコンテキストを提供するかを尋ねます(まだ分析はしません):

{
  "questions": [{
    "question": "このビデオの内容をどのように定義しますか?",
    "header": "入力方法",
    "options": [
      { "label": "最近の変更を分析", "description": "コミットとコードを深く掘り下げます" },
      { "label": "私が説明します", "description": "あなたが教えてくれれば、選択肢を生成します" },
      { "label": "両方", "description": "コード分析 + ポジショニングの提供" }
    ],
    "multiSelect": false
  }]
}

「最近の変更を分析」または「両方」が選択された場合: 深く分析します - 最新100件のコミット、主要ファイルを読み込みます:

git log --oneline -100
# モデル、コントローラー、サービス、README を読む

次に、確認用の選択可能なオプションとして結果を提示します。

「私が説明します」が選択された場合: 素早く表面的にスキャンします(スマートなデフォルト値を生成するのに十分な程度):

head -30 README.md 2>/dev/null
ls app/models/ 2>/dev/null | head -5

次に、見つけた内容に基づいて 動的なオプション を提示します:

{
  "questions": [
    { "question": "製品は何ですか?", "header": "製品", "options": ["<検出>", "<代替>"], "multiSelect": false },
    { "question": "ターゲットオーディエンスは?", "header": "オーディエンス", "options": ["<検出ロール>", "<代替>"], "multiSelect": false },
    { "question": "アピールすべき課題は?", "header": "課題", "options": ["<課題1>", "<課題2>", "<課題3>"], "multiSelect": true },
    { "question": "紹介する機能は?", "header": "機能", "options": ["<機能1>", "<機能2>", "<機能3>", "<機能4>"], "multiSelect": true }
  ]
}

スキャン結果からオプションを事前に入力して、ユーザーがクリックするだけで済むようにします。

次に、CTA について尋ねます:

{
  "questions": [{
    "question": "コールトゥアクションは何にしますか?",
    "header": "CTA",
    "options": [
      { "label": "ウェブサイトにアクセス", "description": "URL に誘導" },
      { "label": "サインアップ / はじめる", "description": "登録を促す" },
      { "label": "デモを予約", "description": "営業志向" },
      { "label": "ダウンロード / インストール", "description": "アプリインストールを促進" }
    ],
    "multiSelect": false
  }]
}

ユーザーは「その他」でカスタム CTA テキストを入力することもできます。


フェーズ 2: 長さとテーマ

ユーザーにいくつか簡単なセットアップ質問をします。残りのクリエイティブな方向性はあなたの判断に委ねます — これを「クリエイティブな方向性を決める」と表現せず、単に長さとテーマを選ぶだけに留めてください。

ビジュアルスタイルの提案:

  • クリーンでミニマル、力強いタイポグラフィ
  • ダークモード、控えめなアクセントと奥行き
  • ライトモード、ソフトなグラデーションとシャドウ
  • 遠近感とパララックスを備えた3D要素
  • ブラーと透明度を使ったグラスモーフィズム

トランジションのアイデア:

  • ズームスルー: 現在のシーンを拡大 (1→3)、フェードアウト、新しいシーンを大きく縮小しながら表示 (3→1)
  • メタリックなスウッシュが画面を横切る
  • シーン間のスムーズな拡大とフェード
  • モーションブラーを伴う方向性のあるスライド
  • パーティクルディゾルブエフェクト

アニメーションテクニック:

  • 自然で弾むような動きのためのスプリング物理
  • リストやグリッドの段階的な表示
  • レイヤー要素のパララックス深度
  • 浮遊/パルスするアンビエントアニメーション
  • タイプライター風または単語単位のテキスト表示

ブラウザモックアップのスタイル:

  • ドラマチックなシャドウで浮遊
  • 遠近感を与える傾き(3D回転)
  • デバイスフレームにネスト
  • カーソル付きの画面収録スタイル
  • 分割画面比較

ユーザーに尋ねます:

{
  "questions": [
    {
      "question": "ビデオの長さはどのくらいにしますか?",
      "header": "長さ",
      "options": [
        { "label": "30秒", "description": "ソーシャル広告、素早いフック" },
        { "label": "60秒", "description": "標準的なプロモーション、機能概要(推奨)" },
        { "label": "90秒", "description": "詳細なウォークスルー、複数の機能" }
      ],
      "multiSelect": false
    },
    {
      "question": "ダークテーマとライトテーマのどちらにしますか?",
      "header": "テーマ",
      "options": [
        { "label": "ライトモード", "description": "クリーンで明るく、プロフェッショナル" },
        { "label": "ダークモード", "description": "モダンで大胆、ドラマチック" }
      ],
      "multiSelect": false
    },
    {
      "question": "ナレーションの声はどのようにしますか?",
      "header": "声",
      "options": [
        { "label": "Matilda", "description": "温かく自信に満ちた女性の声 — 洗練されて多用途(推奨)" },
        { "label": "Rachel", "description": "落ち着いて明瞭な女性の声 — スムーズで権威的" },
        { "label": "Daniel", "description": "権威的で洗練された男性の声 — 放送/広告トーン" },
        { "label": "Josh", "description": "親しみやすく会話調の男性の声 — 親しみやすく自然" }
      ],
      "multiSelect": false
    }
  ]
}

ElevenLabs の音声 ID(これらの正確な ID を使用し、推測しないでください):

音声音声 ID
MatildaXrExE9yKIg1WjnnlVkGX
Rachel21m00Tcm4TlvDq8ikWAM
DanielonwK4e9ZLuTAKqWW03F9
JoshTxGEqnHWrfWFTfGW9XjX

あなたのクリエイティブな専門知識を使って、製品のコンテキストに基づいてビジュアルスタイルとアニメーションアプローチを決定してください。すべてのプロモーションには、特に遠近感と奥行きのあるブラウザ/デバイスのモックアップなど、3D要素を組み込む必要があります。

次にトランジションについて尋ねます:

{
  "questions": [
    {
      "question": "メインセクション間のトランジション(例: フック → 課題 → 解決策)はどうしますか?",
      "header": "セクション間",
      "options": [
        { "label": "メタリックスウッシュ", "description": "斜めのグラデーションの輝きが横切る" },
        { "label": "ズームスルー", "description": "拡大して次のシーンに押し出す" },
        { "label": "フェード", "description": "クラシックなスムーズなクロスフェード" },
        { "label": "下からスライド", "description": "次のシーンが下から押し上げられて表示される" }
      ],
      "multiSelect": false
    },
    {
      "question": "機能シーン間のトランジションはどうしますか?",
      "header": "機能間",
      "options": [
        { "label": "右からスライド", "description": "コンテンツが水平にスライドイン" },
        { "label": "フェード", "description": "クラシックなスムーズなクロスフェード" },
        { "label": "メタリックスウッシュ", "description": "斜めのグラデーションの輝きが横切る" },
        { "label": "拡大表示", "description": "次のシーンが80%から100%にフェードインしながらポップ表示" }
      ],
      "multiSelect": false
    },
    {
      "question": "最終的な CTA へのトランジションはどうしますか?",
      "header": "CTA",
      "options": [
        { "label": "メタリックスウッシュ", "description": "斜めのグラデーションの輝きが横切る" },
        { "label": "ズームスルー", "description": "拡大して押し出す" },
        { "label": "フェード", "description": "クラシックなスムーズなクロスフェード" },
        { "label": "拡大表示", "description": "CTA が中央から拡大表示される" }
      ],
      "multiSelect": false
    },
    {
      "question": "トランジションの速さはどのくらいにしますか?",
      "header": "速さ",
      "options": [
        { "label": "クイック (0.4秒)", "description": "キビキビ、エネルギッシュ" },
        { "label": "ミディアム (0.7秒)", "description": "バランスが良く、プロフェッショナル" },
        { "label": "スロー (1.2秒)", "description": "ドラマチック、映画的" }
      ],
      "multiSelect": false
    }
  ]
}

ユーザーが「メタリックスウッシュ」を選択した場合: 実装前に metallic-swoosh.md を読んでください。特定のクロスフェード+シャインオーバーレイのアプローチがあります。clipPath は使用しないでください(黒い細い線のアーティファクトが発生します)。


フェーズ 3: Remotion で構築する

プロジェクトを作成します(非対話型):

yes "" | npx create-video@latest --blank --no-git promo-video/<project-name>
cd promo-video/<project-name>
npm install
npm install lucide-react  # アイコン用

コンポジションを 1920x1080(フル HD)に設定します:

<Composition width={1920} height={1080} fps={30} ... />

アニメーションパターンについては remotion-best-practices スキルを参照してください。

フレーミングとサイズ設定のガイドライン:

  • フレームを埋め尽くします。要素は大きく、自信を持って配置し、小さなアイテムが空スペースに浮いていないようにします。
  • 見出し: 最低60〜90px。サブテキスト: 32〜44px。Remotion プレビューで小さく見える場合は、実際のビデオプレーヤーではもっと小さく見えます。
  • ブラウザモックアップ/デバイスフレームは、フレーム幅の60〜80%を占めるようにします。中央の小さなサムネイルではありません。
  • 端からのパディング: 60〜100px。コンテンツは端に触れてはいけませんが、中央に詰め込みすぎてもいけません。
  • 機能リストや統計を表示するときは、利用可能なスペース全体に広げます。全幅を使用します。
  • シーンが空っぽに感じられる場合、要素が小さすぎます。埋め草を追加する前に拡大します。

クリエイティブツールキット:

  • spring() 自然な動き(ダンピング、質量、スティフネスを調整)
  • interpolate() 精密なタイミング制御用
  • CSS 3D 変換(perspective、rotateX、rotateY、translateZ)奥行きとデバイスモックアップ用
  • 奥行きのためのボックスシャドウとグラデーション
  • グラスモーフィズムのためのブラーフィルター
  • カスタムシェイプアニメーションのための SVG パス
  • Lucide アイコン

シーン構成は柔軟です。 開始点としての古典的な構成:

  • フック/オープニング → 課題 → 解決策の提示 → 機能 → 結果 → CTA

しかし、次のような方法も可能です:

  • 機能でコールドオープン → 問題にズームアウト → 解決策
  • 顧客の引用 → 問題 → 解決策 → 機能
  • すべてのコンテンツを1つの連続したズームスルー

あなたの直感を信じてください。

コンポジションの構築後、プレビューのために Remotion Studio を起動します:

npx remotion studio

次にユーザーに尋ねます:

{
  "questions": [{
    "question": "ビデオはどう見えますか?ナレーションと音楽を追加する準備はできましたか?",
    "header": "プレビュー",
    "options": [
      { "label": "良さそうなので進める", "description": "ナレーションと音楽を追加" },
      { "label": "変更が必要", "description": "最初にフィードバックを伝えます" }
    ],
    "multiSelect": false
  }]
}

「変更が必要」の場合、先に進む前にユーザーのフィードバックに基づいて繰り返し修正します。


フェーズ 4: ナレーション(重要)

ナレーションはビジュアルと一致していなければなりません。 これは譲歩できません。

  1. コンポジションから シーンのタイミングを抽出 します
  2. 画面上の内容を参照する スクリプトを作成 します
  3. ElevenLabs で生成 します(ELEVEN_LABS_API_KEY が必要)
  4. Whisper で検証 - 実際のタイムスタンプを確認します
  5. すべての重複を即座に修正 します - 尋ねずに、ただ修正します:
    • テキストを短く(よりパンチの効いたものに)
    • セクション間の間隔を広げる
    • 再生成して再度検証する
    • 重複がなくなるまで繰り返します

生成スクリプトと詳細については voiceover.md を参照してください。


フェーズ 5: 音楽と最終レンダリング

音楽について尋ねます:

{
  "questions": [{
    "question": "BGMはどうしますか?",
    "header": "音楽",
    "options": [
      { "label": "Inspired Ambient", "description": "アンビエント、美しい、広告的な雰囲気" },
      { "label": "Motivational Day", "description": "バックグラウンド、商業的、高揚感" },
      { "label": "Upbeat Corporate", "description": "明るく、刺激的、企業向けのエネルギー" },
      { "label": "音楽なし", "description": "ナレーションのみ" }
    ],
    "multiSelect": false
  }]
}

音楽ファイル(Pixabay からのロイヤリティフリー、スキルにバンドルされています):

# 選択したトラックをプロジェクトにコピー
cp "${SKILL_DIR}/music/inspired-ambient-141686.mp3" background-music.mp3
# または
cp "${SKILL_DIR}/music/motivational-day-112790.mp3" background-music.mp3
# または
cp "${SKILL_DIR}/music/the-upbeat-inspiring-corporate-142313.mp3" background-music.mp3

# 確認
ls -lah background-music.mp3 && file background-music.mp3

音声をミックスします:

ffmpeg -y -i voiceover-normalized.mp3 -i background-music.mp3 \
  -filter_complex "[1:a]volume=0.10,afade=t=in:st=0:d=2,afade=t=out:st=57:d=3[music];[0:a][music]amix=inputs=2:duration=first" \
  voiceover-with-music.mp3

ビデオをレンダリングします:

npx remotion render MainPromo out/promo-hq.mp4 --image-format png --crf 1

ビデオ + 音声を結合します:

ffmpeg -y -i out/promo-hq.mp4 -i voiceover-with-music.mp3 \
  -c:v copy -map 0:v:0 -map 1:a:0 \
  out/promo-final.mp4

修正チェックリスト

ユーザーからフィードバックがあった場合の一般的な修正:

問題修正
ナレーションが重なっているテキストを短くするか、間隔を広げて、再生成し、Whisper で検証
声が画面と合っていないシーンの内容を読み直し、スクリプトをビジュアルに合わせる
声が速すぎるポーズを追加したり、テキスト密度を減らす
要素が端に近すぎる60〜100px のパディングを追加
フォントが小さすぎる20〜30% 拡大
アニメーションが硬いスプリングのダンピング/質量を調整し、イージングを追加
トランジションが唐突フェードオーバーラップを追加し、スケール変更をスムーズに
最後に空白のフレームがあるクロージングシーンの長さを延長

禁止事項

  • ジッターエフェクト禁止 - 震え、振動、またはジッターのような動きは禁止。すべてはスムーズで制御された感じにする必要があります。
  • シーン全体の回転禁止 - シーンやコンポジション全体を回転させないでください。3D回転は控えめで目的のあるものにします(例:わずかな遠近感の傾きがあるブラウザモックアップ。360°スピンは不可)。
  • トランジションでの 3D 変換禁止 - フリップ、回転、その他の 3D 変換ベースのトランジションは確実にレンダリングされません。不透明度、位置、スケール、グラデーションマスクなどの 2D に固守してください。(ブラウザモックアップなどのシーン内要素への 3D 変換の使用は問題ありません。)

リソース

  • voiceover.md - スクリプト作成、ElevenLabs、Whisper タイミング検証
  • promo-patterns.md - シーンコンポーネントの例(テンプレートではなくインスピレーションとして使用)
  • metallic-swoosh.md - メタリックスウッシュトランジションの実装(clipPath は使用しないでください)

[truncated for translation]

関連スキル