whyzsm Generate Video Skill
プロダクト説明動画の自動生成を担当するスキル群です。
起動契約
このスキルは user-invocable: false かつ disable-model-invocation: true です。
通常のユーザー発話（例: 「動画を作って」）で Claude が自動選択する前提にはしません。
- 明示的な
/generate-videoコマンド、または親メディアワークフローから内部的に起動される時だけ使います。 allowed-toolsは Claude Code 用です。Claude ではユーザー確認にAskUserQuestionを使えます。- Codex mirror では同等の確認は
request_user_input相当の計画モード入力に読み替えます。通常実行でそのツールがない場合は、既定値を提示して停止せず進め、重要な未確定事項だけユーザーへ確認します。 disable-model-invocation: trueは「説明文だけを見てモデルが勝手に起動しない」という意味です。slash や親 workflow から明示起動された場合は本文手順に従います。
概要
/generate-video コマンドの内部で使用されるスキルです。
コードベース分析 → シナリオ提案 → 並列生成のフローを実行します。
機能詳細
| 機能 | 詳細 |
|---|---|
| ベストプラクティス | See references/best-practices.md |
| コードベース分析 | See references/analyzer.md |
| シナリオプランニング | See references/planner.md |
| 並列シーン生成 | See references/generator.md |
| 視覚効果ライブラリ | See references/visual-effects.md |
| AI画像生成 | See references/image-generator.md |
| 画像品質判定 | See references/image-quality-check.md |
Prerequisites
- Remotion がセットアップ済み（
/remotion-setup） - Node.js 18+
- （オプション）
GOOGLE_AI_API_KEY- AI画像生成用
/generate-video フロー
/generate-video
│
├─[Step 1] 分析（analyzer.md）
│ ├─ フレームワーク検出
│ ├─ 主要機能検出
│ ├─ UIコンポーネント検出
│ └─ プロジェクト資産解析（Plans.md, CHANGELOG等）
│
├─[Step 2] シナリオ提案（planner.md）
│ ├─ 動画タイプ自動判定
│ ├─ シーン構成提案
│ └─ ユーザー確認
│
├─[Step 2.5] 素材生成（image-generator.md）← NEW
│ ├─ 素材必要判定（イントロ、CTA等）
│ ├─ Nano Banana Pro で2枚生成
│ ├─ Claude が品質判定（image-quality-check.md）
│ └─ OK → 採用 / NG → 再生成（最大3回）
│
└─[Step 3] 並列生成（generator.md）
├─ シーン並列生成（Task tool）
├─ 統合 + トランジション
└─ 最終レンダリング
実行手順
- ユーザーが
/generate-videoを実行 - Remotion セットアップ確認
analyzer.mdでコードベース分析planner.mdでシナリオ提案 + ユーザー確認generator.mdで並列生成- 完了報告
動画タイプ（ファネル別）
| タイプ | ファネル | 長さ目安 | 自動判定条件 | 構成の芯 |
|---|---|---|---|---|
| LP/広告ティザー | 認知〜興味 | 30-90秒 | 新規プロジェクト | 痛み→結果→CTA |
| Introデモ | 興味→検討 | 2-3分 | UI変更検出 | 1ユースケース完走 |
| リリースノート | 検討→確信 | 1-3分 | CHANGELOG更新 | Before/After重視 |
| アーキテクチャ解説 | 確信→決裁 | 5-30分 | 大規模構造変更 | 実運用+証拠 |
| オンボーディング | 継続・活用 | 30秒-数分 | 初回セットアップ | Aha体験への最短パス |
詳細: references/best-practices.md
シーンテンプレート
90秒ティザー（LP/広告向け）
| 時間 | シーン | 内容 |
|---|---|---|
| 0-5秒 | Hook | 痛み or 望む結果 |
| 5-15秒 | Problem+Promise | 対象ユーザーと約束 |
| 15-55秒 | Workflow | 象徴ワークフロー |
| 55-70秒 | Differentiator | 差別化の根拠 |
| 70-90秒 | CTA | 次の一手 |
3分Introデモ（検討向け）
| 時間 | シーン | 内容 |
|---|---|---|
| 0-10秒 | Hook | 結論+痛み |
| 10-30秒 | UseCase | ユースケース宣言 |
| 30-140秒 | Demo | 実画面で完走 |
| 140-170秒 | Objection | よくある不安1つ潰す |
| 170-180秒 | CTA | 行動喚起 |
共通シーン
| シーン | 推奨時間 | 内容 |
|---|---|---|
| イントロ | 3-5秒 | ロゴ + タグライン |
| 機能デモ | 10-30秒 | Playwrightキャプチャ |
| アーキテクチャ図 | 10-20秒 | Mermaid → アニメーション |
| CTA | 3-5秒 | URL + 連絡先 |
詳細テンプレート: ${CLAUDE_SKILL_DIR}/references/best-practices.md
音声同期ルール（重要）
ナレーション付き動画では以下を厳守:
| ルール | 値 |
|---|---|
| 音声開始 | シーン開始 + 30f（1秒待機） |
| シーン長さ | 30f + 音声長さ + 20f余白 |
| トランジション | 15f（隣接シーンとオーバーラップ） |
| シーン開始計算 | 前シーン開始 + 前シーン長 - 15f |
事前確認: ffprobe で音声長さを確認してからシーン設計
詳細: ${CLAUDE_SKILL_DIR}/references/generator.md
BGM サポート
| 項目 | 推奨値 |
|---|---|
| ナレーションあり | bgmVolume: 0.20 - 0.30 |
| ナレーションなし | bgmVolume: 0.50 - 0.80 |
| ファイル配置 | public/BGM/ |
詳細: ${CLAUDE_SKILL_DIR}/references/generator.md
字幕サポート
| ルール | 値 |
|---|---|
| 字幕開始 | 音声開始と同じ |
| 字幕duration | 音声長 + 10f |
| フォント | Base64埋め込み推奨 |
詳細: ${CLAUDE_SKILL_DIR}/references/generator.md
視覚効果ライブラリ
インパクトのある動画向けエフェクト集:
| エフェクト | 用途 |
|---|---|
| GlitchText | Hook、タイトル |
| Particles | 背景、CTA収束 |
| ScanLine | 解析中演出 |
| ProgressBar | 並列処理表示 |
| 3D Parallax | カード表示 |
詳細: references/visual-effects.md
Notes
- Remotion未セットアップの場合は
/remotion-setupを案内 - 並列生成数はシーン数に応じて自動調整（max 5）
- 生成された動画は
out/ディレクトリに出力 - AI生成画像は
out/assets/generated/に保存 GOOGLE_AI_API_KEY未設定時は画像生成をスキップ（既存素材 or プレースホルダー使用）