Communitygithub.com

mertz1999/luma-assistant

シネマティックなSaaSデモ動画ページや画面収録可能な製品プレゼンテーションを作成します。Codexが/demoルート、アニメーション製品ウォークスルー、SaaSプロモーションプレゼンテーション、画面収録ページ、ナレーション付き製品デモ、カーソル駆動のUIストーリー、アプリやウェブサイトの再利用可能なデモ動画システムを構築するよう求められた際に使用します。

luma-assistant とは?

このスキルは、SaaS製品向けの没入型で自動再生されるデモページを作成するためのものです。機能ツアーではなく短い顧客ストーリーに焦点を当て、問題提起、製品操作、顧客体験、結果表示、ビジネス成果、そして最終的なCTA(行動喚起)という流れで構成される、映画のような体験を提供します。対応プラットフォームはNext.jsのApp RouterおよびReactであり、画面遷移やカーソルアニメーションにFramer Motionを活用します。ユーザーは、製品情報、ブランドアセット、ワークフローの制約、ナレーションスクリプトなどを入力として提供し、スキルはシネマティックなズームイン、スムーズなカーソル動作、オーバーレイキャプション、電話フレーム、結果表示アニメーションなどの機能を持つフルスクリーンのデモページを生成します。また、生成された音声との同期、アクセシビリティ(長時間の動作設定の尊重)、クエリパラメータによるシーンプレビューもサポートし、最終的な検証と納品の手順も提供します。

対応~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/mertz1999/luma-assistant/tree/HEAD/skills/saas-demo-video

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

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

ドキュメント

SaaSデモ動画

成果物

フルスクリーンで自動的に動作するデモページを構築し、洗練されたSaaS製品動画として録画できるようにします。機能ツアーよりも短い顧客ストーリーを優先してください。問題提起、製品操作、顧客体験、結果表示、ビジネス成果、最終的なCTAという流れです。

このスキルを使用して、/demo、/presentation、/video-demoなどのルート、または同等のスタンドアロンHTML/Reactページを作成または改善します。

必要な入力

実装前にこれらを収集するか推測します。ブロッカーがある場合のみ質問してください。

  • 製品名、ドメイン、対象ユーザー、および主な価値提案。
  • 目標の長さとアスペクト比。通常は30〜60秒、16:9。
  • 表示する既存のアプリルート:サインアップ、ダッシュボード、製品作成、リンク作成、顧客ページ、分析。
  • ブランドアセット:ロゴ、色、フォント、製品画像、顧客画像、スクリーンショット、アイコン、電話フレーム。
  • 実際のワークフローの制約:アプリが実際に行うこと、手動の部分、自動の部分、利用可能なデータ。
  • ナレーションスクリプトまたはタイムライン。ユーザーが音声を生成した場合は、正確なタイムスタンプを使用します。
  • 最終的なCTAと録画URL。

製品がサポートしていない動作を決して作り出さないでください。店舗が手動でリンクをコピーする場合は、アプリが自動的に送信すると言うのではなく、そのように記述します。

ストーリーボード

デフォルトの30〜50秒の構成:

  1. 問題提起:現実的な顧客の質問や悩みを表示します。
  2. 管理者の操作:製品を追加し、プライベートリンクを作成し、メッセージをコピーします。
  3. 顧客体験:顧客がリンクを受け取り、開き、画像をアップロードし、生成を開始します。
  4. 結果表示:ビフォー/プロダクト/リザルトをクリーンな表示アニメーションで並べて表示します。
  5. ビジネス成果:重要なダッシュボードメトリクス。
  6. 最終的なCTA:簡潔な製品の価値提案とドメイン。

アプリの実際のドメインと実際の製品言語を使用します。ソーシャルコマースの場合、InstagramスタイルのDM UIは、製品が実際にInstagram APIと統合している場合を除き、視覚的なストーリーデバイスとしてのみ表示します。

実装パターン

アプリの既存のスタックを使用します。Next.jsアプリの場合、以下を優先します:

  • src/app/demo/page.tsxなどのルート。
  • タイミングを制御するプレゼンテーション用のクライアントコンポーネント。
  • シーン遷移、カーソル移動、表示エフェクト、きらめき、ズームにFramer Motionを使用。
  • 既存のUIコンポーネント、ロゴ、パレット、アセット。
  • シーンプレビュー用のクエリパラメータ(例:/demo?scene=resultReveal)。

