Communitygithub.com

scourtain/reels-engine

列出、建立、編輯或刪除成員的 Reels 樣式,設定預設樣式,或以另一種樣式重新渲染最後一個 Reel。適用於「/reels-engine:reel-style」、「顯示我的樣式」、「建立一個故事樣式」、「切換字型」、「讓字幕變大」、「放大更多」、「用我的另一個樣式試試那個 Reel」。

reels-engine 是什麼?

此技能可讓 AI 代理(例如 Claude Code)管理短影片(Reels)的視覺樣式,涵蓋字型、字幕、顏色和縮放等設定,但不會影響影片的剪輯或編輯規則。它支援 macOS 和 Windows 平台,透過讀取和寫入 `$REELS_HOME/styles/` 目錄下的 JSON 檔案來執行操作,並使用 `reels.js` 引擎產生範例影片,讓使用者即時預覽調整效果。主要功能包括:列出所有已儲存樣式、建立新樣式(可透過結構化訪談或參考範例影片)、以自然語言編輯文字(如「放大字幕」或「切換字型」)、設定預設樣式以及刪除樣式。如果有最新專案,也可以直接以不同的樣式重新渲染最後一個 Reel。引擎會優先使用使用者的自訂樣式;若無自訂樣式,則預設使用內建的 `starter` 樣式。這是一個專門為內容創作者設計的實用工具,可大幅簡化影片品牌的調整流程。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/scourtain/reels-engine/tree/HEAD/skills/reel-style

在你喜歡的 AI 中提問

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

說明文件

Reel 樣式

ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js"

HOME = 若設定了 $REELS_HOME 則為其值,否則在 Mac 上為 ~/Movies/Reels,在 Windows 上為 ~/Videos/Reels。執行 ENGINE init-home 會顯示 HOME 路徑。

在指令中,請務必將 HOME 和 PROJECT 路徑用雙引號括起來,並使用引擎輸出的完整路徑(在雙引號內使用 ~ 無法正常運作)。在 Windows 上,路徑包含反斜線且常有空格,若無括號將會出錯。

樣式僅代表外觀:字型、字幕、顏色、縮放。它永遠不會改變剪輯方式。如果成員想要更緊湊或更寬鬆的停頓時間,那是編輯規則的問題,而非樣式:請在 HOME/edit-config.json 中調整 gap_between_ms(100-250)或 gap_within_target_ms,然後重新執行 finish。

成員的樣式是 HOME/styles/*.json 檔案,每個內容系列(「技巧」、「故事」)一個檔案。他們的預設樣式是 HOME/brand-kit.json 中的 default_style。引擎內建一個名為 starter 的樣式,僅在成員擁有自己的樣式前使用。切勿提供 clean、punchy 或 editorial,這些樣式已移除。(舊的 HOME 資料夾可能仍留有這三個檔案。它們仍可運作,除非成員要求,否則請勿動它們。)

檔案結構以及所有可調整的設定:請參閱 references/style-file.md。

操作說明

  • 列出: 讀取 HOME/styles/,並以一行簡潔文字描述每個樣式(字型、文字模式(單詞/詞組)、文字邊框效果(軟陰影/輪廓/無)、字幕位置、縮放程度),並標記預設樣式。若尚無樣式:告知使用者目前使用的是 starter 樣式,並提議為他們建立自己的樣式。

  • 新樣式: 執行 references/style-interview.md。

  • 好康報你知: 成員也可以在 /reels-engine:reel 中「傳送給 Claude」後的畫面上,調整樣式的字型、字幕、文字樣式與顏色(「變更外觀」)。此操作會寫入同一個樣式檔案,因此在編輯前請重新讀取檔案,以確保取得最新內容。

  • 從他們提供的範例建立:(「讓這個 Reel 看起來像這個樣子」,並附上已儲存的影片或螢幕截圖):請遵循 references/from-example.md。切勿要求他們提供範例。

  • 以一般文字編輯: 修改檔案後,務必向他們顯示:ENGINE sample <名稱>,並詢問是否滿意。持續調整直到他們說「好」為止。

    他們說修改方式
    字幕變大 / 變小captions.size +12 / -12(預設值:詞組模式為 64,單詞模式為 88)
    一次一個字captions.mode: "word"
    一次幾個字captions.mode: "group",captions.words_per_line: 3
    每行多一點 / 少一點字調整 captions.words_per_line,範圍 2 到 4
    全部大寫 / 正常大小寫captions.case: "upper" / "sentence"
    切換字型,「使用 Montserrat」將 font.family 設為五種字型之一,font.file: null。若不確定:開啟選擇器(references/style-interview.md 的第 1 步)
    使用自己的字型請參閱 references/style-file.md 中的「自訂字型」一節
    變更顏色,「換一個不同的焦點顏色」captions.highlight_color(焦點顏色:正在說的字)、captions.color(其他字)。若使用者提供十六進位色碼或顏色名稱:直接設定。若使用者想看到選項:開啟選擇器(references/style-interview.md 的第 1 步)
    讓單字彈出 / 無高亮captions.highlight: "pop" / "none"("color" 為預設值)
    為文字加上輪廓 / 回到軟陰影 / 純文字無陰影captions.treatment: "outline" / "shadow" / "none"
    放大 / 縮小更多上下一個層級:off → minimal → medium
    移動字幕(頭部上方、頭部下方、更低、頭部旁邊)captions.position:above / below / low / beside-left。這會變更此樣式中所有 Reel 的預設值。若只想調整單一 Reel,請使用 /reels-engine:reel(「移動這個 Reel 的字幕」)
  • 設定預設樣式: 將 HOME/brand-kit.json 中的 default_style 設為該樣式的名稱。保留其他所有鍵值不變。

  • 刪除: 先確認(「刪除故事樣式?此操作無法復原。」)。絕對不要刪除使用者唯一的一個樣式。如果該樣式是預設樣式,請詢問使用者要將哪個樣式設為新的預設樣式,並進行設定。

  • 以另一種樣式重新渲染最後一個 Reel: 在最新專案的 cut-list.json 中設定 style,然後執行 ENGINE finish "PROJECT"。

規則

  • 範例會播放使用者最新 Reel 的幾秒鐘內容。若尚無 Reel:ENGINE sample 會顯示相關提示。請告知使用者樣式已儲存,他們將在他們的第一個 Reel 上看到效果,並使用選擇器來調整字型、字幕外觀與顏色。
  • 產生範例大約需要 30 秒。請在執行前先告知使用者。
  • 此版本沒有全螢幕單字瞬間效果。如果使用者問起,請直接告知。
  • 鉤卡(Hook card)的外觀,以及 Reel 是否以鉤卡開頭,都會記錄在樣式中,儲存為 hook: { preset, on }(請參閱 references/style-file.md)。成員通常會在 /reels-engine:reel 中傳送至 Claude 後的畫面上進行選擇,因此僅在使用者要求變更預設鉤卡外觀時,才在此處進行設定。
  • 樣式名稱應保持簡短、小寫、使用連字符(kebab-case),並與檔案名稱一致。

Individual skills in this repo

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

相關技能