Communitygithub.com

alyshadotmd/video-editing

規劃並在影片初剪中放置 B-roll:逐行分析剪輯,決定哪些台詞需要 B-roll 及其鏡頭類型,從已標籤的 B-roll 資料庫中提取最佳匹配片段,列出尚需拍攝的內容,並在剪輯師批准後放置 B-roll。適用於已有初剪、且需要補充 B-roll、詢問所需 B-roll 或要求拍攝清單的情況。

video-editing 是什麼?

這是一個專為 Claude Code 和 Runneth 設計的 AI 技能,旨在協助影片剪輯流程中的 B-roll 挑選與放置。該技能的核心是從一個已標籤的 B-roll 資料庫(包含短片段和「依標籤搜尋」索引)中,根據剪輯師的邏輯,為初剪影片的每一句台詞選擇最合適的 B-roll。技能會先讀取初剪時間線和專案腳本,逐行分析台詞並決定所需的 B-roll 類型,然後從資料庫中精確提取最佳片段(通常只取 1-2 秒的精華部分)。如果資料庫中沒有合適素材,技能會生成「待拍清單」。最後,技能會以框架為單位精確放置 B-roll,確保與原始音訊完美同步,並避免出現閃爍或錯位。此技能支援 ffmpeg 或任何影片編輯軟體進行實際的剪輯輸出。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

B-roll 挑選

目標:在正確的台詞上放置正確的 B-roll,如同剪輯師親自挑選一般。B-roll 有兩個作用:為所說的內容提供背景資訊,並吸引觀眾繼續觀看。

此技能專為 Claude Code 和 Runneth 打造。它會讀取一個已標籤的 B-roll 資料庫:一個包含短片段的資料夾,以及一個帶有「依標籤搜尋」表格的索引(每個標籤對應其擁有的片段)。broll-processing 技能會建立此資料庫,任何包含已標籤片段的資料夾也同樣適用。放置片段需要使用 ffmpeg 或任何影片編輯器。

與剪輯師溝通時,使用簡單明瞭的口語,一次只討論一個想法。

開始之前:所需工具

在 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-roll 已在資料庫中

此技能會從已標籤的 B-roll 資料庫中放置片段。在規劃之前,請先確認此影片的所有 B-roll 檔案都已存在於資料庫中,並附有拍攝檔案。任何未處理的原始 B-roll 都需先透過 broll-processing 技能處理,然後再回到此處。

步驟 1:讀取初剪

  1. 取得初剪的時間線:每一句台詞及其在剪輯中的開始和結束時間。帶有字詞時間戳的逐字稿效果最佳。
  2. 閱讀專案的相關資訊:腳本以及 B-roll 資料庫中的品牌拍攝檔案(每個保留的片段及其標籤和選取原因)。

步驟 2:決定每句台詞的需求

對於每一句台詞,寫下其內容以及能夠展示此內容的鏡頭類型(使用資料庫中的標籤)。這就是片段獲得意義的地方:同一個哈欠,在一個影片中可能是「之前」的狀態,在另一個影片中則可能是引起共鳴的時刻。規則(按優先順序):

  1. 在放置任何東西之前,先規劃整個影片。 不要按順序填補台詞。首先瀏覽最強烈的鏡頭,將每個鏡頭分配給它最符合字面意思的台詞,然後用剩下的鏡頭填補其餘台詞。一個鏡頭如果過早用在一個不精確的匹配上,之後就無法用在完全吻合的地方(躺在床上看書應該屬於「把它帶到床上,一邊看書」,而不是之前的「睡前例行公事」台詞)。
  2. 字面展現台詞內容。 字面意思是,即使關閉聲音,觀眾僅透過鏡頭也能理解台詞。僅有相關的動作不算數:拍鬆枕頭是一個任務,不是「放鬆身心」。「這個剛送達」需要完整的未拆封包裹;「這些食材」需要有人指著食材;「努力撐過一天」需要疲憊的臉、嘆氣或打哈欠。
  3. 將產品與當下情境匹配。 送達意味著完整的包裹;睡前例行公事意味著正在使用的產品。使用觀眾在故事該時間點會預期看到的型態。
  4. 使用長片段中最佳的 1 到 2 秒。 挑選動作最多的片段:鏡頭拍攝的主要動作(拉起毯子),絕不是之前或之後的繁瑣動作。特寫鏡頭可作為短暫的重點。
  5. 將相關片段串聯成一個小故事。 開箱:撕開頂部、展示內部、拿出一個。使用產品:打開、倒出、混合、啜飲。在沙發上工作:接著躺下小睡。將一個動作的短片段連續放置(半秒撕開袋子、半秒打開、半秒拿出一個包裝)就能構成一個有力的小故事。
  6. 快樂的創作者與產品一起出現的鏡頭應放在接近結尾處。 將它放在行動呼籲附近,或任何本身不具視覺性的台詞上。
  7. 片段的意義由其整個拍攝內容決定。 在使用片段的一部分之前,請閱讀拍攝檔案的重點和完整片段。在沙發上工作然後小睡,表現了某人度過疲憊的一天;它顯示了白天的疲憊,因此適合「撐過一天」的台詞,絕不適合「晚上躺在床上」的台詞。
  8. 切勿重複同一個時刻。 從同一段原始 B-roll 影片剪出的兩個片段,如果顯示的是同一個時刻(即相同或相似的標籤,例如兩個在櫃檯前疲憊的鏡頭、兩個哈欠、兩次啜飲),則不能同時出現在同一剪輯中。來自同一影片但顯示不同內容(打開、混合、杯子特寫)的片段可以分開使用。當一個影片有兩個相似的時刻時,將較強的那個放在最匹配的台詞上,並為另一個台詞尋找其他素材,或者讓該台詞保留人物說話的畫面。一個動作的連續片段構成的迷你故事(規則 4)視為一次使用。 將一個影片的素材集中使用,而非分散。 在一段剪輯中,每個 B-roll 影片的出現位置不應超過兩處。當一個影片有數個好鏡頭時,將相關的鏡頭集中在一個迷你故事中,放在最合適的台詞上(帶著貓上床,然後喝著飲料看書),而不是分散在整個影片中,這會讓人感覺重複。產品特寫鏡頭(任何標籤為 closeup: 的鏡頭,例如攪拌杯子的鏡頭直接對著鏡頭)是例外:它們可以獨立作為重點,不計入該影片的兩次使用限制。
  9. 如果一句台詞沒有真正合適的片段,則保留人物說話的畫面。 一個「差不多」但展示不同內容的片段,比完全沒有 B-roll 更糟。只有在該片段對影片有明顯幫助時,才將缺少的鏡頭加入待拍清單。

