Communitygithub.com

stitch-remotion

Stitchの画面取得機能とRemotionのプログラム動画生成を組み合わせて、アプリデザインから魅力的なウォークスルー動画を制作する専門家です。スムーズでプロフェッショナルなプレゼンテーションを生成します。

stitch-remotion とは?

このスキルは、Stitch MCPから取得したアプリ画面のスクリーンショットを、Remotionを使ったプログラム動画に変換するためのものです。開発者は、Stitchプロジェクトの画面を一覧取得し、順序付けてウォークスルー動画を構成できます。動画は、フェードやスライドなどのプロフェッショナルなトランジション、テキストオーバーレイ、ズーム効果を備え、最終的にMP4などでレンダリングされます。このスキルは、Stitch MCPサーバーとRemotion MCPサーバーまたはCLIを利用する環境向けに設計されており、Reactコンポーネントベースで拡張性が高く、インタラクティブなホットスポットやナレーションの追加も可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/XideaDev/codot-skill/tree/HEAD/skills/stitch/stitch-remotion

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

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

ドキュメント

Codot ランタイム適応

  • Stitch MCP: Codot 設定 → MCP から一元提供されます(stitch: または mcp__stitch__ プレフィックスが付いたツールを探してください)。エージェントごとにMCPファイルを再設定しないでください。
  • ブラウザとビジュアル確認: ローカル開発サーバーやレンダリング済みページを検査する際は、外部のChrome DevTools MCPよりもCodot組み込みの browser_* ツール(browser_navigate、browser_snapshot、browser_screenshot、browser_console)を優先してください。
  • ビジュアル配信: show_preview はオフラインでネットワークにアクセスできません。StitchエクスポートHTMLはCDNのTailwind/フォントに依存するため、直接渡すと空白でレンダリングされます。stitch-preview スキル(ローカル静的サーバー+完全な忠実度/インタラクションのための browser_*、または stitch-offline.mjs+チャット内HTMLプレビューのための show_preview、または .png スクリーンショットに直接 show_preview)を使用してください。
  • アセットダウンロード: 常にStitch MCPの download_file(htmlCode.name / screenshot.name を指定)を使用し、curl で downloadUrl を取得しないでください(認証情報が必要で、JSONラッパーを返します)。download_file の出力が一時ファイルに切り詰められた場合は、stitch-preview/scripts/save-stitch-file.mjs でデコードしてください。
  • オブジェクトパラメータ: MCPツールが expected object, got string で失敗した場合(一部のエージェントランタイムがオブジェクト引数を文字列としてシリアライズするため)、同じ失敗呼び出しを再試行する代わりに、stitch-manage-design-system の文字列のみのフォールバックワークフローに切り替えてください。
  • 長時間実行呼び出し: generate_screen_from_text または edit_screens がタイムアウトした場合、list_screens を60秒ごとに最大約5分間(5回ポーリング)ポーリングします。新しい画面が表示されない場合は、無限に待機せずに呼び出しを1回再発行します。
  • ツールマッピング: 汎用ツール名(Read、Write、Edit、Bash)をアクティブなCodotハーネスツール(read、write、edit、bash)にマッピングします。

Stitch to Remotion ウォークスルー動画

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

概要

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

前提条件

必須:

  • 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. 画面取得:

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

    • 画面リソースの name(projects/{project}/screens/{screen})を指定して [stitch_prefix]:get_screen を呼び出す
    • 以下を取得する:
      • screenshot.name(projects/{project}/files/{file}) — 動画のビジュアルアセット
      • htmlCode.name(projects/{project}/files/{file}) — オプション:テキスト/コンテンツ抽出用
      • width、height — 適切なスケーリングのための画面寸法
      • テキストオーバーレイ用の画面タイトルと説明
  4. アセットダウンロード:

    • Stitch MCP [stitch_prefix]:download_file を screenshot.name を指定して呼び出す(downloadUrl に curl や web_fetch を使用しないでください。認証情報が必要でJSONラッパーを返します)
    • download_file の出力が一時ファイルに切り詰められた場合は、以下でデコードする: node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> 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 — 個別画面表示コンポーネント

    • Props: 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": "ホーム画面",
      "description": "テンキー付きのメイン電卓インターフェース",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "履歴ビュー",
      "description": "以前の計算結果の表示",
      "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. アニメーションを微調整:

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

ステップ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.name を指定して [stitch_prefix]:download_file を呼び出す(切り詰められた出力は save-stitch-file.mjs でデコード)
  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はベストプラクティスを定義する独自のエージェントスキルを維持しています。高度なテクニックについてはこれらを確認してください:

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

  • アニメーションのタイミングとイージング
  • コンポジションアーキテクチャパターン
  • パフォーマンス最適化
  • オーディオ同期

共通パターン

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

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

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

パターン2:機能ハイライト

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

  • 特定の領域にズームイン
  • 機能を指し示すアニメーション円/矢印
  • 重要なインタラクションをスローモーションで強調
  • 変更前/変更後の並列比較

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

ステップごとのユーザージャーニーを表示:

  • 方向性スライドによる順次画面フロー
  • 番号付きステップオーバーレイ
  • ユーザーアクション(クリック、タップ)を強調表示
  • アニメーションパスで画面を接続

トラブルシューティング

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

ベストプラクティス

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

使用例

ユーザープロンプト:

Stitchプロジェクトの「Calculator App」にある画面を調べて、各画面のウォークスルーを
表示するremotion動画を作成してください。

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

  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コミュニティを活用: 複雑なアニメーションの例や解決策を公式ドキュメントやディスカッションで参照

関連スキル