Communitygithub.com

alyshadotmd/video-editing

第一カットからBロールを計画・配置するスキル:カットを一文ずつ確認し、どの行にどんなショットのBロールが必要かを判断し、タグ付けされたBロールライブラリから最適な瞬間を抽出し、未撮影のものをリストアップし、編集者が承認したらBロールを配置します。

video-editing とは?

このスキルは、Claude CodeやRunnethなどのAIエージェント上で動作し、動画編集者が第一カット(Aロール)に対してBロールを計画・配置するプロセスを自動化します。具体的には、カットのトランスクリプトを一文ずつ解析し、各発言に最も適したBロールの種類とショットを判断します。タグ付きBロールライブラリ(ショートクリップとタグインデックスで構成)から最適なクリップを検索・抽出し、編集者の承認を得た上で、ffmpegなどを用いて正確に配置します。配置時はフレーム単位でのタイミング調整、カット点へのスナップ、0.3秒未満のフラッシュ防止など、プロフェッショナルな品質を保証します。また、使用可能なクリップがライブラリにない場合、撮影すべきショットのリストを生成します。このスキルは、Bロール追加やショットリスト作成の要求に応えるために、第一カットが完成した後で使用されます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alyshadotmd/video-editing/tree/HEAD/skills/broll-selection

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

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

ドキュメント

Bロール選定

目標:適切なBロールを適切な行に、編集者が選ぶように選ぶこと。Bロールには2つの役割があります。発言に文脈を加えることと、視聴者を引きつけ続けることです。

このスキルは Claude Code および Runneth 向けに構築されています。タグ付きBロールライブラリ(ショートクリップのフォルダと「タグで検索」テーブルを持つインデックス)から読み取ります。broll-processingスキルがライブラリを構築しますが、タグ付きクリップのフォルダであればどれでも機能します。クリップの配置にはffmpegまたは任意の動画編集ソフトが必要です。

編集者とは、平易な日常語で、一度に1つのアイデアで会話してください。

開始前:ツールについて

Runnethでは、すべてがインストール済みです:このセクションはスキップしてください。

Claude Codeでは、このスキルには video-editing-setup スキルがインストールする無料のビデオツールが必要です。~/.video-editing-tools/bin/ffmpeg -version が実行できるか静かに確認してください。実行できる場合は、このスキルが ffmpeg、ffprobe、python3 と指定する場所で ~/.video-editing-tools/bin 内のツール(ffmpeg、ffprobe、python)を使用し、続行してください。実行できない場合は、最初にvideo-editing-setupスキルに従い、その後ここに戻ってきてください。

ステップ0:Bロールがライブラリにあることを確認する

このスキルはタグ付きBロールライブラリからクリップを配置します。計画の前に、この動画のすべてのBロールファイルがライブラリ内にあり、シュートファイルも存在することを確認してください。ライブラリにない未処理のBロールは、最初に broll-processing スキルで処理してから、ここに戻ってきてください。

ステップ1:第一カットを読む

  1. カットのタイムラインを取得します:カット内のすべてのセリフ行とその開始・終了時間。単語単位のタイミングがあるトランスクリプトが最適です。
  2. プロジェクトについて既知の情報を読み込みます:スクリプトと、Bロールライブラリ内のブランドのシュートファイル(保持されている各クリップとそのタグ、選択理由)。

ステップ2:各行に必要なものを判断する

