Communitygithub.com

Ministry-of-Technology-AU/next-platform

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

next-platform とは?

このスキルは、Stitch の画面取得機能と Remotion のプログラムによる動画生成を組み合わせ、プロフェッショナルなウォークスルー動画を作成する映像制作スペシャリストとして動作します。Stitch プロジェクトから画面を取得し、それらを Remotion のビデオ合成で構成します。Remotion の @remotion/transitions ライブラリを使用してフェード、スライド、ズームなどのエフェクトを適用し、画面タイトルや説明文をテキストオーバーレイとして追加できます。最終的には Remotion Studio でプレビュー・調整を行い、MP4 などの形式で動画をレンダリングします。このスキルは Claude Code、Cursor、Codex などの AI エージェントで利用可能で、Stitch MCP サーバーと Remotion MCP サーバー(または Remotion CLI)へのアクセスが必要です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/remotion

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

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

ドキュメント

Stitch から 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. 画面取得:

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

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

    • web_fetch または Bash で curl を使用してスクリーンショットをダウンロードします。
    • ステージングディレクトリ 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
    • 機能: ズームインアニメーション、フェードトランジション
    • 所要時間: 設定可能(デフォルト 1 画面あたり 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. アニメーションを微調整:

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

ステップ 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 はベストプラクティスを定義する独自のエージェントスキルを維持しています。高度なテクニックについては以下を参照してください:

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

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

共通パターン

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

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

  • 1 画面あたり 3〜5 秒
  • クロスフェードトランジション
  • 画面タイトルを表示する下部テキストオーバーレイ
  • 上部の進行状況バー

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

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

  • 特定の領域にズームイン
  • 機能を指し示すアニメーション付き円/矢印
  • 主要なインタラクションをスローモーションで強調
  • サイドバイサイドの before/after 比較

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

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

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

トラブルシューティング

問題解決策
ぼやけたスクリーンショットダウンロードした画像がフル解像度であることを確認; screenshot.downloadUrl の品質設定を確認
テキストの位置ずれ画面寸法が合成サイズと一致することを確認; 実際の画面サイズに基づいてテキストの位置を調整
アニメーションのカクつきフレームレートを 60fps に増加; 適切なダンピングで適切なスプリング設定を使用
Remotion ビルド失敗Node バージョンの互換性を確認; すべての依存関係がインストールされていることを確認; 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 パターンに従う: Remotion の公式スキルとドキュメントを活用
  • マニフェストファイルを使用: 画面データを JSON で整理し、簡単に更新可能に
  • 頻繁にプレビュー: Remotion Studio を使用して問題を早期に発見
  • アクセシビリティを考慮: キャプションを追加; テキストが読みやすいことを確認; 明確なビジュアルを使用
  • プラットフォームに最適化: 動画寸法をターゲットプラットフォーム(YouTube、ソーシャルメディアなど)に合わせる

リファレンス

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Ministry-of-Technology-AU/next-platform

Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer perspectives with context-aware weighting.

Ministry-of-Technology-AU/next-platform

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Ministry-of-Technology-AU/next-platform

Best practices for Remotion - Video creation in React

関連スキル