Communitygithub.com

ビジュアルディレクター

話者の発言をビートごとに視覚的に説明するポップアップグラフィック(チップ、数字、チャットウィンドウ、チェックリスト、図など)を計画します。新規リール作成時や、ユーザーが「もっとポップアップを」「ここを図解して」「チェックリストを追加して」と依頼した際、または「どんなグラフィックを追加できる?」と問い合わせた際に使用します。

ビジュアルディレクター とは?

このスキルは、トーキングヘッド形式のリールにおいて、話者の発言内容をリアルタイムで視覚的に補足する「ビジュアルディレクター」です。発言のビート(区切り)ごとに、リストはチップとして、数字はカウントアップとして、プロンプト入力はチャットウィンドウとして表示するなど、小さなグラフィック要素を頭の周りに配置し、発言と同期させます。このスキルは、`build.json` の `visuals` 配列を計画する役割を担い、配置やアニメーション、効果音はエンジンが自動処理します。ユーザーが「もっとポップアップを増やして」「この部分を図解して」「ここにチェックリストを入れて」と指示した場合や、「どんなグラフィックを追加できる?」と質問した場合に、このスキルが起動します。また、密度(calm/steady/busy)の調整や、カスタムインサート(サブエージェントによる並行開発)、GIFやミームの追加(要リクエスト)など、高度なカスタマイズにも対応しています。複数のAIエージェントツール(Claude Code, Cursor, Codex等)で動作し、開発者はプロジェクトファイル(`edl.json`、`transcript.json`、`kit.json`)と連携しながら、リールの編集クオリティを大幅に向上させることができます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/visuals

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

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

ドキュメント

ビジュアルディレクター は何をしますか?

優れたトーキングヘッドリールは、話者の発言をビートごとに視覚的に示します。リストは各項目が発話されるたびにチップとしてポップインし、数字はカウントアップし、「プロンプトを入力した」という発言にはチャットウィンドウが入力を表示します。これらのピースは小さく、頭の周り(顔の上には決して配置しません)に配置され、発言が話された瞬間に正確に表示されます。

これを build.json → "visuals": [...] で計画します。エンジンが配置、キットのルック、アニメーション、およびポップアップごとの効果音を処理します。

1. リールをビートとして読み取る

ロックされた行(edl.json)を単語インデックスとともに確認します: python3 -c "import json;w=json.load(open('projects/<name>/transcript.json'))['words'];c=json.load(open('projects/<name>/cut.json'));[print(' '.join(f\"{x['i']}:{x['w']}\" for x in w[a:b+1])) for a,b in (l['words'] for l in c['lines'])]"

表示可能なものがあるビートすべてにマークを付けます:

  • 何かのリスト
  • 数字
  • ツールやアプリ
  • 動作(タイピング、送信、予約)
  • Before/After または A vs B
  • プロセスや手順
  • システム
  • 人物やストーリー
  • 時間の範囲
  • 却下されたアイデア
  • 強調する価値のあるキーワード

フィラー、トランジション、および対象物のない感情には何も配置しません。

2. 各ビートに適したピースを選ぶ

発言内容ピース例
リスト(「マーケティング、請求書、メール」)chips、各単語が発話されるたびに1アイテム各アイテムに word を指定
ドロップまたはクローズされるもの(「頭の中のあのタブすべて」)"close": true の chips
数字(「100+のクライアント」「午後3時」「2人のチーム」)number"value": "100+", "label": "clients"
行のキーワードまたはパンチラインword(思考や質問の場合は "style": "type")"text": "real *support*"
拒否するもの(「50ステップはダメ」「別のアプリは嫌」)strike"pre": "No", "text": "50 steps", "strike_word": i
プロンプトの入力、AIへの質問、DMの送信chat"prompt": "...", "reply": "..."(任意)
売上、メッセージ、予約、通知notify"app": "Stripe", "title": "New payment: €497"
完了した手順、ToDoリスト、成果checklist各アイテムに word を指定
「ステップ1 / 最初のもの / パート2」step"n": 1, "text": "*train* it"
変化やプロセス(A → B → C)flow各アイテムに icon と text を指定
システム、接続されたツール、「すべてを1か所に」hubcenter とアイコン付きの nodes
時間の範囲(「1ヶ月後…3年後」)scalemarks、from、to、move_word
クライアント、人物、誰かのストーリーperson"name": "Abby", "note": "coach", "meter": 3
A vs B、旧方式 vs 新方式versusleft(✗)/ right(✓)、right_word
ミームやGIF(ユーザーがリクエストした場合のみ)gif"file": "projects/<name>/memes/3.mp4", "caption": "me reading my old *captions*"
プロフィール、スクリーンショット、アプリphone"image": "assets/profile.png"(ユーザーが提供した画像のみ)

