/brag 是什麼、怎麼安裝使用：一條命令把剛做完的項目變成發佈短影片的 Skill

本文根據 latent-spaces/brag 倉庫 README 整理，資料核對於 2026-10-11。截至當日，GitHub 顯示該倉庫約 1.5 萬 Star、1085 Fork，最近一次推送在 2026-10-09。命令和版本以倉庫為準。

是什麼

/brag 的口號是「東西做出來了，現在去炫耀」。它面向的是獨立開發者最常跳過的一步：項目做完了，卻懶得做一段像樣的發佈影片。README 的介紹是：一個把你做的項目變成可分享的發佈短影片的智能體技能，音樂、動效和分享文案都包括，一條命令，由 HyperFrames 驅動。

分工寫得很清楚：/brag 負責「故事」——從什麼角度講這個產品、用什麼語氣、展示哪幾個瞬間；然後把一份聚焦的簡報交給 HyperFrames（HeyGen 開源的「寫 HTML、出影片」框架，站內已有介紹）去搭建、對時和渲染。

包含哪些內容

倉庫裏有兩個技能：

• /brag：經典流程，依賴 HyperFrames，技能目錄裏帶參考文件以及打包好的音樂和音效；
• /brag-slim：精簡版，單文件技能，不依賴 HyperFrames、不帶打包素材，沿用同樣的創作規則。README 說在 Opus 5.5 上，/brag 會自動切換到精簡版，想保留經典流程可以運行 /brag --full。

產出是一個 brag-output/ 文件夾，裏面有方案、構圖簡報、分享文案和渲染好的 brag.mp4。旁白預設關閉，需要時顯式開啟，開啟後通過 HyperFrames 使用本地語音引擎 Kokoro。

倉庫裏還有一組虛構的產品網站，用作效果基準。

怎麼安裝

Claude Code（命令來自 README）：

text
/plugin marketplace add latent-spaces/brag
/plugin install brag@brag

Codex：codex plugin marketplace add latent-spaces/brag 後 codex plugin add brag@brag。

其他智能體用 skills CLI：

bash
npx skills add https://github.com/latent-spaces/brag --skill brag

加 -g 是全局安裝。只要精簡版就把 --skill brag 換成 --skill brag-slim。

環境要求：Node.js 22 以上、PATH 裏有 FFmpeg、能運行 HyperFrames 命令行（可用 npx hyperframes doctor 檢查）。

怎麼用

在項目目錄裏對智能體說：

• 「/brag」——讓它自己決定角度；
• 「/brag，語氣剋制一點，重點展示導入功能」——指定語氣和重點；
• 需要旁白時按 README 的寫法顯式開啟。

拿到影片後，文件夾裏的分享文案可以直接配着發。

適合誰 / 不適合誰

適合：

• 獨立開發者、黑客松參賽者、開源項目作者，需要一段二十秒左右的發佈影片；
• 想了解 HyperFrames 能做出什麼效果的人。

不適合：

• 需要真人出鏡、實拍或品牌級精修的宣傳片；
• 對影片內容有嚴格品牌規範的團隊——它的風格由技能內置的創作規則決定。

注意事項

• 許可：GitHub 標註 MIT。
• 素材版權：經典版內置的音樂和音效來自第三方（README 的致謝裏列出了來源），用於商業宣傳前確認其授權範圍；自己換配樂更穩妥。
• 本機渲染：需要 Node、FFmpeg 和無頭瀏覽器，渲染吃 CPU。
• 作者的在線服務：README 提到另有一個網站可以代你運行 /brag，屬於作者的獨立服務，費用與條款以其官網為準；技能本身免費開源。
• 影片裏展示的是你項目的介面和文案，公開發布前檢查有沒有測試數據或內部資訊入鏡。