Communitygithub.com

raycfu/reel-builder

將一系列特效片段轉換成病毒式傳播的「我輸入了指令,Claude 就編輯了我的影片」短影格:聊天螢幕打出 /特效名稱,編輯過程從卡片內的發光圓點構築出來,放大至全螢幕,最後在「留言 關鍵字」的網格畫面結束。僅加入鍵盤打字音效,讓你可以自行疊上音樂。

reel-builder 是什麼?

Reel Builder 技能可將 4 到 8 個已套用效果的片段,包裝成模仿 ChatGPT / Claude 操作介面的聊天風格短影格。它會自動生成一個虛擬手機螢幕,在其中逐字打出 `/effect-name`,接著以動畫方式從橙色圓點構築出特效畫面,縮放至全螢幕顯示兩秒,最後以「Comment EFFECT」網格畫面結束,鼓勵觀眾留言互動。所有動畫皆以程式碼繪製,確保在不同機器上呈現一致。此技能支援 Claude Code、Cursor 等 CLI 工具,並可與效果技能 (`effects`) 搭配使用。使用者只需提供原始片段與已編輯片段,撰寫設定檔調整參數,即可一鍵渲染包含鍵盤打字音效的最終影片,並可額外輸出無音軌版本與獨立 WAV 音檔,方便後製混音。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/raycfu/claude_design_skills/tree/HEAD/reel-builder

在你喜歡的 AI 中提問

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

說明文件

/reel-builder

將 4 到 8 個已編輯的片段包裝成聊天風格的短影格。這是一種格式:手機螢幕打出 /glass-widgets,Claude 說「正在使用 glass-widgets 編輯...」,片段從橙色圓點構築出來,放大至全螢幕兩秒,最後在「Comment EFFECT」網格畫面結束。所有元素都由程式碼繪製,因此可在任何機器上呈現一致效果。

SK 是此技能所在的資料夾。它會重複使用效果技能 (~/.claude/skills/effects/.venv) 的 Python 環境。如果該環境不存在,請先執行 bash ~/.claude/skills/effects/scripts/setup.sh。 PY = ~/.claude/skills/effects/.venv/bin/python (在 Windows 上為 .venv\Scripts\python.exe)。

1. 收集片段

對於每個效果,你需要同一時刻的兩個檔案:

  • raw:套用效果前的原始片段(在聊天中顯示為附件的縮圖)
  • edited:已套用效果的片段,來自效果技能 (yourclip_effects.mp4)

每個已編輯片段至少 4 秒長,並渲染得比需要的稍長一些,這樣效果才不會在螢幕上淡出。理想尺寸為垂直 1080x1920;其他尺寸會被縮放以符合畫面。

2. 為每個效果挑選最佳時刻

每個效果會顯示其片段 T_FULL + full_seconds 時間(聊天卡片中 2.2 秒,然後全螢幕顯示 full_seconds,預設為 2 秒)。 offset 是該視窗在已編輯片段中的起始位置。選擇它時,請確保全螢幕部分落在最精彩的瞬間:最後一個核取標記打勾、圖表達到預期數字、人物指向標誌。可使用靜止畫面檢查(步驟 4)。

3. 撰寫設定檔

將 SK/examples/config.json 複製到片段旁邊並進行編輯。向使用者詢問:

  • 他們的暱稱,用於問候語 ("greeting": "晚上好,<name>")
  • 行動呼籲的留言關鍵字 (cta_word,例如 EFFECT) 以及下方的藥丸文字 (cta_pill)
  • 哪個效果作為開場 (cold_open.effect,指向 effects 陣列中的索引) 及其三個詞 (cold_open.lines)
  • 最多 8 個片段用於結尾網格 (grid,每個包含標籤、片段和一個好畫面的時間戳)
  • 可選的 more_label,例如 +43 更多效果

你可以設定的鍵值:output、full_seconds、end_seconds、cold_open(包含 effect、from、seconds、lines;不加則無開場)、effects[](包含 name、desc、raw、edited、offset)、greeting、end_command、end_desc、cta_word、cta_pill、more_label、reply_line1、reply_line2、grid_title、grid_subtitle、grid[](包含 label、clip、t)。路徑相對於設定檔。

4. 檢查,然後渲染

  1. "PY" "SK/scripts/reel.py" config.json --info 會印出長度。
  2. "PY" "SK/scripts/reel.py" config.json --test 3.0 5.5 9.0 ... 會在設定檔旁儲存 check_XX.XX.jpg 靜止畫面。請檢查每個全螢幕視窗的開始與結束(循環 k 從 cold_open.seconds + k * 4.2 開始,全螢幕從 +2.2 到 +4.2)。親自審視。調整 offset,直到每個視窗都在精彩瞬間結束。
  3. "PY" "SK/scripts/reel.py" config.json 會渲染三個檔案:包含打字音效的短影格、一個無音軌副本,以及獨立 WAV 打字音效,方便使用者混入自己的音樂。使用 --crf 5 獲得最高品質,使用 --jobs N 使用更多 CPU 核心。

規則

  • 不得出現品牌標誌。工作指示器為原創的旋轉環,刻意為之。即使使用者提供檔案,也不得在短影格中繪製或貼上其他公司的標誌。
  • 全螢幕片段上不得疊加字幕。讓效果本身承載高潮時刻。
  • 除非使用者要求音樂,否則只保留打字音效作為唯一音訊。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能