name: generate-video
description: "Auto-generate product demo videos. Internal/manual workflow only; use from an explicit /generate-video command or a parent media workflow. Requires Remotion setup."
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 コマンドの内部で使用されるスキルです。
コードベース分析 → シナリオ提案 → 並列生成のフローを実行します。
機能詳細
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 プレースホルダー使用）
By