ピースのテキスト:

  • チップ、ノード、ラベルあたり1~3語
  • 話者の言葉を使用
  • タイトルケースは可ですが、chat と notify 以外では完全な文は禁止

アイコン: uv run tools/icons.py calendar money email で実際の名前を確認し、名前を推測しないでください。未知のアイコンがあるとビルドは停止します。

シグネチャーピース(ユーザー自身の素材が必要)

  • ユーザーの周りを回るリール: events 内で {"type": "orbit", "word": i, "until_word": j}(visualsではなく)。
    • ユーザーのコンテンツや作品群に関する行(「私はこれを300個作ってきた」)で使用。
    • brand/reels/ が必要。uv run tools/reels.py add <their reel files or a folder> で埋めてください:ユーザー自身がエクスポートしたリール、またはApifyが接続されている場合はプロフィールからダウンロードしたもの。
    • リールはユーザーの後ろと前を通過します。リールあたり最大1回。
  • コールトゥアクション用のInstagramプロフィールフォロー(「フォローしてね」「BRAINとコメントして」):
    • {"kind": "profile", "word": i, "until_word": j, "keyword": "BRAIN"};keyword は任意で、コメントシートに入力されます。
    • 数字は brand/instagram.json(name, handle, posts, followers, following, bio, avatar)からのみ取得します。ない場合は、実際の数字をユーザーに尋ねてください(またはApifyでプロフィールから取得)。決して推定したり捏造したりしないでください。
    • グリッドは brand/reels/ を使用します。Follow(およびPost)時にタップ音が鳴ります。
  • 別のクリエイターのリールをカードとして: "handle": "creatorname" を指定した gif。@ハンドルが下に表示されます。
    • 常にクレジットを表示し、ユーザーが指定したクリップのみを使用します。
  • カスタムインサート(適切なピースがない場合、例:使用しているアプリの再現、スクロールするファイルなど):サブエージェントを使用して構築します。下の「カスタムインサート」を参照。

モーション

キットの visuals.motion:gentle / snappy / bouncy / blur(ぼかしからシャープにポップイン)/ rise(落ち着いた編集風)。

  • word ポップに "style": "rise" を指定すると、各文字が行から一つずつ浮かび上がります。セリフ体のパンチワードに最適です。キットで visuals.word_style: "rise" と設定するとデフォルトにできます。
  • キャプションは captions.pop: "blur" でぼかしポップにできます。

