Communitygithub.com

elkl111/Reels 剪輯實驗室-入門設定

Reels 剪輯實驗室的首次入門引導。自動安裝所需工具、進行簡短的品牌訪談、讓用戶在自己的影片上挑選風格,並儲存為個人套件。當用戶說「幫我設定」、「開始使用」、「引導我」,或當品牌/kit.txt 尚未存在(實驗室尚未設定)時使用。

Reels 剪輯實驗室-入門設定 是什麼?

此技能專為首次開啟 Reels 剪輯實驗室的非技術用戶設計,提供完整的引導式設定流程。它會自動檢查並安裝必要的開發工具(如 Homebrew、ffmpeg、uv、Playwright、語音模型),過程中以友善且簡潔的對話說明每個步驟的用途,無需用戶手動執行複雜指令(除了 Homebrew 的安裝指令)。接著,技能會以問答方式進行品牌訪談,收集用戶的影片風格偏好、品牌色彩與字型,以及不想要的元素。核心特色在於,它會讓用戶上傳一段自己的說話片段,並自動生成多種風格預覽(如 calm、warm、high-energy),讓用戶直觀地看到同一段影片套用不同風格的效果,再從中選擇最喜歡的作為基礎。最後,技能會將所有選擇(包括品牌色彩、字型、音效設定)儲存為用戶專屬的「套件」(kit),並可進一步根據用戶提供的設計檔案或截圖進行客製化調整,確保最終風格完全符合需求。整個過程約需 10 分鐘,並在結束後引導用戶開始編輯第一部成品 Reels。此技能設計上支援 Claude Code 等 AI 代理平台,以對話式互動降低使用門檻。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/setup

在你喜歡的 AI 中提問

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

說明文件

幫我設定

用戶是第一次打開實驗室。他們不具備技術背景。到最後,他們會完成所有安裝、在自己臉上看到並選擇喜歡的風格,並儲存好自己的套件。然後他們就準備好製作第一部 Reels 了。

語氣:溫暖、簡潔、一步一步來。在等待時告訴他們正在發生什麼事。絕不直接貼上原始工具輸出。絕不要求他們執行指令,除了步驟 1 中可能缺少的 Homebrew 那一行。

從一則簡短的訊息開始:

歡迎來到 Reels 剪輯實驗室。設定大約需要 10 分鐘:我會安裝一些東西、問你 3 個簡單問題,然後你就可以在自己的影片上挑選喜歡的風格。我們開始吧。

1. 安裝 (≈5 分鐘,大部分時間在等語音模型下載)

執行 python3 tools/doctor.py。它會印出一個檢查清單和 DOCTOR=ok 或 DOCTOR=missing:<names>。按以下順序修正缺失的項目,最後再重新執行一次醫生腳本:

  1. mac / space: 如果任一項失敗,先停下來並親切地解釋原因(需要 Apple 晶片 Mac;約需 6 GB 可用空間)。
  2. homebrew: 你不能幫他們安裝,因為它需要他們的 Mac 密碼並在真正終端機中執行。用一句話解釋原因,然後給他們醫生腳本提供的確切安裝指令,告訴他們打開 Terminal app(Cmd+空白鍵,輸入 Terminal),貼上指令,按 Enter,輸入他們的 Mac 密碼(輸入時不會顯示任何內容,這是正常的)並按照提示操作。最後 Homebrew 會印出兩行以 echo 和 eval 開頭的「下一步」指示;請他們也貼上這兩行。等他們說完成後,重新檢查。
  3. apple-tools: 執行 xcode-select --install。會跳出一個 Mac 視窗;告訴他們點擊 安裝,並在完成時告知你(約幾分鐘)。Homebrew 通常會自動安裝這些,所以先檢查一下。
  4. ffmpeg: brew install ffmpeg(如果 brew 還不在路徑中,請使用 /opt/homebrew/bin/brew)。
  5. uv: curl -LsSf https://astral.sh/uv/install.sh | sh,如果 uv 還找不到,則使用 ~/.local/bin/uv。
  6. python-tools: uv sync
  7. renderer: uv run playwright install chromium
  8. speech-model: 在背景執行 uv run tools/get_models.py(2.3 GB)。如果連線中斷,它會自動恢復。開始下載後,就可以進行訪談。在步驟 3 需要使用它之前回來檢查狀態。

