Communitygithub.com

motion-script

リンクからペーパーカット形式のリール台本を生成します。ソースから収集した事実を基に調査し、10ビートの骨格に沿った75〜95ワードの台本、バナーファクトトラック、バナーごとのセットを備えたステージングテーブル、そしてギャグパスを作成します。「台本を書いて」「このリポジトリをリール用に調査して」といった指示に使用します。

motion-script とは?

このスキルは、与えられたリンクやリポジトリから情報を収集し、ペーパーカットスタイルのリール台本を自動生成するエージェントスキルです。10ビートのスパイン(フック、証明、再フレーム、名前公開、デモ、エスカレーション、ピーク、キャッチ、ペイオフ、CTA)に基づき、75〜95ワードのナレーション、事実ベースのバナー、視覚的なセット(プロップUIを含む)、そしてギャグを一貫して作成します。各要素は相互に連携し、Voiceover、Banner、Setの3トラックが同期して進行します。プラットフォームとしてはClaude CodeやCursor、CodexなどのAIエージェント環境で動作し、事前にBRIEFとHOOKブロックが用意されている必要があります。ソースからの事実収集にはWeb検索やブラウザツールを使用し、スクリーンショットが取得できない場合はユーザーに依頼します。出力は`narration/script.json`と`STORYBOARD.md`に書き出され、次の`motion-storyboard`スキルに引き継がれます。このスキルは、製品のローンチ、新機能の解説、オープンソース代替案の紹介など、短尺動画向けの台本作成を効率化します。

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

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

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

ドキュメント

ペーパーカット台本

調査、台本、バナートラック、ステージング、ギャグは、各要素が互いに補完し合うため、まとめて作成されます。完全なシステム(フレーズバンクと2つのステージング例を含む)は references/storytelling.md にあります。ギャグとフォーマットのバンクは references/comedy.md にあります。

各ビートは、異なる役割を持つ3つのトラックで構成されます。

  • ボイスオーバー(キャプションタグとして表示):ストーリーを伝えます。カジュアルで二人称、文が変わるごとに内容が切り替わります。
  • バナー:ボイスオーバーが省略したハードな事実、数字、正直な注釈を追加します。1.8~3秒ごとに変わります。
  • セット:ボイスオーバーに登場する具体的な名詞を文字通り視覚化し、製品UIがデモを行います。バナーとともに変わります。

事前準備

  • インストール:最小限で十分です。背景シート(style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg)が必要な場合のみ $MOTION_LIB を解決してください。各画像の消費トークンは約0.7~1.5kなので、必要なステップでのみ開いてください。
  • episodes/NN-slug/research/facts.md の先頭にBRIEF、episodes/NN-slug/video/STORYBOARD.md の先頭にHOOKブロックが必要です。不足している場合は、先に motion-strategy または motion-hook を実行してください。
  • 調査にはWebアクセスまたは検索機能、およびスクリーンショット用のブラウザツールが必要です。これらがない場合は、ユーザーにスクリーンショットと事実を依頼してください。

1. 調査とラフなUI

  • ソースから事実を収集し、それぞれにソースを明記します:名前、メーカー、数字、価格、要件、制限、競合他社の数字。不明な点はマークしてください。
  • 主要なスクリーンショット(2~4枚)、実際のラベルとボタンテキスト、アクセントカラー、ヒーロー画像を取得します。動画は画面録画ではなく、ペーパーカットのプロップとしてUIのラフなバージョンを再構築します(references/storytelling.md セクション5)。
  • BRIEFから役割のフレーミングを確認します。製品の動作を捏造しないでください。役割フレーミングのメモは $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md を参照してください。
  • リストをBRIEFの下にある research/facts.md に書き込みます。台本、バナー、UI内のすべての数字は、このファイルに遡れる必要があります。

2. モードの選択

モード使用場面
オープンソースの代替有料製品に対する無料またはローカルな代替手段
ニュース発表 / 価値あり大企業による新しい有料ティア、モデル、機能
機能解放 / ハウツーツールの動作を変える隠し設定やコマンド

フックの公式と各モードの中盤:references/storytelling.md セクション6。フックの更新を適用します:ニュースではなく、ギャップとステークを開きます。

3. スパインに沿った台本

選択したフォーマットに基づき、75~95ワード、22~30秒(約3.5~4ワード/秒)、1.5~3秒ごとに新しいセットで台本を書きます。10ビート:

  1. フック(0~3秒)、motion-hook で既に固定済み
  2. 証明または緊張
  3. 再フレーム(「だから〜の代わりに、あなたは〜できる」)
  4. 名前公開(「〜という名前です」、フックより前には決して出さない)
  5. 動作の仕組み、具体的なデモ1つ
  6. エスカレーション(「そしてXは始まりに過ぎません。なぜなら〜」と、正確に3つの項目を積み上げる)
  7. ピーク(「そしてこれです:」と最大の数字)
  8. キャッチ(正直な反論)
  9. ペイオフ(「つまり〜」)
  10. CTA(「良いことに、[無料特典]を作りました。リンクはコメントにKEYWORD。”)

