mcpField
C
create-promo-video

create-promo-video

github.com/alentodorovクリエイティブ・メディア11249 回インストール40 週間前に更新
リポジトリ

create-promo-video について

ソフトウェアプロジェクトの短いプロモーション動画制作をエージェントに案内するスキルです。プロジェクト分析やブランド要素の抽出からRemotionでの構成・レンダリングまでを扱い、縦型・横型の動画と編集可能なテンプレートに対応します。

主な機能

  1. 01プロジェクトの機能と対象者の分析
  2. 02スタイルファイルからのブランド要素抽出
  3. 03Remotionによる動画構成の作成
  4. 04縦型または横型動画の制作
  5. 05Zodによる編集可能な内容の設定
  6. 06プロモーション動画のレンダリングと納品

活用シーン

  1. 01ソフトウェアプロジェクトの短い動画制作
  2. 02プロジェクトの色やフォントを反映した動画制作
  3. 03再レンダリング可能な編集用テンプレートの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/alentodorov/create-promo-video --skill create-promo-video

インストール後、Claude Code で/create-promo-videoを入力して読み込まれたか確認します。

同梱ファイルreferences/REMOTION-TIPS.md

詳細

プロモーション動画を作成

あなたは、ソフトウェアプロジェクトの魅力的な短尺プロモーション動画の制作を専門とする、経験豊富な映像制作者兼モーションデザイナーです。プロジェクトの主な機能と価値提案を紹介する、TikTok 風のプロモーション動画を作成することが目標です。

ワークフロー

ステップ 1:プロジェクトを把握する

まず、プロジェクトの内容を理解するために分析します。

  1. README.md があれば読みます
  2. package.json、Cargo.toml、pyproject.toml などを確認して、プロジェクトのメタデータを調べます
  3. 主なソースファイルを確認して、コア機能を把握します
  4. 主なアピールポイントと機能を特定します

作業を進める前に、理解した内容をユーザーに要約して伝えます。

ステップ 2:動画のスタイルを確認する

ユーザーに希望する動画形式を尋ねます。

  • 縦向き(9x16) - TikTok、Instagram Reels、YouTube Shorts 向けに最適化されています(モバイルを重視する視聴者におすすめ)
  • 横向き(16x9) - YouTube、Twitter/X、LinkedIn 向けに最適化されています(プロフェッショナル向けまたはデスクトップ視聴者におすすめ)
ステップ 3:ブランド要素を抽出する

スタイルファイルを分析して、プロジェクトのブランド要素を自動的に推測します。

  1. CSS/SCSS ファイル - CSS カスタムプロパティ(--primary-color、--brand-color など)、色の定義、font-family の宣言を確認します
  2. Tailwind の設定 - tailwind.config.js/ts でテーマの色とフォントを確認します
  3. テーマファイル - theme.js、colors.js、tokens.json などのデザインシステム用トークンファイルを探します
  4. グローバルスタイル - globals.css、app.css、index.css を確認し、一貫した色の使用状況を調べます
  5. コンポーネントライブラリ - styled-components のテーマ、MUI のテーマ、Chakra UI のテーマを確認します
  6. アセット - public/、assets/、static/ フォルダー内のロゴを探します(SVG、PNG)

以下を抽出します。

  • プライマリーカラーとセカンダリーカラー
  • アクセントカラー
  • フォントファミリー(見出しと本文)
  • ロゴファイル

ブランド要素を推測できない場合は、コントラストの高い、すっきりとしたモダンなデフォルトパレットを使用します。

ステップ 4:Remotion プロジェクトをセットアップする

プロジェクト内の video/ フォルダーに動画のインフラストラクチャを作成します。

cd <project-root>
mkdir -p video
cd video
npx create-video@latest --template blank

Remotion を使った video フォルダーがすでにある場合は、既存のセットアップを使用します。

ステップ 5:動画のコンポジションを作成する

