Communitygithub.com

ASoudy/AGS

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

AGS とは?

このスキルは、Stitchの画面取得機能とRemotionのプログラムによる動画生成を組み合わせて、アプリ画面のウォークスルー動画を専門的に作成するためのものです。Stitch MCPサーバーからプロジェクトのスクリーンショットを取得し、フェード、スライド、ズームなどのプロフェッショナルなトランジション効果や、画面タイトル、説明文、進行状況インジケーターなどのテキストオーバーレイを施した動画構成をRemotionで構築します。主にClaude CodeやCodexなどのAIエージェント環境で動作し、開発者向けのアプリデモやチュートリアル動画の自動生成に役立ちます。ワークフローは、Stitchプロジェクトの特定とスクリーンの取得、Remotionプロジェクトのセットアップ、Reactコンポーネント(ScreenSlide.tsxやWalkthroughComposition.tsx)の生成、動画のプレビューと最終レンダリングという一連の流れで構成され、screens.jsonによるマニフェスト管理や、高度な機能としてインタラクティブホットスポットやナレーションの統合にも対応しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/remotion

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

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

ドキュメント

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

    • [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 — 個々の画面表示コンポーネント

    • 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": "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/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スキルを維持しています。高度なテクニックについてはこれらを確認してください:

活用すべき主要な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、ソーシャルメディアなど)に合わせる

参考文献

使用するタイミング

このスキルは、上記で説明された主要なドメインまたは機能に関連するタスクに取り組むときに使用します。

制限事項

  • このスキルは、タスクが上記で説明された範囲に明確に一致する場合にのみ使用してください。
  • 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
  • 必要な入力、権限、安全性の境界、または成功基準が欠落している場合は、立ち止まって明確化を求めてください。

Individual skills in this repo

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

ASoudy/AGS

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

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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

関連スキル