solo-video-promo

/video-promo

プロジェクトの PRD からプロモーション動画のプランを作成します。ショットごとの絵コンテを含む、30〜45 秒の動画スクリプトを作成します。プロジェクト内の Montage-tool または Remotion を検出し、見つかった場合は互換性のある設定を出力します。

MCP ツール（利用可能な場合）

• project_code_search(query, project) — 紹介する UI コンポーネント、画面、機能を検索します
• project_info(name) — プロジェクトの技術スタックと詳細情報を取得します
• kb_search(query) — 動画制作の方法論を検索します

MCP ツールを利用できない場合は、Glob + Grep + Read にフォールバックします。

手順

1. $ARGUMENTS からプロジェクトを解析します。

   • 製品情報を得るため、PRD（docs/prd.md）、README、または CLAUDE.md を読みます。
   • 空の場合：AskUserQuestion で質問します。

2. プロジェクト内の動画ツールを検出します。

   • package.json で remotion、@remotion/cli を確認 → Remotion プロジェクト
   • montage.config.*、pnpm montage を確認 → Montage-tool プロジェクト
   • スクリプト内で ffmpeg が使用されているか確認 → FFmpeg パイプライン
   • どれも見つからない場合：特定のツール設定を含まない、プレーンな絵コンテを出力します

3. 紹介する主要な画面や機能を抽出します。

   • MCP を利用できる場合：project_code_search("main screen OR hero OR dashboard", project) — 紹介に適した UI を探します
   • それ以外の場合：スクリーンショット、モックアップ、または UI コンポーネントのファイルを Glob で検索します
   • PRD を読み、紹介する主要機能を 3〜5 個選びます

4. 必須の検討 — 動画戦略： スクリプトを書く前に、以下を書き出します。

   • 目標： 視聴後に視聴者に何をしてほしいですか？（ダウンロード、登録、訪問）
   • フックの種類： 質問？意外な統計？悩み？大胆な主張？
   • デモシーン： 画面上で見せる、製品の重要なシーンを 3 つ
   • 感情の流れ： 不満 → 発見 → 安心・喜び

5. 動画スクリプトを作成します（30〜45 秒）。

   ## Video Script: {Project Name}
   
   **Duration:** 30-45 seconds
   **Format:** Vertical (9:16) for Reels/TikTok/Shorts
   **Style:** Screen recording + text overlays
   
   ### HOOK (0:00-0:03) — 3 seconds
   **Audio:** "{hook line — question or bold statement}"
   **Visual:** {what appears on screen — text overlay on gradient/blurred BG}
   
   ### PROBLEM (0:03-0:10) — 7 seconds
   **Audio:** "{describe the pain in user's words}"
   **Visual:** {show the frustrating current state — competitor UX, manual process, etc.}
   
   ### DEMO (0:10-0:25) — 15 seconds
   **Audio:** "{narrate what the product does}"
   **Visual:**
   - Shot 1 (5s): {first feature demo — screen recording}
   - Shot 2 (5s): {second feature demo}
   - Shot 3 (5s): {wow moment — the key differentiator}
   
   ### CTA (0:25-0:30) — 5 seconds
   **Audio:** "{call to action}"
   **Visual:** {product logo + URL + download badge}
   

6. ツール設定を作成します（該当する場合）。

   Remotion が検出された場合：

   ## Remotion Component Spec
   
   Component: `PromoVideo.tsx`
   Duration: 900 frames (30fps × 30s)
   
   Sequences:
   - HookSequence (0-90): Text animation on gradient
   - ProblemSequence (90-300): Screen recording import
   - DemoSequence (300-750): 3 feature recordings with transitions
   - CTASequence (750-900): Logo + URL fade in
   
   Assets needed:
   - screen-recording-problem.mp4
   - screen-recording-feature-1.mp4
   - screen-recording-feature-2.mp4
   - screen-recording-feature-3.mp4
   - logo.png
   - background-music.mp3
   

   Montage tool が検出された場合：

   ## Montage Config
   
   Clips:
   - problem-clip.mp4 (7s)
   - demo-feature-1.mp4 (5s)
   - demo-feature-2.mp4 (5s)
   - demo-wow-moment.mp4 (5s)
   
   Music: {suggest genre/BPM for beat-sync}
   Transitions: crossfade (0.5s)
   Text overlays: hook, CTA
   

7. プランを docs/video-promo.md に書き込みます。

   # Video Promo Plan: {Project Name}
   
   **Generated:** {YYYY-MM-DD}
   **Duration:** 30-45 seconds
   **Format:** Vertical 9:16
   **Tooling:** {Remotion / Montage-tool / Manual}
   
   ## Script
   {full script from step 5}
   
   ## Assets Checklist
   - [ ] Screen recording: {feature 1}
   - [ ] Screen recording: {feature 2}
   - [ ] Screen recording: {wow moment}
   - [ ] Logo (transparent PNG)
   - [ ] Background music (royalty-free, upbeat)
   
   ## Tooling Config
   {config from step 6, or "Record manually and edit in CapCut/iMovie"}
   
   ---
   *Generated by /video-promo. Record assets, then render.*
   

8. 概要を出力します — スクリプトの概要、必要な素材、推奨する次のステップ。

補足

• スクリプトでは、メインの映像に画面録画を使う想定です — 俳優は必要ありません
• iOS アプリの場合：Simulator で録画するか、デバイスミラーリングを使用します
• Web の場合：ブラウザーで画面を録画します
• 音楽：ロイヤリティフリーの音源（Artlist、Epidemic Sound、YouTube Audio Library）を提案します
• このスキルが作成するのはプランです — 実際の動画のレンダリングは手動、または Montage-tool／Remotion で行います

よくある問題

動画ツールが検出されない

原因： プロジェクトで Remotion または Montage-tool が使用されていません。 対処法： スキルはデフォルトでプレーンな絵コンテを出力します。手動で録画して CapCut／iMovie で編集するか、プロジェクトに Remotion を追加してください。

ショート動画用のスクリプトが長すぎる

原因： 紹介する機能が多すぎます。 対処法： 主要機能は 3 つだけに絞ってください。30〜45 秒のナレーションは約 75〜100 語が目安です。少ないほうが効果的です。

録画できるスクリーンショットや UI がない

原因： 製品がまだ開発されていないか、視覚的なインターフェースがありません。 対処法： モックアップ、ワイヤーフレーム、または絵コンテに予定している映像を記述してください。MVP の完成後に録画します。