video-scriptwriter

name	video-scriptwriter
description	TikTok/YouTube向け動画スクリプト自動生成スキル。 テーマ+フォーマット+尺を指定すると、scenes.json（storyboard/audio/editor互換）を生成。 Playbookの知見を自動参照して最適な構成を適用。 「スクリプト作成」「台本生成」「企画作って」等で発動。
triggers	["動画のスクリプトを作成","台本を生成","動画の企画を作って","TikTok用の台本","scenes.jsonを生成","video-scriptwriter","動画の構成案"]

Video Scriptwriter

テーマ → 企画 → scenes.json を自動生成する。

6つのフォーマット

フォーマット	説明	量産適性
split_screen_teaching	上半分テキスト+TTS / 下半分ゲーム映像	★★★★★
ranking_list	ランキングTOP5型	★★★★☆
reddit_story	Reddit/2ch読み上げ + 背景動画	★★★★★
dark_facts	「知ると怖い○○」雑学型	★★★★☆
standard_teaching	標準教育/解説型	★★★★☆
product_intro	商品紹介/レビュー型	★★★☆☆

クイックスタート

# 基本
python3 skills/video-scriptwriter/scripts/generate_script.py \
  --topic "睡眠の質を上げる5つの方法" \
  --format ranking_list \
  --duration 30s

# Split-screen教育型
python3 skills/video-scriptwriter/scripts/generate_script.py \
  --topic "量子コンピュータとは何か" \
  --format split_screen_teaching \
  --duration 30s \
  --hook shocking

# フォーマット一覧
python3 skills/video-scriptwriter/scripts/generate_script.py --list-formats

オプション

オプション	デフォルト	説明
--topic	(必須)	動画のトピック/テーマ
--format	standard_teaching	フォーマット
--duration	30s	動画尺 (15s/30s/60s)
--language	ja	言語
--hook	question	Hookスタイル (question/shocking/pov/wait/ranking/dark/nobody/comparison)
--output	auto	出力ディレクトリ
--instructions	-	追加指示テキスト

出力: scenes.json

storyboard-generator / video-audio / video-editor と互換性のあるフォーマット:

{
  "title": "動画タイトル",
  "format": "split_screen_teaching",
  "scenes": [
    {
      "frame_number": 1,
      "timestamp": "0:00-0:03",
      "duration": 3.0,
      "scene_type": "hook",
      "narration": "ナレーション",
      "text_overlay": { "main_text": "テロップ" },
      "visual_prompt": "English prompt for image gen...",
      "motion_type": "i2v"
    }
  ],
  "metadata": {
    "target_audience": "...",
    "estimated_retention_hooks": ["hook手法", "段階的情報開示"]
  }
}

パイプライン連携

scriptwriter (テーマ → scenes.json)
  ↓
storyboard-generator (scenes.json → AI画像)
  ↓
video-audio (scenes.json → TTS音声)
  ↓
video-editor (画像 + 音声 → 最終動画)

Playbook連携

video-playbook に蓄積された知見を自動参照:

• 平均シーン長、ペーシング
• 構成パターン
• テロップスタイル
• 効果的なテクニック

依存

• Gemini API (GEMINI_API_KEY)
• video-playbook (オプション、知見参照)