Communitygithub.com

randall-liao/cloud-resume-v2

Remotion を使用して、Stitch プロジェクトからスムーズなトランジション、ズーム、テキストオーバーレイを備えたウォークスルー動画を生成します。

cloud-resume-v2 とは?

このスキルは、Stitch の画面取得機能と Remotion のプログラムによる動画生成を組み合わせ、アプリデザインからプロフェッショナルなウォークスルー動画を作成するためのものです。Stitch プロジェクトのスクリーンショットをダウンロードし、Remotion で構成することで、フェードやスライドなどのトランジション効果、ズームアニメーション、コンテキストに応じたテキストオーバーレイを施した動画を生成します。対応プラットフォームは Stitch MCP サーバーと Remotion MCP サーバー(または Remotion CLI)で、Node.js 環境で動作します。開発者は、指定された手順に従ってアセットを整理し、Remotion コンポーネント(ScreenSlide.tsx や WalkthroughComposition.tsx)を作成して、最終的に MP4 や WebM 形式で動画をレンダリングできます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/randall-liao/cloud-resume-v2/tree/HEAD/.agent/skills/remotion

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

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

ドキュメント

Stitch から Remotion へのウォークスルー動画生成

あなたは、アプリデザインから魅力的なウォークスルー動画を作成することに特化した動画制作スペシャリストです。Stitch の画面取得機能と Remotion のプログラムによる動画生成を組み合わせ、スムーズでプロフェッショナルなプレゼンテーションを実現します。

概要

このスキルを使用すると、プロフェッショナルなトランジション、ズーム効果、コンテキストに応じたテキストオーバーレイを備えたウォークスルー動画を作成できます。ワークフローは、Stitch プロジェクトから画面を取得し、それらを Remotion 動画構成に orchestration します。

前提条件

必須:

  • Stitch MCP サーバーへのアクセス
  • Remotion MCP サーバー(または Remotion CLI)へのアクセス
  • Node.js と npm のインストール
  • デザイン済み画面を持つ Stitch プロジェクト

推奨:

  • Remotion の動画機能に関する知識
  • React コンポーネントの理解(Remotion は React を使用)

取得とネットワーキング

ステップ 1: 利用可能な MCP サーバーを確認

list_tools を実行して、利用可能な MCP サーバーとそのプレフィックスを特定します。

  • Stitch MCP: stitch: または mcp_stitch: プレフィックスを探す
  • Remotion MCP: remotion: または mcp_remotion: プレフィックスを探す

ステップ 2: Stitch プロジェクト情報を取得

  1. プロジェクト検索(プロジェクト ID が提供されていない場合):

    • [stitch_prefix]:list_projects を filter: "view=owned" で呼び出す
    • タイトル(例:「Calculator App」)で対象プロジェクトを特定する
    • name フィールドからプロジェクト ID を抽出する(例:projects/13534454087919359824)
  2. 画面取得:

    • [stitch_prefix]:list_screens をプロジェクト ID(数値のみ)で呼び出す
    • 画面タイトルを確認し、ウォークスルーに含めるすべての画面を特定する
    • 各画面の name フィールドから画面 ID を抽出する
  3. 画面メタデータの取得: 各画面に対して:

    • [stitch_prefix]:get_screen を projectId と screenId で呼び出す
    • 以下を取得:
      • screenshot.downloadUrl — 動画用のビジュアルアセット
      • htmlCode.downloadUrl — テキスト/コンテンツ抽出用(オプション)
      • width, height — 適切なスケーリングのための画面サイズ
      • 画面タイトルと説明(テキストオーバーレイ用)
  4. アセットのダウンロード:

    • web_fetch または curl を使用した Bash でスクリーンショットをダウンロード
    • ステージングディレクトリに保存: assets/screens/{screen-name}.png
    • 意図したウォークスルーの流れに従ってアセットを整理

ステップ 3: Remotion プロジェクトをセットアップ

  1. 既存の Remotion プロジェクトを確認:

    • remotion.config.ts または Remotion 依存関係を含む package.json を探す
    • 存在する場合は、既存のプロジェクト構造を使用
  2. 新しい Remotion プロジェクトを作成(必要な場合):

    npm create video@latest -- --blank
    
    • TypeScript テンプレートを選択
    • 専用の video/ ディレクトリにセットアップ
  3. 依存関係をインストール:

    cd video
    npm install @remotion/transitions @remotion/animated-emoji
    

動画構成戦略

アーキテクチャ

以下のコンポーネントでモジュラーな Remotion 構成を作成します:

  1. ScreenSlide.tsx — 個別画面表示コンポーネント

    • プロパティ: imageSrc, title, description, width, height
    • 機能: ズームインアニメーション、フェードトランジション
    • 時間: 設定可能(デフォルトでは画面あたり 3~5 秒)
  2. WalkthroughComposition.tsx — メイン動画構成

    • 複数の ScreenSlide コンポーネントをシーケンス化
    • 画面間のトランジションを処理
    • テキストオーバーレイと注釈を追加
  3. config.ts — 動画設定

    • フレームレート(デフォルト: 30 fps)
    • 動画サイズ(Stitch 画面サイズに合わせるか、適切にスケーリング)
    • 合計時間の計算

