plugin

在支援的工具間管理完整的原生 plugin。Capability 檢查會區分安裝支援與格式探索(format discovery)。從 跨工具管理 plugin 開始。

skillshare plugin                         # Interactive manager
skillshare plugin add                     # Source → plugin → targets → review
skillshare plugin discover ./my-plugin --json
skillshare plugin add ./my-plugin --target claude --target codex --no-tui
skillshare plugin import review@team --from claude --no-tui
skillshare plugin list --json
skillshare plugin inspect review --json
skillshare plugin disable review --target codex --no-tui
skillshare sync plugins --dry-run --json
skillshare sync plugins --no-tui
skillshare plugin enable review --target codex --no-tui
skillshare plugin check review --json
skillshare plugin update review --target claude --no-tui
skillshare plugin remove review --no-tui

enable 和 disable 改變的是 Skillshare 的同步選擇，而非 Agent 原生的啟用狀態。取消選取某個 target 會儲存這個選擇。下一次 sync plugins 會移除其受管理的安裝，但保留定義。重新選取後， 下一次 sync 就會重新安裝。未受管理的 plugin 不受影響。

Commands

Command	Behavior
list	已設定的綁定與原生安裝狀態；在終端機中提供互動式管理介面
discover SOURCE	檢查本機目錄、owner/repo，或 HTTPS Git repository
add [SOURCE]	選擇並安裝整個 plugin 及其 target adapter
import [NATIVE-ID]	採用既有安裝，不重新安裝也不啟用
inspect NAME	檢查單一受管理的套件
sync [NAME]	協調已選的 target 並重試未完成的原生操作
check [NAME]	比對 source 內容與記錄的 digest；絕不更新
update [NAME]	檢視 source 變更並使用支援的原生更新操作
enable / disable [NAME]	在下一次 sync 中納入/排除某個 target
remove [NAME]	解除安裝受管理的綁定並移除其定義

在終端機中執行不帶參數的指令會提示輸入缺少的內容。非互動式的異動指令則需要明確的輸入。 sync 和 check 可以對所有套件操作。sync --all 不會包含 plugin；請明確使用 sync plugins。

Options

Option	Meaning
--target TARGET	可重複指定：claude、codex、cursor、antigravity（別名 agy）、antigravity-cli、copilot、grok、pi、opencode；請參閱下方的 capability 表
--plugin NAME	從 source marketplace 選擇一個 plugin
--name NAME	新增或匯入時使用的邏輯套件名稱
--from TARGET	從 Claude、Codex、Antigravity CLI、Copilot、Grok、Pi 或 OpenCode 匯入
--dry-run, -n	預覽而不變更 Skillshare 或 Agent 設定
--source-ref REF	用於 discover、add、update 的 Git branch、tag 或 commit；僅限遠端 source
--entry PATH	明確指定已建置的 OpenCode JS/TS 進入點，相對於套件根目錄（discover 與 add）
--revision ID	若自預覽以來 source、設定或原生清單已變更，則拒絕套用
--json	機器可讀輸出；停用 TUI
--no-tui	停用互動式選單；同時遵循 tui: false
--global, -g	全域 Skillshare 設定與原生使用者範圍
--project, -p	專案設定；Claude、Antigravity、Pi 或 OpenCode（絕不會回退到全域）

JSON 輸出包含 source 路徑與原生識別碼。請勿在 source URL 中放入憑證。即使某次異動失敗， 仍可能回傳部分 target 的成功結果；只要有任一 target 失敗，CLI 就會以非零狀態碼結束。 重試前請先檢查結果。

Target support

Target	Format	Global	Project	Update
Claude Code	.claude-plugin/plugin.json	Yes	Yes	原生更新
Codex	.codex-plugin/plugin.json 或 Agent Plugins 根目錄 manifest	Yes	No	不支援
Cursor	.cursor-plugin/plugin.json 或 Agent Plugins 根目錄 manifest	Yes	No	取代已檢視的本機複本
Antigravity Desktop	帶有明確名稱的根目錄 plugin.json	Yes	Yes	取代已檢視的本機複本
Pi	含 pi resources 的 package.json，或帶有 pi-package 關鍵字與慣用 resource 資料夾	Yes	Yes，需原生專案信任	重新整理受管理的 source 快照
OpenCode	含 SDK 依賴的 package.json、.opencode/plugins/ 項目，或明確的 --entry	Yes	Yes	重新整理受管理的 source 快照

