使用 npx skills 徹底解決不同 AI Agent（如 Claude Code 或 Kimi）技能碎片化問題

如果你在電腦上執行了多個 AI Agent（或 CLI 工具）——不論是 Hermes、Claude Code、Codex、Antigravity、Kimi 還是其他支援的工具，你可能都遇過一個極其令人沮喪的問題：技能碎片化（skills fragmentation）。每個 Agent 或 CLI 都會維護自己獨立的 skills 資料夾，這會導致重複安裝、版本偏差以及極高的管理維護成本。

在日常使用 AI Agent 的過程中，我們經常會遇到以下痛點：

• 重複安裝：為了一個 Agent 安裝了新技能後，還必須為其他 Agent 一次又一次地重複安裝。
• 版本偏差（Version Drift）：在某個 Agent 中客製或修復了某個技能，卻忘記同步更新其他 Agent，導致不同的 Agent 表現出不一致的行為。
• 技能 management 混亂：必須逐個翻看系統中每個 Agent 的 skills 資料夾，才能知道到底安裝了哪些技能。

由 Vercel 推出的開源 CLI 工具 npx skills 完美地解決了這個問題。它允許你建立並管理一個統一的、中央化的 skills 資料夾，並無縫共享給所有的 Agent。你可以前往 npx skills 的 GitHub 專案了解更多資訊。

技能一元化管理

這個方案的核心概念非常簡單：如果我們把每個 Agent 的 skills 資料夾都指向同一個實體資料夾，那麼碎片化問題就會迎刃而解。

當你使用 npx skills CLI 安裝技能时，該技能會被下載到你電腦上的中央統一資料夾（~/.agents/skills）。接著，CLI 會自動在各個 Agent 的 skills 資料夾中建立符號連結（Symlink，即指向實際資料夾的捷徑），直接導向該中央資料夾。

例如，當 Claude Code 在 ~/.claude/skills/ 中尋找技能時，它會被透明地導向到 ~/.agents/skills。只要你對中央資料夾中的技能進行任何微調，所有 Agent 都會立刻同步應用。無需手動複製，無需撰寫同步指令稿，更不會浪費任何硬碟空間。

安裝 npx skills 並新增技能

執行以下指令來開始並新增我們的第一個技能：

npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram

CLI 會詢問是要將此設定套用於特定專案還是全域（globally）。我們通常推薦選擇 global（全域），以便所有支援的 Agent 都能存取它：

接下來，請務必選擇 Symlink 以確保單一事實來源（Single Source of Truth）：

完成後，我們可以驗證該技能是否已經正確安裝在中央統一資料夾 ~/.agents/skills 中：

開啟 Kimi CLI（或任何其他 Agent），你會發現 excalidraw-diagram 技能已經立即可用！

從零開始建立技能

如果你想自建專屬技能，可以使用 Anthropic 的 skill-creator 工具。透過以下指令進行安裝：

npx skills add https://github.com/anthropics/skills --skill skill-creator

現在，在 Kimi 或任何其他 Agent 中，輸入以下提示詞（Prompt）：

Use the skill-creator to help me build a skill for creating a product landing page

Kimi 或你的 Agent 會自動識別 skill-creator 並引導你一步步完成建立過程：

其他實用的 npx skills 指令

以下是一些常用的便捷指令：

• npx skills ls -g：列出所有全域安裝的技能
• npx skills update：僅需一條指令即可將所有技能一鍵更新到最新版本
• npx skills remove：以互動式的方式解除安裝/移除某個技能

請參閱 npx skills 的 GitHub 專案以取得更多指令和參考文件。

進階玩法：結合 Git 管理

由於現在所有的技能都集中在同一個地方（~/.agents/skills），我們可以將其初始化為一個 Git 儲存庫，並推送到 GitHub 或 GitLab 進行備份與版本控制。

cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main

這樣，我們就擁有了技能修改的完整歷史記錄。萬一某次更新破壞了功能，我們可以非常輕鬆地復原（Rollback）。此外，如果你有多台電腦（例如筆記型電腦和桌上型電腦），只需執行一次快速的 git pull，即可在不同裝置間無縫同步所有技能。

幾點注意事項（安全與風險）

• 相容性差異：並非所有的 Agent 平台都完全支援所有功能（例如自訂勾子 custom hooks 或特定的授權工具）。某個技能在 A Agent 上執行順暢，在 B Agent 上可能會遇到功能限制。
• 來源可信度：請務必只從信任的來源安裝技能。
• 執行前程式碼審查：如果你使用的是自訂或第三方的技能，在授權 Agent 執行它之前，請務必先審查其程式碼檔案（尤其是 scripts/ 資料夾下的內容）。
• 最小權限原則：儘量不要給技能授予超出其核心功能所需的工具權限或系統存取權限。
• 切勿寫死機密資訊：千萬不要在技能檔案中直接寫入 API 金鑰（API Keys）或其他敏感憑證。

使用 npx skills 建立「單一事實來源」後，我們的團隊徹底擺脱了版本混亂和重複設定的煩惱。強烈建議你嘗試一下——隨著技能庫的不斷豐富，AI Agent 的能力也將迎來爆發式成長！