Communitygithub.com

ビデオスクリプトライター

製品デモ、機能ウォークスルー、ローンチビデオのためのビデオスクリプトを作成します。ペース、ビジュアルディレクション、タイミング、プラットフォームに適した長さを処理します。

ビデオスクリプトライター とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が、製品デモ、機能ウォークスルー、ローンチビデオ、ソーシャルメディア動画向けのビデオスクリプトを作成するのを支援します。マーケティングブリーフ、ブログ記事、チェンジログ、PR、Git参照、または自由形式のテキストから入力を受け取り、最適なスクリプトを生成します。プロセスは6つのフェーズ(入力解決、ディスカバリー、設定、アウトライン作成、執筆、レビュー、出力)で構成され、各フェーズを順に進めます。短尺(30~90秒)と中尺(3~5分)の両方に対応し、ナレーション、ツーカラム、トーキングヘッドの3種類のスクリプト形式を提供します。また、既存のリポジトリコンテンツからトーンを分析し、適切なCTAを提案します。ペーシングガイドラインに従い、フック、問題提起、ソリューション、CTAの構成で、視聴者のエンゲージメントを高めます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/video-script

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ビデオスクリプトライター は何をしますか?

製品デモ、機能ウォークスルー、ローンチビデオのためのビデオスクリプトを作成します。ペース、ビジュアルディレクション、タイミング、プラットフォームに適した長さを処理します。

入力解決

引数(指定されている場合)を以下の順序で解決します:

  1. 既存のマーケティングブリーフへのパス(「エグゼクティブサマリー」または「主要メッセージ」を含む.mdファイル)→ マーケティングブリーフ
  2. 既存のブログ記事へのパス(ブログ記事構造の.mdファイル)→ ブログ記事
  3. 既存のチェンジログへのパス → チェンジログ
  4. 既存のニュースレターへのパス → ニュースレター
  5. GitHub URLまたは#\d+パターンに一致 → PR
  6. ...または..を含む → Git参照範囲
  7. 既存のファイル/ディレクトリに解決 → コードベース機能
  8. それ以外 → 自由形式テキスト

引数が指定されていない場合は、次のように尋ねます:「ビデオの内容は何にしますか?マーケティングブリーフ、ブログ記事、チェンジログ、PRのURL/番号、Git参照範囲、ファイル/ディレクトリパス、または機能の説明を提供できます。」

複数の解釈が一致する場合は、ユーザーに確認します。

プロセスフロー

digraph video_script {
    rankdir=TB;
    "Resolve input" [shape=box];
    "Phase 1: Discovery" [shape=box];
    "Phase 2: Configure" [shape=box];
    "Phase 3: Outline" [shape=box];
    "Outline approved?" [shape=diamond];
    "Phase 4: Write" [shape=box];
    "Phase 5: Review" [shape=box];
    "Approved?" [shape=diamond];
    "Phase 6: Output" [shape=box];

    "Resolve input" -> "Phase 1: Discovery";
    "Phase 1: Discovery" -> "Phase 2: Configure";
    "Phase 2: Configure" -> "Phase 3: Outline";
    "Phase 3: Outline" -> "Outline approved?";
    "Outline approved?" -> "Phase 3: Outline" [label="no, revise"];
    "Outline approved?" -> "Phase 4: Write" [label="yes"];
    "Phase 4: Write" -> "Phase 5: Review";
    "Phase 5: Review" -> "Approved?";
    "Approved?" -> "Phase 4: Write" [label="revisions"];
    "Approved?" -> "Phase 6: Output" [label="yes"];
}

フェーズをスキップしないでください。 自然なペースで質問してください。ユーザーが複数の質問に一度に答えた場合は、バンドルされた回答を受け入れ、先に進んでください。

ユーザーが「デフォルトでいいよ」などと言った場合は、妥当なデフォルトを選択し、選択内容を伝え、単一の確認を求めます。

フェーズ1: ディスカバリー

ステップ1 - 入力を分析

入力タイプ読み取る内容
マーケティングブリーフ問題定義、価値提案、オーディエンス、主要メッセージを抽出。ステップ3にスキップ。ブリーフに製品コンテキストがない場合はステップ2を実行。
ブログ記事見出し、重要ポイント、オーディエンス、CTAを抽出。ステップ3にスキップ。
チェンジログ主要なエントリを抽出し、最も影響の大きい変更に焦点を当てる。ステップ3にスキップ。
ニュースレター件名、主な更新、CTAを抽出。ステップ3にスキップ。
PRDiff、PR説明、レビューコメント、コミットメッセージ。大規模なPR(20ファイル以上)の場合は、ユーザー向けの変更に焦点を当てる。
Git参照参照間のgit diffとgit log。ユーザー向けの変更を優先。
コードベース機能指定されたファイル/ディレクトリを読み取る。
自由形式テキストユーザーの説明を解析。具体性に欠ける場合は、ユーザーに詳細または特定のファイル/PRを指定するよう依頼。

