music-to-video skill 是什麼、怎麼安裝使用：讓畫面卡着節拍走的音樂影片流程（HyperFrames）

本文根據 heygen-com/hyperframes 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 33.9 萬次；所在倉庫 heygen-com/hyperframes 在 GitHub 約 6.0 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

卡點影片的難處在於畫面切換要落在節拍上，手工對齊很費時間。music-to-video 讓音樂來決定一切節奏。description：把一段音樂（音頻文件、要提取音軌的影片，或按情緒描述生成的曲子）變成與節拍同步的影片——歌詞影片、幻燈片或動感宣傳片；音樂驅動所有節奏，用戶提供的圖片和影片都剪到同一套節拍網格上，完整的影片可以零素材。帶旁白的片子不歸它。

SKILL.md 開頭講了貫穿全程的兩個想法，第一個是「只有一個分析器，並且信任它」：analyze-beatgrid.py 是唯一的節拍分析工具，不許再用別的工具或憑感覺重新量節拍。它讀一遍曲子，寫出 audiomap.json：能量段落、起音點、鼓點滾奏、靜音段、硬停頓、關鍵時刻、樂句、速度與網格、總時長。

步驟：

1. 確定音樂來源、建項目、登記你提供的圖片和影片；
2. 分析音樂；
3. 搭幀骨架——只定結構；
4. 填寫逐幀計劃，等你確認；
5. 按計劃構建，每幀派一個子智能體；
6. 組裝；
7. 檢查並渲染，渲染前再問你一次。

技能說明它為快節奏、強節拍的配樂做過調校，舒緩的曲子也能用，只是按樂句而不是按拍切。目錄裏有一百六十多個文件，大部分是「動效基元」的示例場景（3D 卡片翻轉、流場背景等），供各幀取用。

怎麼安裝

music-to-video 是 HyperFrames 技能包裏的一個創作流程，不建議單獨裝：它要調用同包裏的 CLI、動畫、媒體等領域技能。Claude Code 用插件（命令來自倉庫 README）：

bash
claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes

其他智能體用 npx skills add heygen-com/hyperframes，README 說在選擇器裏只勾「Core Skills」一組即可，路由技能 /hyperframes 會在需要時把 music-to-video 這類流程按需裝上。渲染需要本機有 Node、Chrome 和 FFmpeg。

倉庫整體介紹和其他安裝方式，詳見本站《HyperFrames 是什麼、怎麼安裝使用：HeyGen 開源的「寫 HTML、出影片」框架與 Agent Skills》。

怎麼用

• 「用這首 track.mp3 做一支 20 秒的卡點宣傳片，文字用我們的三句口號」。
• 「把這 12 張活動照片配上這段音樂做成幻燈片，切換踩在重拍上」。
• 「給這首歌做歌詞影片」——需要提供歌詞文本，或讓它調用同包的 media-use 轉寫。

適合誰 / 侷限

適合做活動回顧、產品預熱短片、歌詞影片的人。侷限：沒有旁白，資訊量靠畫面上的字；節拍分析依賴 Python 環境，需要 librosa、numpy、soundfile 三個庫；曲子節奏不明顯時卡點效果會打折扣。

注意事項

• 許可：Apache-2.0。
• 音樂版權：用自己的曲子或有授權的音樂；讓它按情緒找配樂時走的是 HeyGen 的音樂庫，需要登入憑據，授權範圍以 HeyGen 的條款為準。SKILL.md 要求不把密鑰寫進倉庫裏的 .env。
• 會運行腳本：Python 分析腳本和若干 Node 腳本在本機執行；渲染需要 Node、Chrome 和 FFmpeg。