カスタムインサート(並行サブエージェント)

  1. まずタイミングを固定: インサートがヒットする必要のある単語時間を、インサート独自のクロック(t = 0 は表示時)に変換します。
  2. インサートごとに1つのサブエージェントを生成し、バックグラウンドで並行して実行(Agentツール)、あなたはビルドを続けます。以下の内容を指示します:
    • 何を表示するか、およびそれが再生される行。ユーザーからの実際のデータのみを使用し、それ以外は汎用のプレースホルダーにします。実在の人物は使用せず、ロゴのコピーもしません。
    • 作業場所: projects/<name>/inserts/<insert-name>/index.html。それ以外には触れません。
    • サイズと持続時間: 例:900×700 px、2.6秒。描画するカードやウィンドウの外側は透明のまま。
    • 契約: window.renderAt(t) は、t 秒時点の正確な状態を描画します。タイマー、CSSトランジション、アニメーションは使用禁止。フレームは一つずつキャプチャされるためです。
      • ローカルフォントのみ(fonts/free/ からコピー)。
      • テキストは最低24 px、ユーザーのキットカラーを使用。
      • タイプされるテキスト:t の各ステップで1文字ずつ。
    • ビート: 時間を音声にロック。
    • レンダリング: uv run tools/insert.py <index.html> --dur <s> --w <w> --h <h> → insert.mov、アルファ付き。報告前に数フレーム確認。
    • 報告: パス、正確な持続時間、ビート時間(効果音用)。問題があれば報告。
  3. 配置: {"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}。ビートに sfx_extra クリックを追加。

ミームとGIF(リクエスト時のみ)

  • プロンプトなしでミームを追加しないでください。 ミームは好みの問題です。報告で提案することはできます(「ライン5にはDavid Roseの『えっ』が合いそう」)が、ユーザーが承諾した場合のみ追加します。

  • 検索: uv run tools/memes.py search "<show> <character> <emotion or words>" --project projects/<name>。例:「schitts creek david ew」や「the office michael no god please no」。

    • 最大6クリップをダウンロードし、SHEET=…/memes/sheet.png を出力します。シートを読み、ユーザーが説明した内容に合致するタイルを選びます(正しいキャラクター、正しい表情)。最初のものだけを選ばないでください。
    • タイルには左から右、上から下に1~6の番号が振られています。
  • ユーザー自身のファイル(「このGIFを使って」):uv run tools/memes.py add "<file>" --project projects/<name> で memes/own-1.mp4 が作成されます。画像も使用可能。

  • 配置:

    • {"kind": "gif", "file": "projects/<name>/memes/<n>.mp4", "word": i, "caption": "<their text>"}
    • キャプションは任意で、話者の言葉で、1箇所 *emphasis* を使用。デフォルトの長さは約2.6秒、または "until_word" を設定。
    • ワイドクリップは頭の上に、縦長クリップは顎の下に配置されます。"at": "full" で1.6秒の全画面カットアウェイになり、キャプションが上部に表示されます。
  • 報告内で: 使用したものを明記し、シートを開いて(open …/sheet.png)ユーザーが「ミーム3」と言えるようにします。他のクリップはすでにダウンロードされているため、file を変更してリビルドするだけで差し替えられます。

  • キーがない場合(MEMES=no-key):3分で完了する無料セットアップを提案します。

    1. ユーザーが developers.giphy.com にアクセスし、サインアップしてAPIアプリ(SDKではない)を作成し、キーをコピーします。
    2. ユーザーがキーをチャットに貼り付けます。
    3. あなたが brand/keys.json に {"giphy": "<key>"} として保存します。

    ユーザーにファイルを直接編集するよう依頼しないでください。それまでは、ユーザー自身のGIFファイルは引き続き使用できます。

  • 初回のみ言及: テレビや映画のミームを初めて使用する場合、それらのクリップはスタジオの所有物です。短い無音のリアクションGIFはInstagramで広く使用されていますが、わずかなリスクがあります。ユーザー自身のクリップにはリスクはありません。

3. タイミング(トランスクリプトの単語インデックス)

  • "word": i で、単語 i が発話されると同時にピースが表示されます。行の開始ではなく、ビートの最初の単語を使用します。
  • 各アイテムは独自の "word" を持つため、各チップ、チェック、ノードは発話と同時に表示されます。これが編集された感覚を生み出します。
  • ピースの終了:
    • "until_word": j で単語 j の後に終了
    • 指定がない場合、約2~3秒間、または最後のアイテムの1.4秒後に保持
    • "dur": 2.5 で長さを直接設定
  • 他の瞬間も単語にタイミングを合わせることができます:strike_word、reply_word(chat)、right_word(versus)、move_word / move_end_word(scale)、meter_word(person)、close_word(chipsのクローズ)。

4. キットによる密度(kit.json → visuals.density)

密度頻度印象
calm8~10秒ごとに1ピースクリーンな専門家による説明
steady4~6秒ごとほとんどのリール
busy2~4秒ごと、ほぼ連続高速「説明」スタイル

すべての密度でのルール:

  • 同時に表示されるピースは1つ。異なるゾーンにあり、同じビートに属する場合のみ、2つを重ねることができます。
  • フック(最初の約3秒)やステートメントの間は絶対に表示しないでください。ピースでステートメントを置き換えることはできます:busy では、最大1つのステートメントを使用します。
  • 同じ種類のピースを連続して使用しないでください。ただし、同じリストの続きの場合は除きます。
  • word ポップは、キャプションを凝縮または再構成する必要があり、単にミラーリングしてはいけません。同じ単語を表示する場合、エンジンはその間キャプションを非表示にします。それは機能しますが、「ビジネスの包括的な概要」に対する「全体のビジネス」のようなポップは、「非交渉事項」を繰り返すよりも価値があります。
  • ポップアップも表示される単語にハイライト(highlight_words)を設定しないでください。
  • chat はそれ自体で完結した小さなストーリーを再生します:プロンプトを入力し(キークリック音)、送信し(スワイプ音)、AIが「思考中」を表示し、reply が指定されている場合はそれを表示します。入力終了後、送信のために約1.5秒の間隔を空けてください。短い reply を話者の言葉で(説明する結果)入れると効果的です。
  • ピース間には短い呼吸の間隔(≥0.4秒)を残してください。
  • "at" は、デフォルトの配置が何かと衝突する場合にのみゾーン(top、left、right、chest)を上書きします。

5. ビルドと確認

uv run tools/build.py projects/<name>。ビルドは CHECK=…/check.png を出力します:各瞬間とポップアップの1フレーム。それを読み、以下の問題を修正します:

  • 読めない
  • 画面外
  • 顔を覆っている
  • キャプションと衝突している
  • 間違った単語を説明している
  • SAFE ZONE: 行にリストされている(Instagramのユーザー名、キャプション、いいね/コメント/シェアボタンの下に位置する)。すべて修正:ピースを移動("at")、テキストを短縮、または早く終了させ、なくなるまでリビルド。

画面に表示されるもの:

  • ポップアップ、フック、ステートメントのテキストにダッシュ(—)は使用しないでください。代わりにカンマ、ピリオド、または改行を使用します。
  • 実際の数字は、ユーザー自身のものであり、ユーザーが発言した場合のみ使用します。チャットウィンドウ、コメント、DMには汎用のプレースホルダーを使用し、実在の人物の名前や証拠としての捏造された結果は決して使用しないでください。
  • 画面上に別のクリエイターの投稿やリールが表示される場合は、その@ハンドルを表示します。

その後、new-reelスキルと同様に引き継ぎ、次のような1行を追加します:「12個のポップアップ:4つのタスクのチップ、『プロンプト』のチャットウィンドウ、AIシステムのハブ…」。

ユーザーから依頼があった場合

  • 「どんなグラフィックを追加できる?」 / 「オプションを見せて」: そのキットのカタログ動画が存在する場合は開きます(projects/*/catalog-<kit>.mp4)。ない場合は最新のリールでレンダリング:uv run tools/build.py projects/<name> --catalog。すべてのピースが1回ずつ、そのキットのルックで、ラベル付きで表示されます。長々とピースを説明しないでください。

  • 「もっと/少なくポップアップを」: このリールの密度を変更し、「常に」と言われた場合はキットの visuals.density に保存します。

  • 「ここにチェックリストを」 / 「フォローと言ったらプロフィールを表示して」: その単語に正確にそのピースを追加します。

  • スタイル(「枠線付きカード」「落ち着いたアニメーション」「太いアイコン」):キットの "visuals" ブロック:

    • card:solid / outline / glass
    • motion:gentle / snappy / bouncy
    • icon_stroke:1.5~2.5
    • radius
    • 色:accent、strong、alert、word、card_color;色名はキットから、または16進数値

    プリセットではなく、そのキットを変更します。

Individual skills in this repo

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

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

First-time onboarding for the Reels Editing Lab. Installs what's missing, runs a short brand interview, lets the user pick their look on their own footage, and saves it as their kit. Use when the user says "set me up", "get started", "onboard me", or when brand/kit.txt doesn't exist yet (the Lab hasn't been set up).

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

関連スキル