mcpField
S
studio-script

studio-script

github.com/melvynxマーケティング・グロース64408 回インストール1 週間前に更新
リポジトリ

studio-script について

studio-script は、クリエイター自身の話し方で短尺動画の台本を書くための video-agent スキルです。提供された素材や参考ファイルをもとに、事実を作らずに台本、フック、リライト、分野調査を行います。

主な機能

  1. 011週間分の台本を計画
  2. 02フック案の生成と評価
  3. 03ファネル型・メイキング型台本の作成
  4. 04テキストのリライトと話し方の調整
  5. 05分野で伸びた動画の調査

活用シーン

  1. 01短尺動画の1週間分を企画
  2. 02クリエイターの話し方で草稿をリライト
  3. 03分野内のフックの型を調べる

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/melvynx/video-agent-skills --skill studio-script

インストール後、Claude Code で/studio-scriptを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
ai-tells.md
funnel.md
hooks.md
humanize.md
making-of.md
script-rules.md
viral-research.md
viral.md

詳細

Studio Script

クリエイターが最高の調子の日に話すような台本です。短く、具体的で、次の30秒も見たくなるフックがあります。すべて本人の実際の1週間と、本人自身の言葉から作ります。何も創作しません。

執筆前に

次の順番で読んでください。

  1. video-agent/voice.md:本人がどんな人で、誰に向けて話し、どんな話し方をし、何を信じ、どんな実績があり、何を求めるのか。不足している場合:/studio-setup を提案します(約10分。推奨)。または、今すぐ4つの質問をしてください(何をしているか、誰のためにしているか、どの言語で録画するか、視聴後に視聴者に何をしてほしいか)。
  2. video-agent/swipe.md:そのニッチで効果のあったフックと、さらに、実績を伴う、成果が特に高かった「コンセプト」(/studio-script viral から)。すべての台本は、そのいずれかを土台にします(references/viral.md)。不足している場合:まず /studio-script viral を実行してください(5分)。これをせずに1週間分の台本を書くのは、目隠しで書くようなものです。
  3. video-agent/audit.md があれば、それも読みます:本人のアカウントで効果があるもの(/insta-audit から)。「来週のための3つの変更」は今週の台本に反映し、効果の高いトピック、長さ、フックの型を優先します。本人のデータはニッチのデータより優先されます。
  4. video-agent/log.md の最後の20行:すでに使ったトピックとフックの型を確認します。依頼がない限り、過去4週間に使ったトピックを繰り返してはいけません。
  5. references/viral.md、references/hooks.md、references/script-rules.md、references/funnel.md(新しい人に届く動画はファネルです)、references/making-of.md(クリエイター自身が体験したProofとStoryの動画はメイキング動画です)、references/humanize.md。

本人には本人の言語で話しかけ、台本は本人が録画する言語で書いてください。

モード

  • /studio-script → 1週間分の台本(デフォルトは5本)。
  • /studio-script <topic or idea> → 台本を1本。
  • /studio-script funnel <topic> → ファネル台本(references/funnel.md):広い入口(多くの場合、そのニッチの視聴者がすでに議論している、意見の分かれる主張)から始め、ブリッジ、緊張感、転換、クリエイターのニッチに絞り込んだ要点、控えめな呼びかけへと続きます。入口の広さで評価したブリッジを3つ、要点を最初に書き、広げるための2つのテストをメモ行に記載します。
  • /studio-script making-of <what you did> → メイキング台本(references/making-of.md):クリエイターが実際に行ったことと、その実際の成果を、4つの段階(状況、行動、数値で示す結果、教訓)で伝えます。アドバイスは最後にだけ入れます。まだ結果がない場合は、シリーズのエピソード1にします。
  • /studio-script hook <script or topic> → フック作成ツール:少なくとも10種類の型から20個のフックを作り、swipe.md のコンセプト別にまとめます(実証済みのコンセプトを先に)。voice.md を反映し(視聴者の言葉、本人の言い回し、実績、思い込み)、採点して品質基準を通過させ、最良の3つを先頭に表示します。それぞれのフックには型の名前を残すため、効果のあったフックは新しい表現で再投稿できます。
  • /studio-script rewrite <script> → 本人の台本を引き締めます。内容と事実はそのままに、フックを改善し、行を短くし、タイミングを確認し、人間らしい表現にします。変更点も示します。
  • /studio-script viral [@handles or niche keywords] → そのニッチで何が特に高い成果を上げているかを測定します。10〜12アカウントの最近のShortsを各アカウントの中央値と比較して採点し、外れ値となった動画それぞれの最初の3秒、そのフックの型、video-agent/swipe.md に追加するコンセプトを調べます(references/viral-research.md)。約5分。月1回実行します。
  • /studio-script humanize <file, script slug or pasted text> → あらゆる文章(台本、キャプション、説明文、投稿)を本人らしい表現にします。references/humanize.md に従い、変更前後のスコアも表示します。humanize check は結果の報告だけを行います。

hook、humanize、viral では、「The week」と「The mix」を省略します。voice.md と参照資料を読み、そのタスクだけを実行してください。

1. 今週

質問は1つだけです。「今週、実際に何がありましたか?」 答えやすいように、結果(数字も含めて)、失敗、クライアントやフォロワーから受けた質問、学んだことや試したこと、使ったツール、会話の中で出た意見、納得できないことなど、答えのヒントを提示してください。