在安裝過程中,用一句話告訴他們每個工具的用途(醫生腳本的描述已為此設計)。

2. 品牌訪談(3 個問題,一次問一個)

以對話方式提問,一次一個訊息。保留他們的確切用詞。

不要詢問名稱、標語或「你做什麼」的標籤:實驗室預設不會加上這些(請參閱 new-reel 技能的「label」)。

  1. 能量。 「你在鏡頭前是怎樣的:冷靜且深思熟慮、溫暖健談、還是高能量?」這會設定剪輯的活潑程度(請參閱步驟 4 中的表格)。
  2. 品牌。 「你有品牌或設計檔案、品牌色或字型嗎?把你的設計檔(一個 .md 或 PDF)丟進來,我會用它打造你的風格。或者貼上色碼,或者把 3-6 張你喜歡的 Reels 風格截圖放到 inspiration 資料夾。或者直接說『不用了,給我看選項』。」
  3. 絕對不要。 「你絕對不希望在你的 Reels 上出現什麼?例如全大寫文字、特定表情符號、音效、或是你絕對不會說的話。」

將答案儲存到 brand/profile.md:

# 個人檔案
- 能量: 溫暖健談
- 品牌: 顏色 #… / 字型 … / inspiration/ 中的截圖 / 無
- 絕對不要: …

同時將每個「絕對不要」的項目作為一行規則加入 brand/preferences.md。

3. 在自己臉上看到風格

詢問:「現在請放入任何一段你對著鏡頭說話的影片片段,最好 20 秒或更長。將它拖曳到這個對話或 inbox 資料夾中。不一定要是好的鏡頭;只是用來試試風格。」

當影片片段放進來後(且語音模型已完成):

  1. uv run tools/transcribe.py "<影片片段>" --name welcome-sample

  2. 讀取 projects/welcome-sample/lines.md。使用 new-reel 的粗剪規則(取最後一個乾淨的 take,不要有 false starts),寫入包含前 3-5 行乾淨台詞、約 12-20 秒 的 cut.json。執行 uv run tools/roughcut.py projects/welcome-sample --no-open 和 uv run tools/verify.py projects/welcome-sample,並修正任何它標記的問題。不要請他們審閱這個剪輯;它只是一個樣本。

  3. 像 new-reel 技能一樣編寫 build.json:用 hooks 技能根據他們實際說的話寫一個鉤子(這是他們對實驗室的第一印象,所以要寫得好),1-2 個重點詞彙、1 個縮放、以及對最強台詞的一句陳述。用 visuals 技能加入 2-4 個彈出視窗(例如他們提到的列表用晶片,或者如果他們談到提示詞就用聊天視窗),讓他們看看實驗室的實際功能。不要加入「behind」時刻。

  4. 風格對照表: uv run tools/build.py projects/welcome-sample --looks presets。它會開啟一張圖片,將他們的影片片段以每種風格並排顯示,順序與 LOOKS= 之後印出的相同。先自己查看圖片(讀取它)並檢查文字是否可讀且沒有遮住臉部。

  5. 按照印出的順序,用每個套件的 description(來自 packs/<名稱>/kit.json)以一句話簡短介紹每種風格。 然後清楚說明風格只是一個起點,不是最終選擇:

    選擇你感覺最喜歡的那個。之後所有東西都可以更改:「這個風格,但要鼠尾草色和奶油色」、「用我的顏色:#…」、「更柔和一點的字型」、「不要粉紅色」。我會在你的影片片段上重新製作,讓你可以看到效果。

    詢問他們想看哪個風格的動態版本。

  6. 對於他們選擇的每個風格:uv run tools/build.py projects/welcome-sample --kit <名稱> --out sample-<名稱>。它會在 QuickTime 中開啟。如果他們選了兩個,就同時製作兩個並依序開啟。

如果他們在步驟 2 中提供了品牌顏色、字型或截圖,也提供選項:「或者我可以根據你的品牌製作一個風格。」請參閱步驟 5。

4. 儲存他們的套件