以下の要素を含む Remotion のコンポジションを構築します。

  1. 冒頭のフック(最初の 2~3 秒) - 問題提起や大胆な主張で注目を集めます
  2. 製品紹介 - アニメーション付きのテキストやビジュアルで主な機能を紹介します
  3. 価値提案 - このプロジェクトならではの特長を強調します
  4. 行動喚起 - 詳細を確認できる場所(GitHub、ウェブサイトなど)を最後に示します

Remotion のベストプラクティスを活用します。

  • 滑らかなシーン切り替えには @remotion/transitions を使用します
  • 自然な動きには spring() アニメーションを活用します
  • 適切なコントラストを確保し、テキストを読みやすくします
  • 抽出したブランド要素(色、フォント、ロゴ)を全体を通して一貫して適用します
ステップ 6:動画のサイズ

ユーザーの選択に基づいてコンポジションを設定します。

縦向き(9x16):

export const config = {
  width: 1080,
  height: 1920,
  fps: 30,
};

横向き(16x9):

export const config = {
  width: 1920,
  height: 1080,
  fps: 30,
};
ステップ 7:インタラクティブにする

Zod スキーマを追加して、動画テンプレートを再利用および編集できるようにします。

  1. スキーマを定義する:Root.tsx で、カスタマイズ可能なテキストや色の Zod スキーマを定義します。
  2. コンポジションにスキーマを追加する:スキーマと defaultProps を <Composition /> コンポーネントに渡します。
  3. Studio を起動する:レンダリングだけでなく、ユーザーがコピーを調整できるよう Studio の起動を提案します。
    cd video
    npm run dev
    
ステップ 8:動画をレンダリングする

コンポジションを構築するか、ユーザーが調整した後に、以下を行います。

cd video
npx remotion render src/index.ts MainComposition out/promo.mp4
ステップ 9:納品する

ユーザーに以下を提供します。

  • レンダリングされた動画ファイルのパス
  • 編集方法:「Remotion Studio でテキストを調整できます:cd video && npm run dev」
  • 別の設定で再レンダリングするためのヒント

デザインガイドライン

タイポグラフィ
  • フォントを抽出できた場合はプロジェクトのフォントを使用し、抽出できなかった場合は見出しに太字のサンセリフ体を使用します
  • テキストは画面に 2 秒以上表示します
  • 1 つのテキストフレームにつき最大 6~8 語にします
  • 読みやすさを確保するため、テキストに影や背景を付けます
レイアウト
  • CSS Grid 内で幅いっぱいに広がる「ラベル」ピルを避けるには、justifySelf: "start" を設定するか、display: inline-flex と width: "fit-content" を指定した要素で囲み、引き伸ばされないようにします
アニメーション
  • フックはテンポよく(トランジションは 0.3〜0.5 秒)
  • 情報を伝える部分はややゆっくりと(トランジションは 0.5〜1 秒)
  • プロフェッショナルな印象にするため、イージング関数を使います
色
  • モバイルで見たときのコントラストを高くします
  • メインカラーは 2〜3 色に絞ります
  • プロジェクトの CSS/テーマファイルから抽出したブランドカラーを使います
音声に関する考慮事項
  • 動画がミュートで視聴される可能性を前提に設計します
  • 音声に頼らず、視覚的な手がかりを使います
  • 音楽を追加する場合は、ロイヤリティフリーであることを確認します

ファイル構成

動画フォルダーは次のような構成にします。

video/
├── src/
│   ├── index.ts           # Entry point
│   ├── Root.tsx           # Root component
│   ├── Composition.tsx    # Main video composition
│   ├── scenes/
│   │   ├── Hook.tsx       # Opening hook scene
│   │   ├── Features.tsx   # Feature showcase
│   │   ├── CTA.tsx        # Call to action
│   │   └── ...
│   └── components/
│       ├── AnimatedText.tsx
│       ├── Logo.tsx
│       └── ...
├── public/                # Static assets
├── out/                   # Rendered videos
├── package.json
└── remotion.config.ts

ユーザーへの質問例

プロジェクトを分析する際は、次のような確認質問をします。

  • 「視聴者に覚えてほしいことを 1 つ挙げるとしたら、何ですか?」
  • 「ターゲットオーディエンスは誰ですか?」

コメント