/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 (オプション、知見参照)