Communitygithub.com

orbit-reel

人物肖像卡片在3D環中環繞演講者,從頭部後方經過並穿過前景。提供垂直(9:16)和水平(16:9)版本。適用於 /orbit-reel 或將此特定效果應用到說話者頭像剪輯。

orbit-reel 是什麼?

orbit-reel 技能是一個專業的AI代理工具,專為影片編輯和動態設計而設計,能將人物肖像卡片以3D環形方式圍繞演講者運動,營造動態的視覺效果。它支援垂直(9:16, 1080x1920)和水平(16:9, 1920x1080)兩種模板格式,適合用於社交媒體短片、簡報或影片開場。該技能基於HTML模板和Python 3.9+構建,依賴ffmpeg/ffprobe和Node.js 22+/npm,並使用GSAP 3.15.0進行動畫處理,HyperFrames 0.8.214進行渲染。它允許用戶通過spec.json指定素材和參數,並提供`--prepare-only`選項進行編輯前的準備工作。技能的核心在於維持一個preserve-3d場景,其中z=0的alpha presenter保持固定,負z值的卡片從演講者後方經過,正z值的卡片穿過前景。用戶需要提供演講者影片和八張卡片圖片(如 banana-heels.jpg、blue-stairs.jpg 等),並可通過調整環的尺寸來適應新的演講者裁切。該工具不自動進行分段或添加音頻,預設為靜音,用戶可根據需求添加語音、音效或音樂。此技能適合Claude Code等本地編輯工作流程,並強調對平台疊加層的清晰處理和視覺一致性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/orbit-reel

在你喜歡的 AI 中提問

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

說明文件

/orbit-reel

使用4.2秒、30幀/秒的起始模板將此效果應用於說話者頭像剪輯:template.html 為垂直版本(1080x1920);template-16x9.html 為水平版本(1920x1080),在spec中以 "format": "horizontal" 選取。風格和圖像與演講者的話語無關;請跟隨用戶選擇的主題。

使用

從技能載入時顯示的基礎目錄解析此技能資料夾。其 build.py 通過該真實路徑解析共享工具包,包括當作為符號連結安裝時。運行:

python3 /path/to/skills/orbit-reel/build.py /path/to/spec.json

沒有捆綁示例演講者。通過spec的 assets(鍵 speaker.mp4 / speaker_cut.webm,也適用於使用1920x1080文件的水平模板)提供用戶的素材,或將其放入 assets/my-media/ 一次(請參閱其README),然後在不帶spec的情況下運行。輸出將放入存儲庫的 .work/ 目錄。--prepare-only 構建可編輯的合成而不進行渲染。需要Python 3.9+、ffmpeg/ffprobe和Node.js 22+/npm。首次構建會將固定的GSAP 3.15.0下載到忽略的供應商緩存中;渲染使用HyperFrames 0.8.214。這些短模板不需要轉錄文本或API密鑰。spec和自定義素材說明。

調整效果

維持一個帶有透視和幀匹配的alpha presenter在z=0的單一preserve-3d場景。負z值的卡片從演講者後方經過;正z值的卡片穿過前景。將基礎影片和切割圖保持在同一源偏移上。示例使用八張卡片、一個570px的水平環和290px的深度;將環調整為新的演講者裁切。每張卡片的初始姿勢必須使用顯式的時間軸位置0,以便所有卡片在幀零時存在。

資源鍵:banana-heels.jpg、blue-stairs.jpg、cactus.jpg、speaker.mp4、speaker_cut.webm、pixel-burger.jpg、pixel-fruit.jpg、red-stairs.jpg。全分辨率示例圖像和來源致謝位於 assets/style-showcase。

更換presenter時,提供一個相同尺寸、幀匹配的alpha切割圖。現有的 kit/cutout.py 可以創建它;請參閱共享指南。在明亮和暗色圖像上檢查頭髮和手部。構建助手不會自動執行分割。

從第一個結果幀開始讓presenter可見。使用銳利的照片和乾淨的字體。基本文字和臉部應避開平台疊加層;讓裝飾圖像溢出,而不是縮小整個合成。模板的標題和圖像錨點是起點,而非自動追蹤。

審查和交付

助手驗證媒體尺寸/持續時間,準備合成,運行渲染器檢查,渲染並完全解碼MP4。檢查第一幀、主要變化和結尾。檢查裁切錨點、文字可讀性和匹配源/切割圖時間。預設為靜音;僅在用戶要求時保留或添加語音、音效或音樂。更長的編輯需要擴展HTML時間軸和源窗口;僅更改持續時間是不夠的。

這些是本地的Claude Code編輯工作流程。第三方圖像權利與資產目錄中的代碼許可證分開記錄。

風格規範

僅使用Inter字體,一個強調色(#5000fa),帶有柔和陰影的白色標題,圓角卡片和平面表面。每個節拍只保持一個強調時刻;不要添加額外的顏色。要嘗試整個工具包的其他強調色,請設置 EDIT_ACCENT=#rrggbb,不過這些HTML模板直接攜帶十六進制值:在 template.html / template-16x9.html 中更改它。

Individual skills in this repo

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

相關技能