| Antigravity CLI | agy 接受的原生根目錄 manifest 或 Claude manifest | Yes | No | 以原生方式更新以保留啟用狀態 | | GitHub Copilot CLI | .plugin/plugin.json、.github/plugin/plugin.json、Claude manifest，或 Agent Plugins 根目錄 manifest | Yes | No | 重新整理已檢視的 source，僅在原生啟用狀態已知且為啟用時 | | Grok Build | .grok-plugin/plugin.json 或 Claude manifest | 僅限匯入/移除；安裝需要原生信任 | No | 以原生方式更新 | | Kimi Code | kimi.plugin.json 或 .kimi-plugin/plugin.json | 僅限探索 | No | 未自動化 | | Hermes | .hermes-plugin/plugin.yaml | 僅限探索 | No | 未自動化 | | Devin | .devin-plugin/plugin.json | 僅限探索 | No | 未自動化 |

Kimi 的非互動式生命週期、Hermes 的 profile 清單/同意流程，以及 Devin 的本機清單/信任/雲端 區分，這些 adapter 尚未驗證。它們的格式會在探索階段顯示，但安裝功能會附上原因被停用。 source 宣告某個 target 不代表 Skillshare 就能管理它。list --json 與 discover --json 會包含 targetDefinitions，列出允許的操作；探索階段也會針對每種格式揭露 targetInfo，內容包含 版本、元件、進入點與驗證問題。損壞的 manifest 只會影響該 target；損壞的 catalog 則以警告方式 回報，不會隱藏有效的格式。

Cursor and Antigravity

這些 adapter 會將整個 plugin 複製到文件記載的本機探索目錄中，不需要 CLI 執行檔，也不會修改 marketplace registry：

• Cursor：~/.cursor/plugins/local/<name>；必須允許本機匯入。重新載入 Cursor 並檢查 Customize。 已從 marketplace 安裝、名稱相同的 plugin 優先於本機複本。
• Antigravity desktop：全域為 ~/.gemini/config/plugins/<name>；workspace 中為 .agents/plugins/<name>（或既有的 _agents/plugins/ 目錄）。若兩個 workspace 目錄都存在， 請先整合它們。
• 獨立的 agy CLI 有自己獨立的 plugin 儲存庫。antigravity target 管理的是 desktop/workspace 的探索路徑，不是那個 CLI 的儲存庫。agy 只是 Skillshare target 的別名。使用 --target antigravity-cli 代表獨立的 CLI；--target agy 則維持其既有的 desktop 意涵。

對這類本機套件請使用 plugin add。不支援匯入既有的本機資料夾或 marketplace 安裝。Skillshare 拒絕覆寫非自身擁有的資料夾、symlink，或本機已編輯過的受管理內容。明確的 Antigravity manifest 名稱能讓身分識別在 Git checkout 與快照之間保持穩定。

Pi and OpenCode

Pi 使用 pi install / pi remove；清單讀取的是文件記載的套件設定，不會載入 extension 程式碼。 會遵循 PI_CODING_AGENT_DIR。Pi 的專案信任必須在 Pi 中自行建立；Skillshare 不會替你傳遞 --approve。

OpenCode 會在 opencode.json 或既有的 opencode.jsonc 中，把受管理的進入點註冊為 file URL， 並保留註解與無關的項目。Version 1 使用 plugin；version 2 使用 plugins。會遵循 XDG_CONFIG_HOME 與絕對路徑的全域 OPENCODE_CONFIG；模糊或不支援的覆寫會被拒絕。OpenCode 必須位於 PATH 上，Skillshare 才能選擇對應版本的 schema。

本機 OpenCode source 必須已經包含建置好的進入點（main、字串形式的 root export，或 index.js）以及所需的執行期依賴。Skillshare 不會執行建置腳本，也不會將依賴安裝進 source。 註冊成功不代表模組已成功載入；請在重新載入後檢查 OpenCode。

