Skillshare CLI
使用 Skillshare 维护一个源并向已配置的目标分发资源。
只读取与请求操作相关的参考；路由表如下。
如果安装版本与这些示例不同，请查看 skillshare <command> --help。
作用域和资源选择
- 全局配置：
~/.config/skillshare/config.yaml。项目配置：.skillshare/config.yaml或skillshare/config.yaml；当两者都存在时，隐藏文件优先。当位置重要时，请明确使用-g或-p， 而不是依赖自动检测。 - 技能是包含
SKILL.md的目录；代理是单个 Markdown 文件。 源路径可以自定义。请使用已配置的源，而不是假设使用默认值。 - 被追踪的
skills/<known-agent>/<skill-path>/SKILL.md副本在每个仓库/前缀/后缀下形成一个逻辑技能。 合并/复制会选择确切的代理变体（包括别名和账户agent:身份）。识别要求两个不同的规范代理下具有相同的后缀。 共享一个文件夹的兼容目标会选择其代理身份的并集；仅限通用的目标不会推断代理。 状态计数逻辑技能和物理变体；列表和同步操作保留物理名称。明确的 target/覆盖和物理过滤器仍然适用。 全目录符号链接模式会暴露所有变体。请参阅 sync.md。 - 对代理使用原生代理目标。对任意文件资源或在需要扁平化/内容转换时使用附加组件；
extension:仅在附加组件目标上工作。 - 共享记忆笔记位于
memory附加组件中。使用extras memory管理 Markdown 笔记和阅读指导；支持嵌套路径，如wiki/architecture.md。 有关作用域、版本检查和代理设置，请阅读 extras.md。 如需进行会话回顾或跨已保存笔记的梦境式处理，请阅读 memory-review.md。回顾由宿主代理执行； Skillshare 从不启动或调度代理。 - MCP 使用其自身的接收目标和源定义。在编辑 MCP 设置或导入原生配置之前，请阅读 mcp.md。
它的代理说明涵盖了针对 Claude Code、Codex、OpenCode 和 Pi 的具体内容：作用域和文件，它们拒绝的名称和凭据，Pi 的内置 MCP 和
piOptions，OMP 的原生 MCP 和保留的启用/禁用列表，可移动的tools策略， 从 0.22 升级 Pi 设置，在一个项目中关闭全局服务器，mcp.projects用于从一个配置管理多个文件夹，以及mcp serve用于无法访问已同步技能文件夹的代理。 - 插件将它们的原生组件保持在一起。有关针对 Claude、Codex、Cursor、Antigravity、Pi、OMP 和 OpenCode 的安装、导入、同步选择、更新和原生兼容性限制，请阅读 plugins.md，包括来自 pi.dev 的 Pi 包， 以及 OMP 市场插件和独立扩展选择。
- 钩子保留每个代理的原生事件映射或扩展/插件代码。在导入、同步或恢复之前，请阅读 hooks.md。
执行规则
- 选择非交互式输入。 提供特定命令支持的名称和选择标志。使用
--no-tui进行纯文本输出，或在支持的地方使用--json。 不要仅仅为了避免提示而添加--force：它可能会覆盖冲突或绕过审计。 - 保持预览与写入分开。 在支持的地方使用
--dry-run。更改技能或代理后，同步预期的资源和作用域。MCP 和钩子突变仅保存源， 除非提供了--sync；sync --all还包括附加组件、MCP 和钩子，但不包括插件。 - 检查审计块。 在选择覆盖之前审查发现。
install --json允许覆盖并在没有给出技能/代理过滤器时选择全部，但保留审计门控；它不仅仅是一种输出格式。在将其用于自动化之前，请阅读 install.md 和 audit.md。 - 使用匹配的恢复机制。 已卸载的技能进入回收站；原生 MCP 条目使用 MCP 备份。不要用文件系统删除代替 CLI 卸载。
- 将凭据排除在 MCP 定义之外。 使用
{fromEnv: VARIABLE}引用。 管理设置不需要解析密钥、复制 OAuth 凭据、启动服务器或探测其工具。 - 尊重操作作用域。 本地配置工作并不意味着有权限提交、推送或发布。只有当这些命令包含在用户的请求中时才运行它们。
常见工作流程
检查和诊断
skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json
doctor 在发现错误时以退出码 1 退出。审计使用 --format json；JSON 标志和
TUI 的可用性因命令而异。请查阅相关参考，而不是假定一致性。
追踪上游仓库或安装选定的技能
在安装之前选择资源和作用域。对用户范围的资源使用 -g，
或对此项目使用 -p；在预览、应用、更新和同步时保持该作用域。
| 意图 | 命令 |
|---|---|
| 将一个上游技能集合保留为一个 Git 检出 | skillshare install owner/repo --track --name team -g |
| 仅安装带有源元数据的命名技能 | skillshare install owner/repo -s pdf,commit -g |
| 单独安装所有发现的技能 | skillshare install owner/repo --all -g |
| 管理一个完整的原生插件，包括钩子/MCP | 使用 plugin discover 和 plugin add；见下文 |
对于作用域预览 → 应用 → 更新 → 同步工作流程，请阅读 install.md。它涵盖了 跟踪最新的上游分支、被拒绝的标志组合以及目标过滤器。
对于项目设置，使用 init -p，然后 install -p 和 sync -p。使用不带源的 install 命令重新水化配置好的远程依赖项。有关完整的标志细节和代理，请阅读
install.md 和 sync.md。
要就位使用本地技能检出，请运行 skillshare link <path> --enable，然后运行
sync；skillshare unlink <name> 仅移除该链接。有关如何跟踪此类链接，请阅读
TROUBLESHOOTING.md。
禁用或移除
skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync
只运行请求的操作，而不是整个示例序列。引用 glob 模式，以便 Skillshare 原样接收它们。禁用使用忽略规则；卸载使用回收站。
将技能移动到文件夹中
skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync
对已安装的技能使用 move 而不是 mv：它会保留它们的安装记录，因此
无需再次下载。它不进行同步；之后运行 sync。有关拒绝和项目模式，请阅读
install.md。
从全局配置管理项目文件夹
skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json
project 始终使用全局配置，即使在仓库内部也是如此；它不接受 -p。
新项目保存在 config.yaml 中，或者使用 --machine-local 或 projects_storage: machine-local（--shared 会覆盖该设置）仅保存在此机器上；
localize 和 share 在两者之间移动一个项目。移除 config.yaml 项目的本地副本会保留 config.yaml 中的版本，除非提供了 --shared。编辑过滤器会替换列表。移除会分离技能并保留代理文件；
除非预览，否则 JSON 移除需要 --yes。有关保存后同步失败、重试和部分移除结果，请阅读 targets.md。
MCP 设置
skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp
--target 是单数且可重复的。预览不会应用更改。有关修订、
编辑、导入冲突、凭据、备份和人工操作的 TUI 命令，请阅读
mcp.md。
完整插件
对完整的原生包使用 plugin discover 和 plugin add；plugin import
采用现有的原生安装。只运行请求的操作。在应用更改之前，请阅读
plugins.md；它涵盖了作用域
上游工作流程、支持的目标和源引用规则。
plugin check/update 处理上游更改；sync plugins 协调目标
选择。插件被排除在 sync --all 之外。
技能中心（Hubs）
skillshare hub add https://example.com/hub.json # 保存一个中心源
skillshare hub add https://example.com/hub.json --label my-hub # 带有自定义标签
skillshare hub add [email protected]:team/skills.git --label ghe # SSH/私有/GHE 中心源
skillshare hub list # 列出已保存的中心
skillshare hub default my-hub # 设置默认中心
skillshare hub remove my-hub # 移除一个中心
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit # 构建中心索引
活动的 follow_source_links 设置也适用于 hub index（包括
--source）、内置仪表板搜索和 Hub 草稿候选项。
参考资料
为命令标志、示例和限制阅读匹配的文件。避免为单个任务加载所有参考资料。
| 主题 | 文件 |
|---|---|
| 原生代理、选择、忽略规则和恢复 | native-agents.md |
| MCP 配置、导入、TUI 和恢复 | mcp.md |
| 原生钩子、代码绑定、作用域和恢复 | hooks.md |
| 完整插件、原生生命周期和同步选择 | plugins.md |
| 初始化标志 | init.md |
| 同步/收集/提交/推送/拉取 | sync.md |
| 安装/更新/卸载/移动/新建 | install.md |
| 状态/差异/列表/搜索/检查 | status.md |
| 安全审计 | audit.md |
| 安装前审查不受信任的技能 | audit-review.md |
| 回收站 | trash.md |
| 操作日志 | log.md |
| 目标 | targets.md |
| 附加组件（规则/命令/提示） | extras.md |
| 会话回顾和已保存笔记的梦境式处理 | memory-review.md |
| 备份/恢复 | backup.md |
| 故障排除 | TROUBLESHOOTING.md |