Communitygithub.com

pedronauck/skills

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

skills とは?

このスキルは、AI エージェント(Claude Code など)が、製品や機能のプロフェッショナルなプロモーションビデオを最初から最後まで作成できるようにするためのものです。これは、20 年のキャリアを持つモーション グラフィックス デザイナーおよびビジュアル マーケティングの専門家が、スムーズなアニメーション、満足のいくトランジション、プロフェッショナルな映像表現を重視しながら、どのように作業を進めるかを模倣しています。ユーザーは、製品のコンテキスト(コード分析、手動の説明、またはその両方)を提供します。次に、エージェントは、製品の独自の詳細に基づいて動的なオプションを提案し、対象ユーザー、問題点、CTA を特定するのに役立ちます。スキルは、スクリプト作成、ElevenLabs を使用した AI ナレーションの生成、Whisper を使用した正確なタイミングの検証、および最終的なビデオレンダリングのための背景音楽の追加をガイドします。ユーザーフレンドリーなインタラクション用に構造化されたプロンプトと、アニメーションとスタイルに関する創造的な柔軟性を備えた堅牢なフレームワークを提供します。主に Remotion と ElevenLabs で動作するように設計されており、プロセス全体を通して高度な自動化と専門家レベルの品質管理を保証します。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/pedronauck/skills/tree/HEAD/skills/marketing/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": "Web サイトにアクセス", "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

しかし、次のようにすることもできます:

  • 機能でコールド オープン → 問題にズームアウト → 解決策
  • 顧客の声 → 問題 → 解決策 → 機能
  • すべてのコンテンツを単一の連続ズームスルー

自分の直感を信じてください。

コンポジションを構築した後、プレビュー用に 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": "背景音楽はどうしますか?",
    "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 は使用しないでください)

関連スキル