スピードを上げるのではなく、ビートを短くしてください。ルール:

  • 二人称、短縮形、短い節を「そして」「なぜなら」「つまり」でつなぐ。語彙は SERIES.md のオーディエンスレベルに合わせる。
  • 最初の文では、主題が別のものであっても大きなブランド名を出す。
  • すべての数字は具体的でソース付き。機能スタックは常に3項目。
  • 少なくとも1つの実際の制限を、VOまたはバナーに含める。CTAキーワードはトピックに関連した1つの短い単語。
  • 最後の行はフックのキーワードまたは数字を繰り返し、その後にキーワードを続ける。

narration/script.json に [{"id": "l1_hook", "text": "..."}, ...] の形式で、文または節グループごとに1行ずつ書き込みます。l1_hook 行はHOOKブロックのSAYです。各行が依存する1~2語(数字、ひねりの単語、判定)をステージングテーブルにマークします。motion-voice がこれらを使用します。

4. バナートラック

10~18個のバナー、3~7ワード、すべて大文字、それぞれ1つの事実、約2~3秒ごとに1つ。VOを決して繰り返さない:単独で読んでもファクトシートになるように。ヘッドラインの統計、価格の翻訳、信頼性の事実、入手可能性、少なくとも1つの正直な注釈、少なくとも1つの信頼/安全性の事実、機能の主張、少なくとも1つの競合他社との対比、CTA前の範囲/決定バナーを含める。タイプと例:references/storytelling.md セクション3。

5. ステージングテーブル

バナーごとに1行、HOOKブロックの下の STORYBOARD.md に書き込みます:

t (s) | VOの下の単語 | BANNER | SET(部屋+背景色) | HERO PROP(VOの具体的な名詞からの視覚的なダジャレ) | PRODUCT UIモーメント | MASCOTのアクションとコスチュームプロップ | GAG

  • バナーごとに新しいセット、背景色はローテーション。セットはVO行の単語を説明し、バナーは説明しません。
  • 数字は物理的なプロップになります:価格表示、秤、倍率の壁、ゲージ、メーター、レース。競合他社は固定されたカードとして表示され、ヒーローにはなりません。
  • マスコットは視聴者の代役であり、反応を示します。製品UIは紙のモニターやラップトップ上のラフな再構築で、偽のインタラクションを伴います。
  • CTAの前に、以前のセットへのコールバックを1つ入れます。CTAセットは、キーワードをタイピングしているコメントボックスを示します。
  • motion-storyboard がカメラとトランジションの列を追加します。

6. ギャグパス(台本の後、ステージング確定前)

GAG列を追加します。ボイスオーバーはストレートのまま;画像だけが馬鹿げています。

  1. リール全体で1つのフォーマット。
  2. バナーごとに1つのギャグ。ポイントを動作化したもの。references/comedy.md から。
  3. アイデアごとに1つのコスチュームプロップ。マスコット自身のアイテムは着用したままで、その上に1つのプロップを追加。
  4. キャッチラインで、苦闘するマスコットのビートを1つ。
  5. フレーム0にプロップを1つ配置し、CTAセットで変化して戻ってくる(「I'M OUT」→「FREE」など)。
  6. 説明不要で不条理な背景の瞬間を1つ。
  7. せいぜい1つのミーム。シリーズ独自のスタイルで再構築し、実際のクリップ、静止画、音声は使用しない。

どのギャグもバナー、キャプション、キーナンバーを覆ってはならず、各ギャグは1秒未満で読めること。

ゲート

  • 75~95ワード、22~30秒、1つの正直な制限、正確に3つのスタック。
  • すべての数字とバナーが facts.md に遡れる;バナーだけでもファクトシートとして読める。
  • 最終行がフックのキーワードまたは数字を繰り返している。
  • ギャグパス完了:アイデアごとにコスチューム、苦闘ビート、戻ってくるプロップ、1つの不条理な瞬間、せいぜい1つのミーム。

引き継ぎ

次は motion-storyboard です。narration/script.json と、episodes/NN-slug/video/STORYBOARD.md 内のHOOKブロックおよびステージングテーブルを読み取ります。台本のみの実行の場合は、ここで停止し、それらのファイルをユーザーに提供します。別のツール用のコピペ用ストーリーテリングプロンプトは references/storytelling.md セクション7にあります。

Individual skills in this repo

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

関連スキル