実際の出来事は、実績のあるコンセプトに合っていれば、アイデアよりも効果的です。次に、そのニッチで今日注目を集めているもの(新製品の発売、トレンド、今週の価格変更など)を確認します。それに乗る台本を1本、週の最初に作ります。何もなければ、voice.md(信念、視聴者が犯しがちなミス、実績)、audit.md(特に成果が出ているトピック)、swipe.mdからトピックを5つ提案し、選んでもらいます。

次に、動画の本数(デフォルトは5本)と、今週宣伝したいものがあるかを尋ねます(ある → Offer動画を1本、ない → なし)。

2. 構成

各動画にタイプを割り当てます。執筆を始める前に、週の計画を立てます。

タイプ目的週5本の場合のデフォルト
Teach1つの問題と、視聴者が今日から実践できる1つの解決策2
Proof実際の成果と、それを生み出した要因1
Storyある瞬間、転機、学び1
Opinionニッチでよくあるアドバイスに反する立場1
Offer問題、それに対して作ったもの、対象者、依頼0または1、2本は不可

新しい人に届けることを目的とするTeachまたはOpinionは、ファネル形式で書きます(references/funnel.md)。クリエイター自身が経験したProofまたはStoryは、メイキング形式で書きます(references/making-of.md)。

各動画には、voice.mdの「The ask」が示す、どの段階を目指すかというオファーとの距離も割り当てます(0~3、script-rules.md)。そこで定められた週の構成に従います。

計画は、番号、タイプ、トピック、コンセプト、最初に試すフックの型、オファーとの距離を含む表で示し、執筆前に入れ替えを受け付けます。同じフックの型を連続して使わず、1週間に同じタイプを3本使うこともありません。

3. 各台本を書く

  1. 狙い:swipe.mdのどのコンセプトを使うか(最も成果の出ている動画とそのxも含む)、最新ニュースがあればそれ、想定する視聴者、崩すべき誤った信念や俗説(voice.md)、その段階の依頼文。
  2. フックを3つ:hooks.mdの異なる型をそれぞれ使います。script-rules.mdの評価基準で採点します。最もよいものを残し、残り2つは「Other hooks」に記載します。すべて7/10未満なら、さらに3つ作成します。
  3. 画面上のフック:6語以内で、最初の数秒間に表示します。話すフックを補足し、同じ文言をそのまま繰り返してはいけません。
  4. 本文:タイプごとの構成(script-rules.md)に沿って書きます。1行に1文とし、中盤近くに再フックを入れます。
  5. 締め:voice.mdにある依頼を1度だけ言うか、冒頭につながる最後の一文にします。
  6. ビジュアルメモ:話すセリフとは分けて、何を映すかと、ボードに表示する価値のある1~4語(数字、結果、ツール名、手順のリストなど)を記載します。
  7. 時間:語数を数え、話す速度で割ります(voice.mdに指定があればそれを使い、なければ160 wpm)。script-rules.mdのビートに関するルールをすべて確認し、提示する前に修正します。
  8. 事実:数字、名前、結果はすべてvoice.mdまたは本人から提供された情報に基づくものとします。それ以外は{{your number}}、{{client name}}のような形式にして、「To fill」に記載します。
  9. 人間らしさ:references/humanize.mdを台本に適用します(手順1~6。台本ごとのレポートは不要)。声に出して読むように確認します。本人が決して使わない表現(voice.mdの「Words I never use」)、em dash、AIらしい型を避け、すべての事実を維持します。スコアは台本のScore行に記載します。
  10. トリガーとゲート:script-rules.mdにあるトリガーを少なくとも4つ、それぞれ適切な箇所に入れ、その後4つの品質ゲート(一般的すぎる、構成がない、他と区別がつかない、バイラル)を確認します。ゲートを通過できなかった場合は、提示前に書き直します。

4. フォーマット

video-agent/scripts/week-YYYY-MM-DD.md(その週の月曜日)に保存します。週ごとに1ファイルとし、スクリプトが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 → board: 20
- line 5 → board: 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 ブロックには、話すセリフだけを記載します。撮影時にはクリエイターがこれを読み上げ、short-editing はこれを読んで編集します。

続いて、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.

はい、という返答の後、video-agent/log.md にスクリプトごとに1行を追加します。

2026-10-05 | hooks-too-long | Teach | The mistake | why long hooks lose viewers

5. 引き継ぎ

今週の表と最初のスクリプト全文を表示し、変更点を尋ねます。次の手順では、各スクリプトを録画します(スマートフォン、カメラ、またはウェブカメラを使用し、スクリプトごとにワンテイクで録画して、video-agent/takes/<slug>.mp4 に保存)。続いて /short-editing <slug> を実行し、その後 /publish <slug> を実行します。

正直な制約

  • 優れたスクリプトでも、再生回数が保証されるわけではありません。トピック、タイミング、話し方、運も同じくらい重要です。
  • フックのスコアは、文章作成のチェックリストであり、予測ではありません。
  • スクリプトがクリエイター本人らしく聞こえるのは、voice.md に本人の実際の言葉が記載されている場合だけです。情報が少ない音声ファイルではありきたりなスクリプトになるため、更新してください。

コメント