Communitygithub.com

halo-cut

為 Claude 設計的「Halo Cut」影片編輯風格:乾淨優質的 Reels,包含緊湊跳剪、逐字字幕與關鍵字縮放特寫。適用於任何談話性頭影片段,可用於 Reels、Shorts 或 TikTok:技巧分享、評論、故事、公告。可將原始片段轉換為完成 9:16 編輯,並使用 video-studio-core 引擎(轉錄、自動剪輯、動態圖形、音效、調色)。

halo-cut 是什麼?

Halo Cut 是一種專為 Claude 類 AI 代理(如 Claude Code、Cursor 或 Codex)設計的影片編輯風格技能。它的核心功能是將原始談話性頭影片段快速轉換為高品質的 9:16 直式 Reels 或 Shorts。此技能依賴於「video-studio-core」引擎,自動執行轉錄、智慧跳剪、逐字字幕生成、關鍵字縮放特效、音效與調色等複雜流程。支援多種輸出格式(16:9、1:1、4:5),並可透過編輯 plan.json 進行細緻調整,如修改標題鉤子、關鍵字、時間軸與視覺主題。Halo Cut 特別適合需要快速產出專業級短影音的創作者,能大幅簡化從原始素材到最終成片的工作流程。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/halo-cut

在你喜歡的 AI 中提問

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

說明文件

Halo Cut

乾淨優質的 Reels:緊湊跳剪、逐字字幕、關鍵字縮放特寫。

  • 最佳用途: 任何用於 Reels、Shorts 或 TikTok 的談話性頭影片段:技巧分享、評論、故事、公告
  • 分類: 談話性頭像 Reel
  • 預設格式: 9:16(使用 --format 9:16 | 1:1 | 4:5 | 16:9 變更)
  • 需要攝影機素材: 是,原始談話片段
  • 發言人後方文字: 無

開始之前

此風格需依賴 video-studio-core 技能,該技能必須安裝於相同的技能資料夾中。

  • CORE = 與此資料夾相鄰的 video-studio-core 資料夾(例如 ~/.claude/skills/video-studio-core)。
  • STYLE = 此技能的資料夾(內含 theme.json 與 theme.css)。
  • 首次在機器上執行:python CORE/scripts/check_env.py,並修正其報告的所有問題。
  • 若缺少 CORE,請告知使用者從相同套件中安裝 video-studio-core。

進行編輯

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-halo-cut --stop-after plan
# 接著調整 edit-*/plan.json(見下方),然後檢查靜態圖:
python CORE/scripts/render.py edit-halo-cut/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-halo-cut/plan.json
python CORE/scripts/finish.py edit-halo-cut/plan.json

開啟 contact_sheet.png 並在完整渲染前先查看。最終影片位於工作資料夾中的 final.mp4。使用 finish.py 的 --formats 1:1,16:9 參數可產生額外尺寸。若要在計畫中加入音樂,請於 plan 中加入 "music": {"src": "track.mp3", "volume": 0.12}。

外觀風格

  • 字幕位於畫面 70% 高度處,每次顯示 2-3 個單字,全大寫,當前說話的單字為黃色,關鍵字為青色。
  • 每個強語氣單字加上縮放特寫(+14%,接著 +8%),每 2.4 秒最多一次。
  • 前 2.4 秒頂端顯示鉤子方塊:將內容改寫為 4-7 個單字,預告影片價值。
  • 跳剪時加入輕柔的嗖聲,關鍵字出現時加入「啵」音效。畫面上無其他元素。

調整計畫

make_plan.py 產生的草稿是自動的。請手動優化:

  • 讀取 words.json,將鉤子(前 2-3 秒)改寫為簡短、具體的承諾。
  • 將自動選取的弱關鍵字替換為傳達核心意義的單字(如數字、結果、人名、對比)。
  • 修正 words 陣列中聽錯的單字(保留其時間點)。
  • 挑選 4-8 個傳達訊息的關鍵字,放入字幕元素的 keywords 清單中。
  • 使 speaker.zooms 與這些單字對齊(在該字開始前 0.05 秒啟動,約 1 秒後結束)。
  • 若片段結尾有行動呼籲,在最後 2 秒加入 endcard 文字元素。
  • 元素類型與欄位請參閱:CORE/references/plan-schema.md。

交付前檢查

  • 聯絡表:文字清晰可讀,無內容被裁切,除非刻意設計,否則無元素遮蓋臉部,安全區域需遵守(9:16:文字保持在畫面高度 10% 至 85% 之間)。
  • 注意時間點:覆蓋元素需與說話同步,不可延遲。
  • 使用 ffprobe 檢查最終檔案:尺寸正確、時長正確、有音訊。
  • 告知使用者您剪掉了多少秒、外觀風格增加了什麼,以及檔案存放位置。

修改外觀

顏色與字型設定在 theme.json(vars、fontsUrl)與 theme.css 中。若僅需一次性修改,請編輯 plan.json(theme.vars、元素 style),而非修改技能檔案。

範例請求

  • "用 halo-cut 剪我的片段,去掉所有停頓。"
  • "把這個做成優質 Reels,開啟字幕,重點單字加上縮放。"
  • "用 Halo-cut 處理,鉤子改為 '我為了這個離職'。"

Individual skills in this repo

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

相關技能