ユーザー向けの変更には、新機能、UI変更、API変更、パフォーマンス改善、バグ修正、ドキュメント更新が含まれます。内部変更には、リファクタリング、テスト追加、CI変更、依存関係のバンプが含まれます。

エラーハンドリング:

  • ghが利用不可 -> ユーザーに通知、代替入力を提案
  • 無効なPR/参照 -> ユーザーに確認を依頼
  • ファイルが見つからない -> 正しいパスを尋ねる

ステップ2 - より広範な製品コンテキストを読み取る

存在する場合は、README、docs/、package.json(または同等のもの)を読み取ります。

何も見つからない場合は、次のように尋ねます:「製品とその対象ユーザーについて簡単に説明してもらえますか?」

ステップ3 - 理解内容を提示

「ビデオスクリプトのベースとして以下を使用します:」

  • 機能A - 簡単な説明
  • 機能B - 簡単な説明

「追加、削除、修正したいことはありますか?」

ユーザーがスコープを確認するまで先に進まないでください。

ステップ4 - 機密コンテンツのチェック

先に進む前に、機密性の可能性があるコンテンツ(セキュリティパッチ、内部価格、認証情報、未公開のロードマップ項目、または機密とマークされたコンテンツ)をスキャンします。疑わしいものはすべてユーザーにフラグを立てます。

フェーズ2: 設定

以下の質問をします:

Q1 - ビデオの長さ:

  • ショートフォーム(30〜90秒) - ソーシャルメディア(Reels、Shorts、TikTok)
  • ミディアムフォーム(3〜5分) - YouTube、製品デモ、ウォークスルー

Q2 - スクリプトタイプ:

  • ナレーション - スクリーンレコーディング/フッテージに重ねて読むナレーションテキスト
  • ツーカラム - 左列:ビジュアルディレクション/画面アクション、右列:ナレーション
  • トーキングヘッド - カメラ上のスピーカー、会話調の配信

Q3 - トーン: 既存のリポジトリコンテンツを読み、声を検出します。確認します:

「既存のコンテンツに基づくと、トーンは[例:会話調で開発者に優しい]ようです。これに合わせるべきですか、それとも別の方向にしますか?」

分析するコンテンツがない場合は、直接尋ねます。

Q4 - CTA: コンテキストから推測:

  • オープンソース -> 「リポジトリにスターを付ける」、「試してみる」
  • SaaS -> 「無料でサインアップ」、「トライアルを開始」
  • 機能更新 -> 「今すぐ試す」、「ドキュメントを確認」

「CTAは[推測されたCTA]を提案します。これでいいですか、それとも別のものにしますか?」

フェーズ3: アウトライン

タイミングを含む構造化されたアウトラインを生成します。ビデオの長さに基づいて適切なテンプレートを使用します:

ショートフォーム(30〜90秒) - 3〜4セクション:

## [作業タイトル] - [総時間]

1. **フック** (0:00-0:05) - [アプローチ]
   - 重要ポイント
   - ビジュアル: [表示するもの]

2. **問題** (0:05-0:15) - [設定するペインポイント]
   - ビジュアル: [表示するもの]

3. **ソリューション** (0:15-0:45) - [機能ウォークスルー]
   - 重要ポイントA
   - ビジュアル: [表示するもの]
   - 重要ポイントB
   - ビジュアル: [表示するもの]

4. **CTA** (0:45-0:60) - [実行するアクション]
   - ビジュアル: [エンドスクリーン]

推定合計: ~X単語(135 WPMで約Y秒)

ミディアムフォーム(3〜5分) - 5〜8セクション:

## [作業タイトル] - [総時間]

1. **フック** (0:00-0:10) - [アプローチ]
   - ビジュアル: [表示するもの]

2. **問題** (0:10-0:30) - [ペインポイント、コンテキスト、なぜ重要か]
   - ビジュアル: [表示するもの]

3. **ソリューション概要** (0:30-1:00) - [構築したもののハイレベル説明]
   - ビジュアル: [表示するもの]

4. **ディープダイブ:[機能A]** (1:00-2:00) - [ウォークスルー]
   - 重要ポイント
   - ビジュアル: [スクリーンレコーディングの手順]

5. **ディープダイブ:[機能B]** (2:00-3:00) - [ウォークスルー]
   - 重要ポイント
   - ビジュアル: [スクリーンレコーディングの手順]

6. **ディープダイブ:[機能C]** (3:00-3:45) - [ウォークスルー]
   - 重要ポイント
   - ビジュアル: [スクリーンレコーディングの手順]

7. **まとめ** (3:45-4:30) - [主要なメリットを要約]
   - ビジュアル: [サマリースライドまたはサイドバイサイド]

8. **CTA** (4:30-5:00) - [実行するアクション]
   - ビジュアル: [エンドスクリーン]

推定合計: ~X単語(135 WPMで約Y秒)

カバーする機能に合わせてディープダイブセグメントの数を調整します。

アウトラインを提示し、執筆前に承認を待ちます。

フェーズ4: 執筆

ペーシング参考表