當他們做出選擇時(例如「Editorial 風格,但是鼠尾草色和奶油色」或「Playful 風格,但要更冷靜」):

  1. 將 packs/<預設>/kit.json 複製到 packs/<他們名字的小寫>/kit.json。在副本中:

    • "name": 他們的名字
    • "preset": false
    • "based_on": "<預設>"
  2. 套用他們的能量:

    能量intensity縮放跳躍 / 重擊sfx volume_db陳述句
    冷靜且深思熟慮clean1.04 / 1.08−17最多 1 句
    溫暖健談signature1.07 / 1.13−13最多 1-2 句
    高能量full1.12 / 1.22−10最多 2 句

    變更 rules.intensity、zoom、sfx.volume_db 以及 rules.statement 的用詞以符合設定。

    音效組合(sfx.palette):

    • calm: soft
    • warm: soft 或 playful
    • high-energy: punchy
    • 科技或 AI 主題:考慮使用 clicky

    告知一次他們可以在 sfx/sound-menu.mp4 中聽到每種音效,並且可以透過要求切換組合(「使用 playful 音效」)。如果他們說過「不要音效」,則設定 "sfx": {}。如果他們說過不要全大寫,則將 style.caption_case、style.hook_case 和 style.statement_case 設定為 "none"。

  3. 套用他們的顏色,無論是來自訪談還是他們提出的要求(「改用這些顏色」):

    • 從色碼或純色名稱: 「sage」或「dusty pink」都可以;選擇有品味的十六進位色碼並告訴他們是哪個。
    • 交換 colors 中的值並保持角色:淺色用於卡片和字幕,深色用於陳述句背景和墨水色,亮色用於強調色和 visuals.rotate。
    • 檢查對比度: 文字必須在其背景上清晰可讀。
    • 為他們的套件重新渲染風格對照表(--looks <他們的套件>),讓他們在製作完整樣本前先看到效果。
    • 字型也一樣: 任何免費的 Google 字型都可以(fonts.py 會確認它是否存在)。
  4. 將套件的資料夾名稱寫入 brand/kit.txt。

  5. 用他們的套件再製作一次樣本:uv run tools/build.py projects/welcome-sample --out sample-mine。它會在 QuickTime 中開啟。詢問:「這是你的風格。有什麼想改的嗎?」將更改套用至他們的套件(而非預設),並重新製作,直到他們滿意為止。小改動如「字幕小一點」、「黃色少一點」或「不要傾斜」都只需要在 kit.json 中修改一行。

5. 根據他們的品牌製作風格(當被要求時)

來自設計檔案(最佳方式)

如果他們有品牌或設計文件(一個 .md、PDF 或 Google 文件匯出檔,例如 BRAND-DESIGN.md):

  1. 取得檔案。 要求他們將檔案拖曳到對話中或放入 brand/,然後儲存一份副本為 brand/design.md(或保留 PDF)作為他們風格的唯一真實來源。

  2. 將其對應到他們的套件:

    在設計檔案中在 kit.json 中
    調色盤(十六進位色碼及其用途)colors,加上 roles:背景 → hook_card 和 label_bg;文字顏色 → ink 和 hook_text;「陳述句」或深色區塊 → statement_bg;強調色 → highlight_blocks;重點色 → accent_pill、visuals.rotate
    「絕不使用純黑或純白」這類規則使用他們最深的品牌色作為 ink
    標題和展示字型fonts.display / poster,其斜體作為 fonts.italic,用一個無襯線字體作為 label 和字幕
    招牌動作(斜體混搭、文字後方的強調區塊、傾斜、貼紙、全大寫)moves 和 style(hook_case、statement_case、radius)
    情緒(「冷靜」、「活潑」、「奢華」)visuals.motion、visuals.density、sfx.palette
    照片或影片風格(溫暖、陰鬱、明亮、底片感)grade:contrast、saturation、brightness、warmth(−0.05 到 0.05)、vignette(0-0.5)、legibility(文字後方深色漸層,0-0.5)。保持膚色自然:不要使用底片顆粒,不要重度壓縮。
    圖示、圖形元素、貼紙、按鈕(線條粗細、圓角或直角、填滿色塊)visuals.icon_stroke(細 1.5 → 粗 2.5)、visuals.radius、visuals.card(實心 / 輪廓 / 玻璃)、visuals.accent(圖示色塊顏色)、visuals.rotate(晶片和貼紙顏色)
  3. 付費或自訂字型: 尋找字型檔案。如果他們有,就放入 fonts/private/,然後套件使用 "file"。如果沒有,則選擇最接近的免費 Google 字型:比對對比度、寬度(高瘦或壓縮?)以及是否有斜體。告知他們你用了哪個替代字型以及原因。例如,「你的付費襯線字體 → Instrument Serif:同樣高挑、高對比感,有斜體。」

  4. 展示它: 渲染 --looks <他們的套件> 並製作 sample-mine。說明哪些部分直接來自他們的檔案,哪些是你詮釋的。

  5. 保持同步: 如果他們之後更新了設計檔案(「我改了品牌顏色」),重新讀取 brand/design.md 並以同樣方式更新套件。

