如何更新、回復與移除 Agent Skills

簡短回答

要更新 Skillry 的 Skill，就用 --force 再執行一次安裝指令。CLI 會把舊的那份移到 Skills 旁邊的 .best-ai-skills/backups/，並印出它的位置。沒有獨立的更新或解除安裝指令。

留下簡短的紀錄

六個月後，有人會發現 .claude/skills/launch-page/，然後不確定能不能動它。在 repo 的 README 寫上四行就能回答這個問題：

README.md

## Agent Skills in this repo
- launch-page: from skillry.dev/skills/bs-meridian-marketing-landing
  version 1.2.0, project scope (.claude/skills), Claude Code
  local change: brand colors in references/palette.md

如何更新 Skill

更新 Skill 的方式是用 --force 重新安裝。CLI 會下載最新版本並替換整個資料夾，所以先看過再更新，更新後再測試：

1
在 Skill 頁面上查看有哪些變更，特別是腳本、相依項目和外部費用。
2
用 --force 重新安裝，並使用和上次相同的 agent 或 target。不加這個參數的話，CLI 會顯示「already exists. Re-run with --force to replace it safely.」並停止。
終端機
```
npx --yes skillry-cli@latest install <slug> --force
```
你應該會看到： Installed <slug> <version> to … 和 Previous version preserved at …
3
照平常的方式測試：用名稱執行一次，再用一般說法執行一次。

在本機修改過 Skill？--force 會覆蓋這些修改。請先複製出來，或把它們放在 references/ 裡，方便之後重新套用。

回復有問題的更新

每次強制安裝都會把舊的那份留在 Skills 旁邊，例如 ~/.agents/skills/.best-ai-skills/backups/<slug>-<date>-<id>/。Agent 不會載入這個資料夾。要回到舊版，請刪除目前使用中的 <slug>/ 資料夾，把備份移到原位，並重新命名為 <slug>。

如果安裝中途失敗，CLI 會自動還原舊的那份。

移除 Skill

要移除 Skill，就刪除它的資料夾。接著在個人和專案資料夾中搜尋是否還有另一份同名的 Skill。在 Claude Code 中，個人的那份優先於專案的那份，所以殘留的副本可能讓之後的更新看起來像是沒生效。Skill 存放位置列出了所有資料夾。

與團隊共用同一份

把一份審查過的副本 commit 到 repository 的 Skills 資料夾，並註明它的相依項目，讓每個人都執行同一個版本。要把 Skillry 的 Skill 安裝到那裡，請使用 --target：

終端機，在 repo 內

npx --yes skillry-cli@latest install <slug> --target .claude/skills

常見問題

怎麼更新 Claude Skills？

用 --force 再執行一次 Skillry 安裝指令，或替換 ~/.claude/skills/ 中整個 Skill 資料夾。Claude Code 會在目前的工作階段中讀到這項變更。

為什麼我的 Skill 更新沒有生效？

通常是別處還裝了另一份同名的 Skill，或只替換了 SKILL.md。搜尋你的個人和專案 Skill 資料夾，只保留一份完整的副本。

怎麼回復 Skill 的更新？

刪除目前使用中的 <slug>/ 資料夾，把 .best-ai-skills/backups/ 中的備份移到原位，並重新命名為 <slug>。CLI 在更新時會印出備份路徑。

怎麼解除安裝 Skill？

刪除它的資料夾。Skillry CLI 沒有解除安裝指令，所以之後請檢查是否還有殘留的同名副本。

參考來源

這篇指南對你有幫助嗎？