トランジション効果

Remotion の @remotion/transitions をプロフェッショナルな効果に使用:

  • フェード: 画面間のスムーズなクロスフェード

    import {fade} from '@remotion/transitions/fade';
    
  • スライド: 方向性のあるスライドトランジション

    import {slide} from '@remotion/transitions/slide';
    
  • ズーム: 強調のためのズームイン/アウト効果

    • スムーズなズームに spring() アニメーションを使用
    • 重要な UI 要素に適用

テキストオーバーレイ

Remotion のテキストレンダリングを使用してコンテキスト情報を追加:

  1. 画面タイトル: 各フレームの上部または下部に表示
  2. フィーチャーコールアウト: アニメーション付きポインターで特定の UI 要素を強調
  3. 説明: 各画面の説明テキストをフェードイン
  4. 進行状況インジケーター: ウォークスルー内の現在の画面位置を表示

実行手順

ステップ 1: 画面アセットを収集

  1. 対象の Stitch プロジェクトを特定
  2. プロジェクト内のすべての画面を一覧
  3. 各画面のスクリーンショットをダウンロード
  4. ウォークスルーの流れに沿って整理
  5. マニフェストファイル(screens.json)を作成:
{
  "projectName": "Calculator App",
  "screens": [
    {
      "id": "1",
      "title": "Home Screen",
      "description": "Main calculator interface with number pad",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "History View",
      "description": "View of previous calculations",
      "imagePath": "assets/screens/history.png",
      "width": 1200,
      "height": 800,
      "duration": 3
    }
  ]
}

ステップ 2: Remotion コンポーネントを生成

Remotion のベストプラクティスに従って動画コンポーネントを作成:

  1. ScreenSlide.tsx を作成:

    • アニメーションに useCurrentFrame() と spring() を使用
    • ズーム効果とフェード効果を実装
    • 適切なタイミングでテキストオーバーレイを追加
  2. WalkthroughComposition.tsx を作成:

    • 画面マニフェストをインポート
    • <Sequence> コンポーネントで画面をシーケンス化
    • 画面間にトランジションを適用
    • 適切なタイミングとオフセットを計算
  3. remotion.config.ts を更新:

    • 構成 ID を設定
    • 動画サイズを設定
    • フレームレートと時間を設定

参考リソース:

  • 開始点として resources/screen-slide-template.tsx を使用
  • 完全性のために resources/composition-checklist.md を参照
  • examples/ ディレクトリ内の例を確認

ステップ 3: プレビューと調整

  1. Remotion Studio を起動:

    npm run dev
    
    • ブラウザベースのプレビューが開く
    • リアルタイムでの編集と調整が可能
  2. タイミングを調整:

    • 各画面に適切な表示時間が設定されていることを確認
    • トランジションがスムーズであることを確認
    • テキストオーバーレイのタイミングをチェック
  3. アニメーションを微調整:

    • ズーム効果の spring 設定を調整
    • トランジションのイージング関数を変更
    • テキストが常に読みやすいことを確認

ステップ 4: 動画をレンダリング

  1. Remotion CLI を使用してレンダリング:

    npx remotion render WalkthroughComposition output.mp4
    
  2. 代替案: Remotion MCP を使用(利用可能な場合):

    • [remotion_prefix]:render を構成の詳細とともに呼び出す
    • 出力形式を指定(MP4, WebM など)
  3. 最適化オプション:

    • 品質レベルを設定(--quality)
    • コーデックを設定(--codec h264 または h265)
    • 並列レンダリングを有効化(--concurrency)

高度な機能

インタラクティブホットスポット

クリック可能な要素や重要な機能を強調:

import {interpolate, useCurrentFrame} from 'remotion';

const Hotspot = ({x, y, label}) => {
  const frame = useCurrentFrame();
  const scale = spring({
    frame,
    fps: 30,
    config: {damping: 10, stiffness: 100}
  });
  
  return (
    <div style={{
      position: 'absolute',
      left: x,
      top: y,
      transform: `scale(${scale})`
    }}>
      <div className="pulse-ring" />
      <span>{label}</span>
    </div>
  );
};

ナレーションの統合

ウォークスルーにナレーションを追加:

  1. 画面の説明からナレーションスクリプトを生成
  2. テキスト読み上げを使用するか、音声を録音
  3. <Audio> コンポーネントで音声を Remotion にインポート
  4. 画面のタイミングをナレーションのペースに合わせる

動的テキスト抽出

自動注釈のために、Stitch HTML コードからテキストを抽出:

  1. 各画面の htmlCode.downloadUrl をダウンロード
  2. HTML を解析して主要なテキスト要素(見出し、ボタン、ラベル)を抽出
  3. 重要な UI 要素の自動コールアウトを生成
  4. タイミング付きテキストオーバーレイとして構成に追加

