plugin

在受支持的工具间管理完整的原生 plugins。Capability 检查会区分安装支持与格式发现。可以从在多个工具间共享 plugins 开始。

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 重新安装。未受管理的 plugins 不受影响。

命令

Command	Behavior
`list`	Configured bindings and native installation state; interactive manager in a terminal
`discover SOURCE`	Inspect a local directory, `owner/repo`, or HTTPS Git repository
`add [SOURCE]`	Choose and install a whole plugin with its target adapter
`import [NATIVE-ID]`	Adopt an existing installation without reinstalling or enabling it
`inspect NAME`	Inspect one managed package
`sync [NAME]`	Reconcile selected targets and retry incomplete native operations
`check [NAME]`	Compare source content with the recorded digest; never update
`update [NAME]`	Review source changes and use a supported native update operation
`enable / disable [NAME]`	Include/exclude a target in the next sync
`remove [NAME]`	Uninstall managed bindings and remove their definitions

裸命令会在终端中提示缺失的输入。非交互式的变更命令需要显式输入。 sync 和 check 可以对所有 packages 进行操作。sync --all 不包含 plugins；请显式使用 sync plugins。

选项

Option	Meaning
`--target TARGET`	Repeatable selection: `claude`, `codex`, `cursor`, `antigravity` (`agy` alias), `antigravity-cli`, `copilot`, `grok`, `pi`, `opencode`; see the capability table below
`--plugin NAME`	Select one plugin from a source marketplace
`--name NAME`	Logical package name when adding or importing
`--from TARGET`	Import from Claude, Codex, Antigravity CLI, Copilot, Grok, Pi, or OpenCode
`--dry-run`, `-n`	Preview without changing Skillshare or Agent configuration
`--source-ref REF`	Git branch, tag, or commit for `discover`, `add`, and `update`; remote sources only
`--entry PATH`	Explicit built OpenCode JS/TS entry, relative to the package root (`discover` and `add`)
`--revision ID`	Refuse application if source, configuration, or native inventory changed since preview
`--json`	Machine-readable output; disables TUI
`--no-tui`	Disable interactive menus; also respects `tui: false`
`--global`, `-g`	Global Skillshare config and native user scope
`--project`, `-p`	Project config; Claude, Antigravity, Pi, or OpenCode (never global fallback)

JSON 输出包含来源路径和原生标识符。不要在来源 URL 中放置凭据。一次失败的变更操作仍可能对部分 targets 返回成功结果；当任何 target 失败时，CLI 会以非零代码退出。重试之前请先检查结果。

Target 支持

Target	Format	Global	Project	Update
Claude Code	`.claude-plugin/plugin.json`	Yes	Yes	Native update
Codex	`.codex-plugin/plugin.json` or Agent Plugins root manifest	Yes	No	Not supported
Cursor	`.cursor-plugin/plugin.json` or Agent Plugins root manifest	Yes	No	Replace reviewed local copy
Antigravity Desktop	Root `plugin.json` with an explicit name	Yes	Yes	Replace reviewed local copy
Pi	`package.json` with `pi` resources, or `pi-package` keyword and conventional resource folders	Yes	Yes, with native project trust	Refresh managed source snapshot
OpenCode	`package.json` with an SDK dependency, `.opencode/plugins/` entry, or explicit `--entry`	Yes	Yes	Refresh managed source snapshot

Kimi 的非交互式生命周期、Hermes 的 profile 清单/同意流程，以及 Devin 的本地清单/信任/云端区分，这些适配器尚未验证。它们的格式会在 discovery 阶段展示，但安装会被禁用并给出原因。来源声明支持某个 target 并不意味着 Skillshare 就能管理它。list --json 和 discover --json 包含 targetDefinitions，列出允许的操作；discovery 还会为每种格式暴露 targetInfo，包含版本、组件、entry 和验证问题。损坏的 manifest 只会隔离到其对应的 target；格式错误的 catalog 会以警告形式报告，而不会隐藏有效的格式。

Cursor 与 Antigravity

这些适配器会将整个 plugin 复制到有文档记录的本地发现目录中。它们不需要 CLI 可执行文件，也不会修改 marketplace 注册表：

Cursor：~/.cursor/plugins/local/<name>；必须允许本地导入。重新加载 Cursor 并检查 Customize。已安装的同名 marketplace plugin 优先于本地副本。
Antigravity desktop：全局为 ~/.gemini/config/plugins/<name>；在工作区中为 .agents/plugins/<name> （或已存在的 _agents/plugins/ 目录）。如果两个工作区目录都存在，请先合并它们。
独立的 agy CLI 有单独的 plugin store。antigravity target 管理的是 desktop/workspace 的发现路径，而不是该 CLI store。agy 只是 Skillshare target 的一个别名；使用 --target antigravity-cli 表示独立 CLI，--target agy 保留其原有的 desktop 含义。