步驟 3:提取片段

  1. 對於每一句台詞,在資料庫的「依標籤搜尋」表格中尋找匹配的片段。資料庫中的片段兩側各帶有 1 秒的緩衝,因此實際選取時需修剪到實際的挑選範圍。
  2. 生活風格片段(不含產品)可以來自任何品牌的拍攝。產品片段則僅限於此品牌。
  3. 當資料庫中沒有合適素材時,該台詞將被列入「待拍清單」,並附上一行鏡頭描述。

步驟 4:向剪輯師展示規劃

顯示一個簡短的表格:台詞編號、台詞內容、B-roll(拍攝檔、片段、精確秒數)以及選取原因。接著是待拍清單。剪輯師可以批准、交換或刪除。一旦剪輯師同意,即可放置片段。

步驟 5:放置

  1. 從每個已批准的片段中修剪出所需的片段。
  2. 將其疊在剪輯中對應的台詞上,底下的講話者音訊保持不變。在剪輯點或字詞間的空隙處切入和切出 B-roll。
  3. 以幀數而非秒數進行作業。 在放置任何東西之前,將每個 A-roll 剪輯點和每個 B-roll 邊緣轉換為整數幀數(時間 x 幀率,四捨五入),並以幀數為單位開關片段。像 28.867 秒 @30fps 這樣的時間點會落在幀與幀之間,並留下一個殘影幀。
  4. 堆疊的 B-roll 應精確對齊。 當兩個 B-roll 片段相鄰放置時,第二個片段的開始幀數應等於第一個片段的結束幀數,這樣人物說話的畫面就不會在中間漏掉一幀。
  5. 靠近剪輯點的 B-roll 邊緣應對齊剪輯點。 當 B-roll 邊緣落在 A-roll 剪輯點附近約 0.3 秒內(30fps 下約 9 幀)時,將該邊緣移動到剪輯點的幀上。如果一個片段從台詞的第一個字開始,則改為從該台詞的剪輯點開始,這樣人物說話的畫面就不會在 B-roll 出現前閃爍幾幀。
  6. 放置後重新檢查剪輯:音訊長度與影片長度匹配、每個 B-roll 片段與其台詞對齊、以及字幕(如果有的話)在新畫面上能清晰閱讀。
  7. 沒有任何片段短於約 0.3 秒。 建立一份最終影片中所有邊緣的清單,包含 A-roll 剪輯點和 B-roll 邊緣,以幀數表示。兩個邊緣之間的每個片段(無論是人物說話或 B-roll)至少為 30fps 下的 9 幀。較短的片段即為閃爍,是不合格的。僅靠場景檢測無法發現這些問題,因為同一個人的兩個鏡頭看起來很像,因此請檢查清單,然後擷取每個邊緣兩側的幀數進行確認。測量 A-roll 剪輯點實際所在位置(每個計劃剪輯點附近畫面變化最大的那幀),而不是信任從秒數轉換而來的時間點。
  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.

相關技能