ビデオの長さ目標単語数WPM
30秒~65単語130
60秒~135単語135
90秒~200単語135
3分~400単語135
5分~675単語135

会話調の配信では130〜145 WPMを目標にします。割り当てられた時間を超過するセクションにはフラグを立てます。

スクリプト形式(タイプ別)

ナレーションスクリプト:

## [タイトル]

### フック (0:00-0:05) - ~15単語
ビジュアル: [画面に表示されるものの説明]

[ナレーションテキストをここに。]

### セクション名 (0:05-0:20) - ~30単語
ビジュアル: [画面に表示されるものの説明]

[ナレーションテキストをここに。]

ツーカラムスクリプト:

| 時間 | ビジュアル | ナレーション |
|---|---|---|
| 0:00-0:05 | [画面:ランディングページが読み込まれる] | [ナレーションテキスト] |
| 0:05-0:15 | [画面:設定メニューをクリック] | [ナレーションテキスト] |
| 0:15-0:30 | [画面:ダークモードを切り替え] | [ナレーションテキスト] |

トーキングヘッドスクリプト:

## [タイトル]

### フック (0:00-0:05) - ~15単語
カメラ: [カメラ上のスピーカー、ミディアムショット]

[スピーカーテキストをここに。会話調、カメラに直接。]

### セクション名 (0:05-0:20) - ~30単語
カメラ: [スクリーンレコーディングに切り替え]
ナレーション: [スクリーンレコーディングにかぶせるナレーション]

カメラ: [スピーカーに戻る]
[スピーカーテキストをここに。]

フック

最初の3〜5秒で視聴者が見続けるかどうかが決まります。フックは以下を満たす必要があります:

  • ペインポイントに対処する、または挑発的な質問をする
  • 自社/製品名で始めない
  • 「このビデオでは、...をお見せします」で始めない
  • 即座に好奇心や感情的な共鳴を生み出す

ビジュアルディレクション

スクリプトタイプに関わらず、必ずインラインでビジュアルディレクションを含めます:

  • VISUAL: / SCREEN: スクリーンレコーディングやフッテージ用
  • CAMERA: トーキングヘッドのカメラディレクション用
  • 具体的に:「SCREEN: エクスポートボタンをクリックし、PDFがダウンロードされるのを見せる」であり、「SCREEN: 機能を見せる」ではない
  • シーン間のトランジションノートを含める

セクションごとのタイミング

すべてのセクションに推定時間と単語数を含めます:

  • ### セクション名 (0:15-0:30) - ~30単語
  • セクションが時間予算を超えた場合はフラグを立てる
  • スクリプトの総単語数は、135 WPMで目標時間と一致している必要があります

執筆ルール

  • 会話調で、台本っぽくないこと。実際に人が話すように書く。
  • 短い文。1文あたり最大10〜15単語。
  • 1文に1つのアイデア。
  • 常に能動態。
  • 生成コンテンツではemダッシュを使用しないでください。 「---」文字は使用しないでください。代わりにカンマ、コロン、ピリオド、または括弧を使用してください。
  • 説明ではなく、見せる。「これがどれだけ速く読み込まれるか見てください」> 「とても速く読み込まれます」
  • ミディアムフォームのビデオでは、3つのルールを使用:3つのメリット、3つの機能、3つの例。ショートフォームでは、単一の主要なメリットに焦点を当てます。

CTA

  • ビデオの最後の5〜10秒
  • 単一の明確なアクション
  • エンドスクリーンのビジュアルディレクションを含める(購読ボタン、リンクオーバーレイ、QRコード)

フェーズ5: レビュー

タイミング内訳を含む完全なスクリプトを提示します:

「こちらがスクリプトです:」

[完全なスクリプト]

タイミング内訳:

  • フック: 5秒(約15単語)
  • 問題: 10秒(約25単語)
  • ソリューション: 30秒(約70単語)
  • CTA: 10秒(約20単語)
  • 合計: 55秒(135 WPMで約130単語)

「変更はありますか?」

承認を待ちます。ユーザーが確認した場合のみ出力に進みます。

フェーズ6: 出力

承認された最終スクリプトを必ずターミナルに表示します。

次に尋ねます:「これを scripts/<slug>.md に保存しますか?それとも別のパスにしますか?」

ディレクトリが存在しない場合は作成します。ファイルがすでに存在する場合は、上書きするか、バージョン管理されたコピーを作成するかを尋ねます。

エラーハンドリング

  • ghが利用不可 -> ユーザーに通知、代替入力を提案
  • 無効なPR/参照 -> ユーザーに確認を依頼
  • 製品コンテキストがない -> ユーザーに製品の説明を依頼
  • スクリプトが目標時間を超える -> フラグを立て、レビュー前にカットを提案

このスキルが行わないこと

  • ビデオの録画や編集
  • サムネイルやビジュアルアセットの生成
  • アニメーションやモーショングラフィックスの作成
  • ブログ記事やソーシャルコピーの執筆(/blog-postまたは/social-copyを使用)

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

関連スキル