匯入僅接受一般的 Pi package source 與一般的 OpenCode config 項目。帶有 resource filter/選項的 項目會被拒絕，以保留這些設定。已匯入的 Pi 與 OpenCode v1 套件會在其原生工具中更新。OpenCode v2 的全域匯入可以使用其原生更新指令；專案匯入則必須以原生方式更新，因為 v2 的更新指令是 全域性的。

skillshare plugin add ./cursor-plugin --target cursor --no-tui
skillshare plugin add ./agy-plugin --target agy --no-tui -p
skillshare plugin add ./pi-package --target pi --no-tui
skillshare plugin add ./opencode-package --target opencode --no-tui
skillshare plugin import npm:my-pi-package --from pi --name my-package --no-tui

Refs and explicit entries

Add plugin 中的進階選項可接受選填的 Git ref 與 OpenCode entry。一般的引導流程可以留空。 終端機精靈接受相同的旗標；自動化流程則可以使用：

skillshare plugin discover obra/superpowers --source-ref v6.3.0 --json
skillshare plugin add owner/repo --source-ref v1.0.0 --target copilot --no-tui
skillshare plugin add ./package --entry dist/plugin.js --target opencode --no-tui
skillshare plugin update review --source-ref v1.1.0 --target claude --dry-run --json

綁定會記錄 source_ref 以及解析後的 commit。安裝使用的是已檢視過的 commit；check 與 update 會重新解析設定的 ref，因此某個 branch 可以持續前進，而 commit 仍維持固定。--revision 是預覽用的 token，不是 Git ref。--entry 是相對於各候選項套件根目錄的路徑，且必須已經存在； 它不會觸發 build 或 package manager 安裝。

Copilot 與 Antigravity CLI 的安裝使用已檢視過的本機快照。匯入沒有可供重新安裝的已檢視 source： 移除後，請在原生用戶端中安裝並再次 sync。Grok 也需要原生信任才能安裝/重新安裝。Skillshare 絕不會提供原生信任核准旗標。

Compatibility and boundaries

• Claude 需要其原生的 .claude-plugin/plugin.json 套件。
• Codex 接受 .codex-plugin/plugin.json 以及可辨識的可攜式根目錄 plugin.json 套件。僅限 Claude 的套件不會被靜默轉換。
• Source 可能包含帶有本機 plugin 項目的 marketplace。外部 catalog 會依 plugin 名稱/路徑合併。 衝突的路徑會被拒絕；外部項目會附上說明，指引你直接加入其 repository，或以原生方式安裝後 再匯入。以指令為基礎的 source 不會自動核准。
• 完整的 source 快照會保留 plugin 腳本、資產，以及安全的相對 symlink（包含 AGENTS.md → CLAUDE.md）。絕對路徑、逃逸路徑、懸空、循環，以及參照 .git 的連結與特殊檔案 都會被拒絕；source 上限為 20,000 個檔案與 100 MiB。
• 原生安裝不代表已在執行期啟用。請重新啟動/重新載入該 Agent，並在該 Agent 中完成驗證或 hook 信任。
• 此 adapter 不提供 Codex 原生的專案安裝與 plugin 更新。全域 Codex 安裝的 sync 選擇仍然可用。
• 匯入的 plugin 會保留其原始的 marketplace 身分。對於沒有 source 的匯入 plugin，check 無法 推斷是否有新版本可用。
• 移除操作會保留共享的 marketplace 註冊與受管理的快照；不會直接刪除無關的 plugin 或原生 快取。

原生生命週期已在 Claude Code 2.1.276、Codex CLI 0.154.0、Pi 0.85.1，以及 Copilot CLI 1.0.86 上驗證過。Antigravity CLI 1.2.6 則以獨立的原生安裝/清單/移除操作進行檢查。OpenCode 1.18.31 用於驗證版本感知的註冊；v2 schema 則由 fixture 測試涵蓋。Cursor 與 Antigravity 的 檔案系統生命週期已在獨立目錄中測試，但不宣稱涵蓋 GUI 執行期的啟用。已安裝的指令 capability 與清單 schema 會在執行期檢查；不支援的操作會附上說明並被封鎖。

Official format references

• Cursor local plugins
• Antigravity desktop plugins
• Antigravity standalone CLI plugins
• Pi packages
• OpenCode v1 plugins
• OpenCode v2 plugins