ファイル構造

project/
├── video/                      # Remotion プロジェクトディレクトリ
│   ├── src/
│   │   ├── WalkthroughComposition.tsx
│   │   ├── ScreenSlide.tsx
│   │   ├── components/
│   │   │   ├── Hotspot.tsx
│   │   │   └── TextOverlay.tsx
│   │   └── Root.tsx
│   ├── public/
│   │   └── assets/
│   │       └── screens/        # ダウンロードした Stitch スクリーンショット
│   │           ├── home.png
│   │           └── history.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # 画面マニフェスト
└── output.mp4                  # レンダリング済み動画

Remotion スキルとの統合

Remotion はベストプラクティスを定義する独自の Agent Skills を維持しています。高度なテクニックについてはこれらを参照してください:

活用すべき主要な Remotion スキル:

  • アニメーションのタイミングとイージング
  • 構成アーキテクチャパターン
  • パフォーマンス最適化
  • 音声同期

共通パターン

パターン 1: シンプルなスライドショー

フェードトランジションを使用した基本的なウォークスルー:

  • 画面あたり 3~5 秒
  • クロスフェードトランジション
  • 画面タイトル付き下部テキストオーバーレイ
  • 上部のプログレスバー

パターン 2: 機能の強調

特定の UI 要素に焦点を当てる:

  • 特定の領域にズームイン
  • 機能を指すアニメーション化された円/矢印
  • キーとなるインタラクションのスローモーション強調
  • ビフォー/アフターの比較表示

パターン 3: ユーザーフロー

ステップバイステップのユーザージャーニーを表示:

  • 方向性スライドを使用したシーケンシャルな画面フロー
  • 番号付きステップのオーバーレイ
  • ユーザーアクション(クリック、タップ)を強調
  • アニメーションパスで画面を接続

トラブルシューティング

問題解決策
ぼやけたスクリーンショットダウンロードした画像がフル解像度であることを確認; screenshot.downloadUrl の品質設定を確認
テキストの位置ずれ画面サイズが構成サイズと一致していることを確認; 実際の画面サイズに基づいてテキスト位置を調整
カクつくアニメーションフレームレートを 60fps に上げる; 適切な減衰設定の spring 構成を使用
Remotion ビルド失敗Node バージョンの互換性を確認; すべての依存関係がインストールされていることを確認; Remotion ドキュメントを参照
タイミングがずれるマニフェストで画面ごとの時間を調整; Remotion Studio でプレビュー; 実際のユーザーでテスト

ベストプラクティス

  1. アスペクト比を維持: 実際の Stitch 画面サイズを使用するか、比例してスケーリングする
  2. 一貫したタイミング: 特定の画面を強調する場合を除き、画面表示時間は一貫させる
  3. 読みやすいテキスト: 十分なコントラストを確保; 適切なフォントサイズを使用; ごちゃごちゃしたオーバーレイを避ける
  4. スムーズなトランジション: 自然な動きに spring アニメーションを使用; 唐突なカットを避ける
  5. 徹底的なプレビュー: 最終レンダリング前に必ず Remotion Studio でプレビュー
  6. アセットの最適化: 画像を適切に圧縮; 効率的なフォーマットを使用(UI には PNG、写真には JPG)

使用例

ユーザープロンプト:

Look up the screens in my Stitch project "Calculator App" and build a remotion video 
that shows a walkthrough of the screens.

エージェントワークフロー:

  1. Stitch プロジェクトを一覧 → 「Calculator App」を見つける → プロジェクト ID を抽出
  2. プロジェクト内の画面を一覧 → すべての画面(Home, History, Settings)を特定
  3. 各画面のスクリーンショットをダウンロード → assets/screens/ に保存
  4. 画面メタデータを含む screens.json マニフェストを作成
  5. Remotion コンポーネント(ScreenSlide.tsx, WalkthroughComposition.tsx)を生成
  6. Remotion Studio でプレビュー → タイミングとトランジションを調整
  7. 最終動画をレンダリング → calculator-walkthrough.mp4
  8. 完了を報告し、動画プレビューリンクを提供

成功のためのヒント

  • シンプルに始める: 複雑なアニメーションを追加する前に、基本的なフェードトランジションから始める
  • Remotion パターンに従う: Remotion の公式スキルとドキュメントを活用する
  • マニフェストファイルを使用する: 画面データを JSON で整理しておくと、更新が容易
  • 頻繁にプレビューする: Remotion Studio を使用して早期に問題を発見する
  • アクセシビリティを考慮: キャプションを追加; テキストが読みやすいことを確認; 明確なビジュアルを使用
  • プラットフォームに最適化: 動画サイズをターゲットプラットフォーム(YouTube、ソーシャルメディアなど)に合わせる

参考資料

関連スキル