video-script について
実体験と本人の話し方をもとに、短尺動画の台本やフック、リライト、自然な文章を作るクリエイター向けスキルです。ニッチ調査やアカウント分析、使用履歴を参照し、最近の話題の重複も避けます。
主な機能
- 01動画の種類を組み合わせた週間計画
- 02複数のフック案の生成と採点
- 03時間を確認しながら台本を改稿
- 04本人の話し方に合わせた文章調整
- 05調査と履歴に基づくテーマ選定
活用シーン
- 01短尺動画を一週間分計画
- 02実績のあるニッチ概念からフックを作成
- 03事実を変えずに原稿を簡潔化
- 04キャプションを本人らしい表現に調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ melvynx/ video-agent-skills --skill video-scriptインストール後、Claude Code で/video-scriptを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/ai-tells.mdhooks.mdhumanize.mdscript-rules.mdviral.md詳細
動画スクリプト
クリエイターが最高の調子のときのように聞こえるスクリプトです。短く、具体的で、次の30秒を見る価値のあるフックがあります。すべて本人の実際の1週間と本人の言葉をもとにしています。何も作り出しません。
執筆前
次の順番で読みます。
video-agent/voice.md:本人がどんな人か、誰に向けて話すのか、どんな話し方をするのか、何を信じているのか、その根拠、視聴者への呼びかけを確認します。不足している場合は、/video-setup(約10分、推奨)を提案するか、今すぐ4つの質問をします(何をしているか、誰のためにしているか、どの言語で録画するか、視聴後に視聴者に何をしてほしいか)。video-agent/swipe.md:そのニッチで効果のあったフックと、さらに「Concepts」から、根拠とともに成果が特に高かったものを確認します(/video-viralの情報)。すべてのスクリプトは、そのいずれかを土台にします(references/viral.md)。不足している場合は、まず/video-viralを実行します(5分)。これなしで1週間分を書くのは、手探りで書くようなものです。video-agent/audit.mdがあれば読みます:本人のアカウントで何が効果を上げているかを確認します(/video-auditの情報)。「来週に向けた3つの変更」は今週のスクリプトに適用し、成果の高いトピック、長さ、フックのパターンを優先します。本人のデータはニッチのデータに勝ります。video-agent/log.mdの末尾20行:すでに使ったトピックとフックのパターンを確認します。本人から依頼がない限り、直近4週間のトピックは繰り返しません。- references/viral.md、references/hooks.md、references/script-rules.md、references/humanize.md。
本人の言語で話しかけ、録画に使う言語でスクリプトを書きます。
モード
/video-script→ 1週間分のスクリプト(デフォルトは5本)。/video-script <topic or idea>→ スクリプト1本。/video-script hook <script or topic>→ フック生成機能:10種類以上のパターンから20個のフックを作成し、swipe.mdのコンセプトごとにグループ化します(実績のあるコンセプトを優先)。voice.mdの内容(視聴者の言葉、本人のフレーズ、根拠、よくある誤解)を反映し、評価を付け、品質チェックを通過したものから上位3つを最初に表示します。それぞれにパターン名を残すため、効果のあるフックは新しい表現にして再投稿できます。/video-script rewrite <script>→ 本人のスクリプトを引き締めます。内容と事実は変えずに、フックを改善し、行を短くし、タイミングを確認して、自然な表現にします。変更点も示します。/video-script humanize <file, script slug or pasted text>→ スクリプト、キャプション、説明文、投稿など、あらゆるテキストを本人らしい表現にします。references/humanize.md に従い、変更前後のスコアも示します。humanize checkは報告のみを行います。
hook と humanize では、「The week」と「The mix」を省略し、voice.md と参考資料を読んだうえで、その作業だけを行います。
1. 1週間分
次の質問を1つだけします。「今週、実際に何がありましたか?」 答えやすいように、例を挙げます。数字を伴う成果、失敗、クライアントやフォロワーからの質問、学んだことや試したこと、使ったツール、会話の中で出た意見、反対していることなどです。
実際にあったことは、実績のあるコンセプトに合う限り、アイデアよりも優先します。次に、そのニッチで今日話題になっていること(製品の発売、トレンド、今週の価格変更など)を確認し、それに乗ったスクリプトを1本、週の最初に作ります。何もなければ、voice.md(信念、視聴者が犯す間違い、根拠)、audit.md(本人のアカウントで成果の高いトピック)、swipe.md をもとにトピックを5つ提案し、本人に選んでもらいます。
次に、動画を何本作るか(デフォルトは5本)、今週宣伝するものがあるかを確認します(ある場合は「Offer」動画を1本、なければ作成しません)。
2. 構成
各動画にタイプを設定します。執筆を始める前に、1週間分を計画します。
| タイプ | 内容 | 週5本の場合の標準数 |
|---|---|---|
| 教える | 1つの問題と、視聴者が今日から実践できる1つの解決策 | 2 |
| 実績 | 実際の成果と、それを生み出した要因 | 1 |
| ストーリー | ある瞬間、転機、学び | 1 |
| 意見 | ニッチ分野で一般的なアドバイスに反する主張 | 1 |
| オファー | 問題、それに対して作ったもの、対象者、依頼内容 | 0または1。2本にはしない |
各動画には、オファーとの距離も設定します。voice.md の「The ask」が示す段階(0〜3、script-rules.md)に基づき、そこでの週間構成に従います。
計画は表(番号、タイプ、トピック、コンセプト、最初に試すフックの型、オファーとの距離)で示し、執筆前に入れ替えられるようにします。同じフックの型を連続して使わず、1週間に同じタイプを3本以上入れません。
3. 各スクリプトを作成する
- 狙い:swipe.md のどのコンセプト(それに最も適した動画と、その x)を使うか、あれば最新ニュース、語りかける視聴者、覆す誤った思い込みや俗説(voice.md)、およびその段階の依頼文を示します。
- 3つのフック:hooks.md の異なる型から1つずつ選びます。それぞれを script-rules.md の評価基準で採点します。最も良いものを残し、残り2つは「その他のフック」に入れます。すべて7/10未満なら、さらに3つ作成します。
- 画面上のフック:6語以内で、最初の数秒間に表示します。話すフックに情報を加え、同じ文言をそのまま繰り返さないようにします。
- 本文:タイプに応じた構成(script-rules.md)に沿って書きます。1行につき1文とします。中盤近くに再度視聴者を引きつける一言を入れます。
- 締め:voice.md の依頼文を1回だけ伝えるか、冒頭につながる最後の一言にします。
- 映像メモ:話す台詞とは分けて、何を見せるか、強調表示する価値のある1〜4語(数字、成果、ツール名など)を記します。
- 時間:語数を数え、話すペース(voice.md、なければ160 wpm)で割ります。script-rules.md の各ビートのルールを確認し、提示前に修正します。
- 事実:数字、名前、成果はすべて voice.md または本人から伝えられた情報に基づくものとします。それ以外は
{{your number}}、{{client name}}に置き換え、「入力項目」に記載します。 - 人間らしい表現:references/humanize.md の手順1〜6をスクリプトに適用します(スクリプトごとのレポートは不要です)。声に出して読みます。本人が決して使わない表現(voice.md の「Words I never use」)、em dash、AIらしい型を避け、すべての事実をそのまま保ちます。スコアはスクリプトの Score 行に記載します。
- トリガーと品質ゲート:script-rules.md のトリガーを適切な箇所に少なくとも4つ入れ、その後、4つの品質ゲート(一般的すぎる、構成がない、差し替え可能、バイラル性)を確認します。ゲートに通らなかった場合は、提示前に書き直します。
4. 形式
video-agent/scripts/week-YYYY-MM-DD.md(その週の月曜日の日付)に保存します。週ごとに1ファイルとし、単独のスクリプトも現在の週のファイルに入れます。
# Week of 2026-10-05
| # | Slug | Type | Formula | Offer | Length |
|---|---|---|---|---|---|
| 1 | hooks-too-long | Teach | The mistake | 0 | 40 s |
## 1. hooks-too-long
**On screen:** Your hook is *too long*
**Hook:** Your first sentence has 20 words. Nobody hears word 12.
```script
Your first sentence has 20 words. Nobody hears word 12.
By then, most people already swiped.
I checked my last {{number}} shorts.
The ones that held past 3 seconds had short hooks.
Under 12 words, with the topic in the first 5.
Here's the part everyone skips.
Cutting is easy, picking the one point is the hard part.
So write your hook, then cross out everything before the point.
"In this video I'll show you how to write better hooks."
Becomes: "Your hook is too long."
Same idea, half the words, and it lands before they swipe.
Try it on your next three videos.
Follow for one script fix a day.
```
**Visual notes**
- line 1 → callout: 20
- line 5 → callout: 12 words
- line 9 → show: the long hook, crossed out
**Ask:** Follow for one script fix a day.
**Other hooks**
- (Stop / start) Stop explaining in your hook. Start with the result.
- (Their words) "My hook is fine, it's the algorithm."
**Triggers:** gap 0s, self-recognition 0s, proof 6s, pattern break 20s, specificity 28s
**Score:** hook 8/10 · human 10/10 · 111 words · 40 s at 165 wpm · offer 0 · gates ✓
**To fill:** {{number}}
script ブロックには、話す台詞だけを入れます。クリエイターは録画時にそれを読み、video-edit はそれを読んで編集します。
次に READY の概要を表示して、返答を待ちます。
READY · week of 2026-10-05 · 5 scripts (Teach, Proof, Story, Opinion, Teach) · 38 to 52 s
Saved: video-agent/scripts/week-2026-10-05.md
To fill: 3 placeholders
Reply yes to log them, or tell me what to change.
承認を得たら、各スクリプトについて1行を video-agent/log.md に追加します。
2026-10-05 | hooks-too-long | Teach | The mistake | why long hooks lose viewers
5. 引き継ぎ
その週の表と最初のスクリプト全文を表示し、変更点を尋ねます。次の手順:各スクリプトを録画します(スマートフォン、カメラ、ウェブカメラのいずれかを使い、スクリプトごとに1テイクで video-agent/takes/<slug>.mp4 に保存)。次に /video-edit <slug>、その後 /video-publish <slug> を実行します。
正直な限界
- 優れたスクリプトを書いても、再生数が保証されるわけではありません。トピック、タイミング、伝え方、運も同じくらい重要です。
- フックのスコアは執筆用チェックリストであり、予測ではありません。
- スクリプトがクリエイター本人らしく聞こえるのは、voice.md に本人の実際の言葉が記されている場合だけです。内容が薄い音声ファイルでは、一般的なスクリプトになります。更新してください。