Motion Skills
← 教學

如何在 Claude Code、Codex 或 Cursor 中安裝 Skill

Skill 是一個資料夾，裡面有一個 SKILL.md 檔案（給 Agent 的指示），以及範本和指令碼。安裝一次之後，只要請求相符，Agent 就會使用它。同一個資料夾可以在 Claude Code、Codex、Cursor 和 Gemini CLI 中使用，只是放置的位置不同。

資料夾位置取自各個 Agent 自己的文件，已於 2026 年 10 月 29 日核實。

Skill 是什麼

Skill 採用開放的 Agent Skills 格式。一個 Skill 就是一個以 Skill 名稱命名的資料夾，內含：

  • SKILL.md： 指示本身。開頭的簡短標頭寫明 Skill 的 name，以及說明何時使用它的 description；Agent 會讀取這段說明來判斷請求是否相符，相符時再讀取其餘內容。
  • 參考資料： 指示中提到的較長說明，只在需要時才讀取。
  • 範本和指令碼： Agent 會複製或執行的檔案，例如影片範本、需求說明檔或檢查程式。

不會進行任何全系統安裝，也不會建立帳號：Agent 讀取這個資料夾，Skill 的命令則在你的專案中執行。

最快的方式：請 Agent 幫你安裝

在任何 Skill 頁面複製安裝提示詞，貼給你的 Agent：

Read https://claude-motion.com/skills/<slug>/install.md and follow it to install the "<slug>" skill, then make a first video with it.

Agent 會讀取這份指南並執行一個命令：npx motion-skills install <slug>。第一次執行時，瀏覽器會開啟一個頁面：用 Google 登入，並核准終端機中顯示的代碼。如果是你還沒購買的付費 Skill，可以在同一個頁面購買，安裝會自動完成。接著 Agent 會製作第一支影片。（如果命令無法執行，指南會改為在瀏覽器中下載。）

手動安裝

  1. 從 Skill 頁面下載 ZIP。
  2. 解壓縮時保留資料夾名稱（<slug>/SKILL.md）：
    • Claude Code： ~/.claude/skills/<slug>/，或專案內的 .claude/skills/<slug>/
    • Codex： ~/.agents/skills/<slug>/
    • Cursor： 專案內的 .cursor/skills/<slug>/
    • Gemini CLI： ~/.gemini/skills/<slug>/
  3. 開啟新的 Agent 工作階段，讓它載入這個 Skill。
mkdir -p ~/.claude/skills
unzip -o ~/Downloads/kinetic-type-title.zip -d ~/.claude/skills/

電腦上需要準備什麼

  • Node.js 22 或更新版本
  • FFmpeg（macOS 上執行 brew install ffmpeg）
  • Google Chrome（渲染器會以無頭模式操作它）

完整版 Skill 和免費的 Motion Director 執行在我們的開源引擎 motion-skills（mo）上，第一次渲染時會透過 npx 自動安裝；動效模板使用 HyperFrames CLI，也會以同樣的方式自動安裝。不需要任何 API 金鑰。

使用 Skill

使用動效模板時，直接提出要求即可：「做一張 9:16 的標題卡，文字是更快出貨，安心入睡。」Agent 會複製範本、寫好 brief.json、執行 hyperframes check、查看快照畫面找出版面問題，然後渲染出 MP4，並告訴你檔案在哪裡。

使用完整版 Skill 時，把素材交給 Agent，說明影片的用途。它會用真實畫面呈現三個方向，寫好節奏表和原創配樂，執行 mo 檢查並審片，然後在你自己的 Chrome 中渲染出 MP4。

附真實範例影片的完整教學，請見如何用 Claude Code 製作影片。Codex、Cursor 或 Gemini CLI 的做法，以及各自讀取的每個資料夾，請見用 Codex、Cursor 或 Gemini CLI 製作影片。

疑難排解

  • Agent 沒有使用這個 Skill。 安裝後開啟新的工作階段；Agent 會在工作階段開始時讀取 Skill（在 Gemini CLI 中，/skills reload 可以直接重新載入）。然後再提出一次要求，並指名 Skill：「use the changelog-video skill」。也請檢查資料夾：SKILL.md 必須直接放在 <slug>/ 裡，不能在解壓縮後多出一層。
  • 「FFmpeg not found」。 安裝 FFmpeg（macOS 上執行 brew install ffmpeg），並開啟新的終端機視窗，讓它出現在路徑中。
  • 「Chrome not found」。 安裝 Google Chrome；渲染器會以無頭模式操作它。完整版 Skill 會先用 mo doctor 替你檢查這一項，動效模板則用 node kit/doctor.mjs。
  • 登入頁面沒有開啟。 終端機會印出網址和代碼；自行開啟網址並輸入代碼即可。

常見問題

Claude Code 的 Skill 要放在哪裡？

放在 ~/.claude/skills/<slug>/ 可供所有專案使用，放在專案內的 .claude/skills/<slug>/ 則只供該專案使用。資料夾保留 Skill 的名稱，裡面放著它的 SKILL.md。開啟新的 Claude Code 工作階段，讓它載入這個 Skill。

SKILL.md 是什麼？

給 Agent 的指示檔案，和範本、指令碼一起放在 Skill 資料夾中。它的標頭寫明 Skill 的名稱和使用時機；請求相符時，Agent 就會讀取它。

Skill 能在 Codex、Cursor 和 Gemini CLI 中使用嗎？

可以。同一個資料夾在這幾個 Agent 中都能使用，只是位置不同：Codex 是 ~/.agents/skills/<slug>/，Cursor 是專案內的 .cursor/skills/<slug>/，Gemini CLI 是 ~/.gemini/skills/<slug>/。

需要 API 金鑰嗎？

不需要。Skill 在你的電腦上透過 Node.js、FFmpeg 和 Chrome 執行，引擎會透過 npx 自動安裝。唯一需要的登入是本站的免費 Google 帳號，用於下載。