各行について、発言内容と、それを示すショットの種類を、ライブラリのタグを使って記述します。ここでクリップに意味が付与されます。同じあくびでも、ある動画では「その前」を意味し、別の動画では共感を呼ぶ瞬間になります。ルール(優先順位順):

  1. 何かを配置する前に、動画全体を計画すること。 行を順番に埋めてはいけません。まず最も強いショットを特定し、それぞれに最も文字通り合う行を与え、その後残りの行を残ったもので埋めます。あるショットを緩い適合で早い段階に使ってしまうと、後で完全に適合する行に使えなくなります(「夜のルーティン」行ではなく「本を読みながらベッドに持っていく」行に、ベッドで読書している様子を配置するなど)。
  2. 行を文字通りに示すこと。 文字通りとは、音声をオフにした視聴者がショットだけからその行を理解できることを意味します。近い動作だけでは不十分です:枕をフカフカにするのは作業であり、「くつろぐ」ではありません。「これが届いたばかり」には未開封のパッケージ全体が必要です。「材料」には材料を指さしている人が必要です。「一日を乗り切ろうとしている」には疲れた顔、ため息、またはあくびが必要です。
  3. 製品をその瞬間に合わせること。 配達ならパッケージ全体、夜のルーティンなら使用中の製品。視聴者がそのストーリーの時点で期待する形を使用します。
  4. 長いクリップの最良の1~2秒を使用すること。 最も動きのある部分(クリップが撮影された主な動作:毛布を引き上げる)を選び、その前後の余計な動作は避けます。クローズアップは短いアクセントとして機能します。
  5. 関連するクリップを連鎖させてミニストーリーにする。 開梱なら「上部を引き裂く」「内部を見せる」「1つ取り出す」。製品使用なら「開ける」「注ぐ」「混ぜる」「すする」。ソファで作業→横になって昼寝。1つの動作の短い断片を連続して配置する(「袋を破る0.5秒」「開ける0.5秒」「パケットを取り出す0.5秒」)ことで、強力なミニストーリーが生まれます。
  6. 製品と共にいる幸せなクリエイターは、終盤に近い場所に配置すること。 コールトゥアクションの近く、または視覚的に単独で成立しない行に使用します。
  7. クリップは、そのシュート全体が示す内容を意味する。 クリップの一部を使用する前に、シュートファイルのポイントとクリップ全体を読むこと。ソファで作業してからそこで昼寝することは、疲れた一日を乗り切る様子を示しています。つまり日中の疲れを示すため、「一日を乗り切る」行に適合し、「夜にベッドで横になる」行には決して適合しません。
  8. 同じ瞬間を繰り返さない。 同じ元のBロール動画から切り出された2つのクリップは、同じ瞬間(同じまたは類似のタグ:カウンターで疲れたショット2つ、あくび2つ、すする2つ)を示す場合、1つの編集に両方入れることはできません。異なるもの(開ける、混ぜる、グラスのクローズアップ)を示す同じ動画からのクリップは、別々に使用しても問題ありません。動画に似たような瞬間が2つある場合、強い方を最も適合する行に配置し、もう一方の行には別のものを見つけるか、その行を話している人のままにします。ミニストーリーを形成する連続した動作の断片(ルール4)は、1回の使用としてカウントします。 動画をばら撒くのではなく、まとめて使用すること。 1つの編集で、1本のBロール動画から最大2箇所以上使用しないことを目指します。動画に良い瞬間が複数ある場合、関連するものを、適合する行にある1つのミニストーリーにまとめます(猫と一緒にベッドに入る、その後飲み物を飲みながら読書する)。動画全体にばら撒くと、繰り返し感が生じます。クローズアップの製品ショット(closeup: タグが付いたもの、例えばレンズのすぐ近くでグラスをかき混ぜるなど)は例外で、単独のアクセントとして独立し、動画の2箇所制限にはカウントしません。
  9. 本当に適合するクリップがない行は、話している人のままにしておく。 異なるものを示す「だいたい合う」クリップは、Bロールがないよりも悪いです。明らかに動画の助けになる場合にのみ、欠落しているショットを未撮影リストに追加してください。

ステップ3:クリップを取り出す

  1. 各行について、ライブラリの「タグで検索」テーブルで一致するクリップを検索します。ライブラリのクリップは両側に1秒のバッファを持っているので、実際の選択部分にトリミングします。
  2. ライフスタイルクリップ(製品を含まないもの)は、どのブランドのシュートからでも取得できます。製品クリップはこのブランドからのみ取得します。
  3. ライブラリに適合するものがない場合、その行は「未撮影」リストに、ショットの簡潔な説明とともに追加されます。

ステップ4:計画を編集者に示す

簡潔な表を示します:行番号、発言内容、Bロール(シュート、クリップ、正確な秒数)、理由。次に未撮影リスト。編集者が承認、交換、または削除します。編集者がGOと言ったらクリップが配置されます。

ステップ5:配置する

  1. 承認された各断片を元のクリップからトリミングします。
  2. カットの該当行に重ね、話者の音声はそのまま下で流します。Bロールはカットポイントまたは単語間の隙間でイン・アウトします。
  3. 秒ではなくフレーム番号で作業すること。 すべてのAロールカットとBロールの端を、配置前に全体のフレーム番号(時間×フレームレート、四捨五入)に変換し、断片のオン・オフをフレーム番号で制御します。28.867秒(30fps)のような時間はフレーム間に落ち、はみ出たフレームが表示される可能性があります。
  4. 積み重ねたBロールはフレーム単位でぴったり重ねること。 2つのBロール断片が隣接する場合、2つ目は1つ目が終了した正確なフレーム番号で開始し、間に話している人のフレームが1つも入らないようにします。
  5. カット近くのBロールはカットにスナップすること。 Bロールの端がAロールカットの約0.3秒(30fpsで9フレーム)以内にある場合、その端をカットのフレームに移動します。行の最初の単語で開始する断片は、代わりにその行のカットで開始し、Bロールの前に話している頭が数フレーム表示されるのを防ぎます。
  6. 配置後に編集を再確認します:音声の長さが動画の長さと一致すること、すべてのBロール断片がその行に揃っていること、キャプション(ある場合)が新しい映像の上でもきれいに読めること。
  7. 約0.3秒未満のセグメントを作らないこと。 完成した動画のすべてのエッジ(AロールカットとBロール端を合わせたもの)のリストをフレーム番号で作成します。2つのエッジ間のすべてのセグメント(話している頭またはBロール)は、30fpsで少なくとも9フレーム必要です。それより短いものはフラッシュとなり不合格です。シーン検出だけではこれらを見逃します(同じ人の異なるテイクは見た目が似ているため)。リストを確認し、各エッジの両側のフレームを取得して確認してください。秒から変換された時間を信頼するのではなく、Aロールカットが実際にどこに落ちるか(各計画カット付近で最大の画像変化があるフレーム)を測定します。
  8. 配置に関する編集者のフィードバックを、上記ステップ2の一般的なルールに変換します。新しいルールを追加するのではなく、ルールを書き換え、統合します。

Individual skills in this repo

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

alyshadotmd/video-editing

Turn raw talking-head footage full of repeated takes (one long recording, or several recordings of the same script) into a tight rough cut. Find every take of every line, judge each take on its words, sound and picture, pick the keeper for each line, and either show the editor the picks first or go straight to the cut. The cut is checked so no word is chopped and no pause is left in before anyone sees it. Built for Claude Code and Runneth. Use when someone uploads raw talking-head footage and asks to find the takes, pick the best ones, make a cut list or rough cut it. Triggers: "process my a-roll", "find my takes", "pick the best takes", "rough cut this", "cut list", "edit my talking head", "which take is best

alyshadotmd/video-editing

Turn raw b-roll footage into a tagged, searchable library of short clips. Watch each b-roll video once, tag every useful moment with timestamps, pick the moments worth keeping (the editor picks, or the AI picks on its own if the editor says so), cut only those picks with a 1-second buffer, and learn the editor's taste from their reasons. Use when someone uploads b-roll, asks to tag, bank or label b-roll, or asks to find a kind of shot ("find me unboxing b-roll"). Triggers: "process my b-roll", "tag this b-roll", "bank this b-roll", "b-roll library", "find me unboxing b-roll", "do we have b-roll of", "label my b-roll

alyshadotmd/video-editing

>- Add burned-in captions to a vertical (9:16) talking-head video: exact word timings, one word at a time or short chunks broken by meaning, white outlined Figtree Bold with an optional highlighted word, placed in the safe area clear of the face and the hook headline. Built for Claude Code and Runneth. Use after framing and the headline, when someone asks for captions, subtitles or on-screen words.

関連スキル