对这些本地 packages 使用 plugin add。不支持导入预先存在的本地文件夹或 marketplace 安装。Skillshare 拒绝覆盖非自身拥有的文件夹、symlinks 或本地已编辑的受管理内容。显式的 Antigravity manifest 名称可以在 Git 检出和快照之间保持身份稳定。

Pi 与 OpenCode

Pi 使用 pi install / pi remove；清单读取有文档记录的 package 设置，而不加载 extension 代码。PI_CODING_AGENT_DIR 会被遵循。Pi 的 project trust 必须在 Pi 中建立； Skillshare 不会替你传递 --approve。

OpenCode 会在 opencode.json 或已存在的 opencode.jsonc 中将受管理的 entry 注册为文件 URL，并保留注释和无关的条目。Version 1 使用 plugin；version 2 使用 plugins。XDG_CONFIG_HOME 和绝对路径的全局 OPENCODE_CONFIG 会被遵循；含糊或不受支持的覆盖会被拒绝。 OpenCode 必须在 PATH 上，以便 Skillshare 能够选择对应版本的 schema。

本地 OpenCode source 必须已经包含其构建好的 entry（main、字符串形式的 root export，或 index.js）以及所需的运行时依赖。Skillshare 不会运行构建脚本，也不会将依赖安装到 source 中。注册成功并不代表模块已成功加载；请在重新加载后检查 OpenCode。

Import 接受普通的 Pi package 来源和普通的 OpenCode 配置条目。带有资源过滤器/选项的条目会被拒绝，以保留这些设置。已导入的 Pi 和 OpenCode v1 packages 会在其原生工具中更新。 OpenCode v2 的全局导入可以使用其原生的更新命令；project 导入则必须原生更新，因为 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 与显式 entries

Add plugin 中的高级选项接受可选的 Git ref 和 OpenCode entry。留空即可使用正常的引导流程。终端向导接受相同的 flags；自动化场景可以使用：

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

Bindings 会记录 source_ref 和解析出的 commit。安装使用的是已审阅的 commit；check 和 update 会重新解析配置的 ref，因此分支可以继续推进，而 commit 则保持锁定。--revision 是一个预览 token，而不是 Git ref。--entry 是相对于每个候选 package root 的路径，且必须已存在；它不会触发构建或 package manager 安装。

Copilot 和 Antigravity CLI 的安装使用已审阅的本地快照。Imports 没有可供重新安装的已审阅来源：移除后，需要在原生客户端中安装，然后再次 sync。Grok 也需要在安装/重新安装前建立原生信任。 Skillshare 从不提供原生信任的批准 flags。

兼容性与边界

Claude 需要其原生的 .claude-plugin/plugin.json package。
Codex 接受 .codex-plugin/plugin.json 以及可识别的、便携的 root plugin.json packages。仅限 Claude 的 package 不会被静默转换。
Sources 可能包含带有本地 plugin 条目的 marketplace。外部 catalog catalogs 会按 plugin 名称/路径合并。冲突的路径会被拒绝；外部条目会连同说明一起报告，提示直接添加其 repository 或原生安装后再导入。基于命令的 sources 不会被自动批准。
完整的 source 快照会保留 plugin 脚本、资源和安全的相对 symlinks（包括 AGENTS.md → CLAUDE.md）。绝对路径、逃逸路径、悬挂、循环以及引用 .git 的链接和特殊文件会被拒绝；sources 限制为 20,000 个文件和 100 MiB。
原生安装并不能证明运行时已激活。请重启/重新加载该 Agent，并在该 Agent 中完成认证或 hook trust。
Codex 原生 project 安装和 plugin 更新不由此适配器提供。同步选择对全局 Codex 安装仍然有效。
已导入的 plugins 保留其原始的 marketplace 身份。check 无法为没有 source 的已导入 plugin 推断发布可用性。
Removal 会保留共享的 marketplace 注册和受管理的快照；它不会直接删除无关的 plugins 或原生缓存。

原生生命周期已在 Claude Code 2.1.276、Codex CLI 0.154.0、Pi 0.85.1 和 Copilot CLI 1.0.86 上验证。Antigravity CLI 1.2.6 通过隔离的原生 install/list/remove 操作进行了检查。OpenCode 1.18.31 用于验证版本感知的注册；v2 schema 由 fixture 测试覆盖。Cursor 和 Antigravity 的文件系统生命周期在隔离目录中进行了测试，但不代表已验证 GUI 运行时激活。已安装的命令 capabilities 和清单 schemas 会在运行时检查；不受支持的操作会被阻止并给出说明。

命令​

选项​

Target 支持​

Cursor 与 Antigravity​

Pi 与 OpenCode​

Refs 与显式 entries​

兼容性与边界​

官方格式参考​

命令

选项

Target 支持

Cursor 与 Antigravity

Pi 与 OpenCode

Refs 与显式 entries

兼容性与边界

官方格式参考