來自截圖或貼上的色碼

當他們想要自己的風格而不是預設時:

  1. 讀取他們放在 inspiration/ 中的截圖、他們的品牌指南或他們貼上的色碼。注意:
    • 類型:襯線或無襯線、粗細程度、是否全大寫、是否混用斜體
    • 字幕處理方式:輪廓、陰影或方框;整個片語或逐字顯示
    • 卡片形狀和圓角半徑
    • 4-6 種顏色
    • 活潑程度
  2. 從最接近的預設開始,只修改不同的部分。字型必須是免費的 Google 字型:寫入 {"family": "<Google 字型名稱>", "google": true, "weight": N}(如有斜體則加上 "italic": true)。用 uv run tools/fonts.py "<family>" --weight N 確認每個字型都能下載。如果他們擁有付費字型,可以將檔案放入 fonts/private/,並使用 {"family": "...", "file": "fonts/private/<檔案>", "weight": N}。
  3. 不要複製其他創作者的確切字型和顏色。保留感覺,而不是招牌外觀。
  4. 渲染 --looks <他們的套件> 來檢查,然後如步驟 4 一樣製作 sample-mine,並在對話中迭代。

6. 完成

用大約 3 行告訴他們:

  • 他們的風格已儲存,之後每部 Reels 都會自動使用它
  • 如何編輯一部 Reels:將影片片段放入 inbox/ 或對話中,然後說「編輯這部 Reels」。你會剪輯它,他們可以在對話中審閱台詞,然後你用他們的風格製作
  • 彈出式圖形會說明他們說的話;「顯示圖形」可以播放他們風格中所有 14 種圖形的目錄
  • 可選附加功能:在對話中放入他們自己的 6 部 Reels 以獲得「圍繞你的 Reels」效果和個人檔案網格(tools/reels.py add);提供一次他們的真實 Instagram 數據(儲存到 brand/instagram.json)以用於追蹤動畫
  • 他們可以在任何台詞上要求一個迷因或 GIF(「這裡放 David Rose 的 'ew' 迷因」)。搜尋需要一個免費的 GIPHY 金鑰,你會在第一次時協助他們取得;他們自己的 GIF 檔案則可以立即使用
  • 顏色和字型永遠不會鎖定:「改用這些顏色」隨時可用在任何 Reels 上
  • 他們可以隨時說出來更改任何東西(「字幕小一點」、「這部不要音效」、「在這部 Reels 上試試 Loud 風格」)
  • 完成後的 Reels 會放在 Finished reels 資料夾
  • 指令:/new-reel 用於新的影片片段(為每部 Reels 在此資料夾中開啟一個新對話)、/update 用於取得新版本、以及 /report-problem 用於回報問題

然後提供選項:「想把你剛才給我的完整影片片段編輯成你的第一部正式 Reels 嗎?」如果是,就在此對話中對它執行 new-reel 技能。

套件風格開關(用於微調)

kit.json → "style":

  • caption_outline: 畫素;0 表示只有陰影
  • caption_case: "none" / "uppercase"
  • hook: "card" / "bare"(無卡片,只有輪廓文字)
  • hook_size
  • hook_case
  • statement_case
  • label: "ticket" / "pill"
  • label_mark: 名稱和主題之間的分隔符號
  • radius
  • shadow / shadow_soft: rgba 顏色

"captions":

  • mode: "karaoke

Individual skills in this repo

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

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

elkl111/reels-editing-lab-beta

The visual director. Plans the pop-up explainer graphics (chips, numbers, chat windows, checklists, diagrams…) that illustrate what the speaker says, beat by beat, in their kit's style. Use in the new-reel build step, when the user asks for more or fewer graphics ("more pop-ups", "illustrate this part", "a checklist here"), or asks what graphics exist ("what can you add?", "show me the options").

相關技能