前言¶
短視頻交付往往卡在「剪映裏手搓時間線」和「腳本里拼 FFmpeg」之間:前者難批量、難版本化,後者要把轉場、字幕、多平臺畫幅拆成一堆命令。若希望 Agent 只維護一份結構化剪輯意圖,再按本機環境選後端出片,可以把編排交給 Skill,而不是每次重寫流水線。
下面介紹 SkillHub 社區 Skill auto-video-editor(座標 @user_edc04a5a/auto-video-editor-pro,版本 1.0.0)的定位、能力與安裝方式。
這是什麼¶
auto-video-editor 是面向 全自動短視頻剪輯 的 Agent Skill:接收 EditPlan(以 Pydantic 描述的 JSON 結構),自動探測當前機器可用的渲染後端,按能力差異對不支持的效果做降級,最終輸出視頻文件。官方說明還支持 多輸出目標(例如視頻號版與抖音版同時生成),並在執行過程中 實時輸出進度。
- 維護方:社區發佈者
user_edc04a5a(SkillHub 頁面標註作者「老張」) - 分類:design-media
- 來源:community
- 標籤:
requires_api_key=false(SkillHub 元數據標明無需 API Key)
Skill 詳情頁:https://www.skillhub.cn/skills/user_edc04a5a/auto-video-editor-pro
核心功能¶
以下能力均來自 SkillHub 簡介與頁面描述,可與上文對照覈對。
結構化輸入:EditPlan¶
剪輯意圖以 EditPlan(Pydantic JSON) 交給 Skill,而不是在對話裏零散描述「加個字幕、再切一刀」。這樣便於 Agent 生成、校驗和複用同一份計劃。
後端自動探測與優先級¶
Skill 會探測本機可用後端,並按固定優先級選用:
- 剪映草稿
- FFmpeg / MoviePy
- CapCut API
某一後端缺少某項效果時,Skill 會 按後端能力差異自動降級,避免整條流水線因單個特效失敗而中斷。
出片與可觀測性¶
- 輸出 最終視頻文件
- 支持 多輸出目標 一次生成多版本
- 執行過程 進度實時輸出,便於在 Agent 會話裏跟進長任務
安裝與啓用¶
SkillHub 推薦通過通用安裝文檔完成 CLI 與技能落盤;頁面給出的安裝提示爲:讓 AI 參照 https://skillhub.cn/install/skillhub.md 安裝 @user_edc04a5a/auto-video-editor-pro。
1、檢查或安裝 SkillHub CLI¶
先確認本機是否已有 skillhub:
command -v skillhub && skillhub --version
未安裝時,可按官方腳本安裝(完整安裝含 CLI 與默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝 auto-video-editor 到當前 Agent 的 skills 目錄¶
安裝技能時必須使用 --dir,指向 當前使用的 Agent 實際讀取的 skills 目錄;否則默認會裝到 ./skills/,Agent 可能無法加載。
skillhub install @user_edc04a5a/auto-video-editor-pro --dir <你的 skills 目錄>
常用客戶端路徑(摘自 SkillHub 安裝文檔,按你當前環境選用其一):
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安裝後若 Agent 未立即識別新 Skill,按所用客戶端說明 重啓或刷新技能列表(SkillHub 文檔提示錯誤目錄時往往需要重啓)。
3、啓用方式¶
本 Skill 基於通用 SKILL.md 格式。具體觸發詞、參數與 EditPlan 字段定義在安裝包內的 SKILL.md 中;安裝完成後讓 Agent 讀取該文件並按其中步驟調用即可。公開頁面未單獨列出 Cursor / Codex CLI / Claude Code 的差異配置時,以各客戶端的 skills 目錄與同一安裝座標爲準。
典型用法¶
公開資料未附帶完整 EditPlan 樣例 JSON,可復現的流程如下(與官方簡介一致):
- 準備素材與意圖:在對話或上游腳本中整理剪輯需求,並落成符合 Skill 要求的 EditPlan(Pydantic JSON)(字段與校驗規則以安裝後的
SKILL.md爲準)。 - 交給 Agent 執行:在已安裝 Skill 的會話中,說明要按 EditPlan 出片;Agent 按 Skill 指引調用能力。
- 後端選擇與降級:Skill 自動在剪映草稿、FFmpeg/MoviePy、CapCut API 之間按優先級選用;不支持的效果會降級而非直接失敗。
- 取回產物:得到最終視頻路徑;若配置了多輸出目標,可同時得到面向不同平臺的版本,並在此過程中查看實時進度輸出。
若需要搜索或覈對座標,也可使用:
skillhub search auto-video-editor
適用場景與注意¶
更適合:
- 希望用 一份結構化 EditPlan 驅動剪輯,而不是每次手寫 FFmpeg 或純 GUI 操作
- 團隊或 Agent 流水線需要 多平臺畫幅/版本一次生成
- 本機可能只有 FFmpeg/MoviePy,也可能有剪映或 CapCut 相關環境,希望 自動選後端
需要注意:
- 實際效果上限取決於 當前探測到的後端;同一 EditPlan 在不同機器上可能因降級策略得到不同成片。
- 剪映草稿、FFmpeg/MoviePy、CapCut API 是否可用,取決於本機安裝與授權;Skill 負責探測與降級,不能替代底層工具的安裝。
- SkillHub 元數據爲社區來源(
community),版本 1.0.0;頁面統計(截至抓取)評分 100000、下載 2841、安裝 0,使用時以 SkillHub 頁面最新數據爲準。 - 官方 API 地址爲 https://api.skillhub.cn/user_edc04a5a/auto-video-editor-pro,供工具鏈拉取元數據;日常安裝與說明以 SkillHub 頁面與
skillhubCLI 爲準。
結尾¶
auto-video-editor 把短視頻剪輯收斂爲 EditPlan + 自動後端探測 + 能力降級出片,適合想把「剪輯編排」交給 Agent、把「渲染落地」交給本機環境的開發者。安裝與座標以 SkillHub 爲準: