Communitygithub.com

BEKO2210/Firstbrain

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

Firstbrain とは?

このスキルは、Stitchのプロジェクトでデザインされた画面から、Remotionを使用してプロフェッショナルなウォークスルー動画を作成するためのものです。Stitchサーバーから画面のスクリーンショットやメタデータを取得し、Remotionのビデオ合成機能を使って、スムーズなトランジション、ズーム効果、テキストオーバーレイを施した動画を生成します。開発者は、Node.js環境とStitchおよびRemotionのMCPサーバーへのアクセスが必要です。処理の流れは、プロジェクトと画面の特定、アセットのダウンロード、Remotionプロジェクトのセットアップ、ビデオのプレビューとレンダリングという手順を踏みます。このスキルを使用することで、手動で動画編集ツールを使うことなく、コードベースで一貫性のある高品質なウォークスルー動画を短時間で生成できるようになります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/remotion

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

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

ドキュメント

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

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

概要

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

前提条件

必須:

  • Stitch MCP Server へのアクセス
  • Remotion MCP Server (または 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 — 個別の画面表示コンポーネント

    • 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": "電卓アプリ",
  "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/walkthrough/ ディレクトリの例を確認する

ステップ 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 は、ベストプラクティスを定義する独自の Agent Skills を維持しています。高度なテクニックについてはこれらを確認してください:

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

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

一般的なパターン

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

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

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

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

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

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

パターン 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, ソーシャルメディアなど) に合わせる

参考文献

使用タイミング

上記の主要なドメインや機能に関連するタスクに取り組む際に、このスキルを使用してください。

接続

  • ドメイン: [[Design & Kreativitaet]]
  • カテゴリー: [[UI & UX Design]]
  • ナビゲーション: [[Skills Uebersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

BEKO2210/Firstbrain

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

BEKO2210/Firstbrain

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

BEKO2210/Firstbrain

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

BEKO2210/Firstbrain

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

BEKO2210/Firstbrain

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

BEKO2210/Firstbrain

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

関連スキル