コアデモコンポーネントの動作:

  • シーンをデータとして定義:id、title、caption、durationMs、cursor、およびオプションの視覚的フォーカス/カメラメタデータ。
  • durationMsからシーン開始時間を計算します。
  • ウォールクロックタイムラインを使用して、開発ホットリロードや再レンダリングが予期せず再生をリセットしないようにします。
  • ユーザーが純粋な録画ページを希望しない限り、再生、一時停止、再開、前へ、次へのコントロールを追加します。
  • 生成された音声と同期する場合、シーンの長さを音声タイムスタンプ範囲と正確に一致させます。
  • 重要なUIコントロールにdata-demo-cursor-target属性を追加し、getBoundingClientRect()からカーソル位置を計算します。実際のターゲットが存在する場合は、ハードコードされたカーソル座標を避けます。
  • ResizeObserverとrequestAnimationFrameを使用して、ビューポートサイズ全体でカーソルターゲットを正確に保ちます。
  • 長時間の動作設定(prefers-reduced-motion)を尊重します。

ビジュアルディレクション

最新のSaaSローンチ/デモ動画のような雰囲気にします:

  • 通常のドキュメントページではなく、フルスクリーンのステージ。
  • 重要なクリックに対するシネマティックなズームイン。
  • 前のカーソル位置から継続するスムーズなカーソル動作。
  • 短いオーバーレイキャプション:「1. 製品を追加」、「2. リンクを送信」、「3. 顧客が試す」。
  • 実際のアプリのスクリーンショットまたはブラウザ/電話フレーム内のリアルなUIモックアップ。
  • フラッシュ、ワイプ、ぼかしからシャープへの変更、またはサイドバイサイド比較による結果表示の瞬間。
  • 2〜4の高シグナルメトリクスを含むクリーンなダッシュボード結果ショット。
  • 密集した段落、開発者ログ、偽の技術用語は避けます。

モバイル顧客フローの場合は、電話フレームを使用します。その内部のコンテンツがデスクトップおよびモバイル録画ビューポートで読み取れるようにします。

ナレーションとタイミング

ユーザーがナレーションを必要とする場合は、音声モデル用のプロンプトを提供します:

  • トーン:自信に満ちた、温かみのある、プレミアム、明確、ロボット的でない。
  • ペース:目標の長さに一致させる。
  • 製品名の発音に関する注意事項。
  • シーンごとにタイムスタンプ付きのスクリプト。

ユーザーが生成された音声タイムスタンプを提供する場合は、シーンの長さをそれらの正確な範囲に更新し、合計時間を確認します。

再利用可能なタイミングとナレーションテンプレートについては、references/storyboard-and-voiceover.mdを参照してください。

検証

終了する前に:

  • アプリをローカルで実行するか、既存の開発/本番サーバーを確認します。
  • 関連するチェックを実行:型チェック、リント、ビルド、またはフレームワーク同等のもの。
  • Playwright/ブラウザチェックをデスクトップおよびモバイルサイズで実行します。
  • 水平方向のオーバーフローがないことを確認します。
  • 電話フレームのコンテンツが表示されていることを確認します。
  • DOMターゲット測定を使用して、カーソルが意図したボタンに着地することを確認します。
  • 実装されている場合、各プレビューシーンがクエリパラメータを介して機能することを確認します。
  • 最終的な公開URLまたはローカルURLが200 OKを返すことを確認します。
  • 動画iframeが埋め込まれている場合、iframeがレンダリングされたHTMLに存在することを確認します。

既知の開発専用の警告(パブリックIP開発サーバーでのNext HMR WebSocket障害など)があれば、個別に報告します。

納品物

返却するもの:

  • デモページのURL。
  • 追加または変更されたルート/ファイル。
  • シーン時間テーブル。
  • リクエストされた場合のナレーションプロンプト。
  • 検証コマンド/結果。
  • 推奨ビューポートサイズやコントロールを非表示にするかどうかなど、録画に関する注意事項。

関連スキル