Warp Common Skills：跨倉庫重用的代理工作流程

適合誰

當你有一套可重用的代理工作流程、約定或操作程序，並且它在多個倉庫都有用，需要放到共享位置而不是綁死在單個倉庫時，再用這個倉庫。它存放的是「跨倉庫通用」的 agent skills，不是某個專案的私有腳本。

前置條件：目前代理按說明走 Warp。推薦安裝命令帶 --agent warp --global，不要把這條命令改成未點名的其他代理。技能必須真的對多於一個倉庫有用；只在一個倉庫需要時，不要硬塞進這個共享庫。

編寫側：每個技能獨占 .agents/skills/ 下的一個目錄，必需檔是帶 YAML frontmatter 的 SKILL.md，至少包含 kebab-case 的 name，以及說明做什麼、何時該用的 description。不要編其他必填欄位。

3 分鐘完成第一次嘗試

官方頁面：

https://github.com/warpdotdev/common-skills

推薦安裝（--global 會改本機全域技能，先確認倉庫和 --agent warp 再執行）：

npx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global

說明沒有寫出 npx 裝到磁碟的哪個目錄。裝完後回到 Warp，看這些 common skills 是否可被選用。不要把倉庫裡的 .agents/skills/ 直接當成你機器上的安裝路徑。

第一次不要改共享技能內容，也不要 fork。只選一個低風險的唯讀任務，讓 Warp 按某個已裝技能的 description 判斷是否該用它。

成功訊號：Warp 裡能看到剛裝上的技能，並且助手是按 description 決定是否呼叫。命令失敗就停下，不要去掉 --agent warp 或改用未出現的安裝器。

使用案例

案例一：給 Warp 全域裝入全部 common skills。執行上面的 add ... --skill '*' --agent warp --global。--skill '*' 表示這個共享庫裡的技能集合。裝完只核 Warp 能否選用，不要同時再裝一套未點名的副本。

案例二：之後更新已安裝的 Warp 技能。說明給出的命令是：

npx skills@latest update --global --agent warp

同樣是全域寫入。先確認目前 Warp 環境，再執行，然後看技能是否仍可選用。若某個共享技能需要倉庫特例，說明要求加一個小的 local companion skill，而不是 fork 共享技能，除非改動對所有倉庫都有用。第一次更新不要做 fork。

使用邊界

主路徑只證據到 Warp：add 與 update 都帶 --agent warp --global。不要套到其他代理。

倉庫內佈局只證據到 .agents/skills/ 與 SKILL.md 的 name / description。不要把該目錄寫成 npx 的本機安裝位置。

優先只複製倉庫真正需要的技能；特例用 local companion，不要輕易 fork。

說明沒有給出語言範圍、定價或其他代理的安裝命令。缺依據的項目保持未知。