skillshare

Skillshare CLI

使用 Skillshare 维护源，并将资源分发到已配置的目标。 只阅读与所请求操作相关的参考文档；路由表如下。 如果已安装的版本与这些示例不同，请检查 skillshare <command> --help。

范围与资源选择

• 全局配置：~/.config/skillshare/config.yaml。项目配置：.skillshare/config.yaml 或 skillshare/config.yaml；两者同时存在时，隐藏配置优先。位置很重要时，请显式使用 -g 或 -p， 不要依赖自动检测。
• Skills 是包含 SKILL.md 的目录；agents 是单个 Markdown 文件。 源路径可以自定义。请使用已配置的源，不要假定使用默认值。
• 对于 agents，请使用原生 agents 目标。对于任意文件资源，或需要扁平化／内容转换时，请使用 extras；extension: 仅适用于 extras 目标。
• 共享记忆笔记存放在 memory extra 中。使用 extras memory 管理 Markdown 笔记和阅读指引；支持 wiki/architecture.md 等嵌套路径。 如需了解作用范围、版本检查和 agent 设置，请阅读 extras.md。 如需对会话进行回顾，或根据已保存的笔记进行 Dreaming，请阅读 memory-review.md。回顾由宿主 agent 执行； Skillshare 不会启动或安排 agent。
• MCP 使用自己的接收目标和源定义。编辑 MCP 设置或导入原生配置前，请阅读 mcp.md。 其中的 Agent 说明介绍了 Claude Code、Codex、OpenCode 和 Pi 的特定事项：作用范围和文件、它们拒绝的名称和凭据、Pi 内置的 MCP 与 piOptions、OMP 原生 MCP 及其保留的启用／禁用列表、可移植的 tools 策略、从 0.22 升级 Pi 设置、在单个项目中关闭全局服务、从一个配置管理多个文件夹的 mcp.projects，以及供无法访问已同步技能文件夹的 Agents 使用的 mcp serve。
• Plugins 会将各自的原生组件放在一起。请阅读 plugins.md，了解 Claude、Codex、Cursor、Antigravity、Pi、OMP 和 OpenCode 的安装、导入、同步选择、更新及原生兼容性限制，包括来自 pi.dev 的 Pi 包、OMP marketplace plugins 和独立扩展的选择。
• Hooks 会保留各 Agent 原生的事件映射或扩展／插件代码。导入、同步或恢复前，请阅读 hooks.md。

执行规则

1. 选择非交互式输入。 提供特定命令支持的名称和选择标志。纯文本输出请使用 --no-tui；支持时请使用 --json。 不要仅为避免提示而添加 --force：它可能覆盖冲突或绕过审计。
2. 将预览与写入分开。 支持时请使用 --dry-run。更改 skills 或 agents 后，请同步预期的资源和作用范围。MCP 和 hooks 的修改只会保存源，除非提供 --sync；sync --all 也会包含 extras、MCP 和 hooks，但不包含 plugins。
3. 检查审计阻止项。 选择覆盖操作前，请查看审计结果。未提供 skill／agent 筛选条件时，install --json 允许覆盖并选择全部内容，但仍会执行审计门槛；它不只是输出格式。用于自动化前，请阅读 install.md 和 audit.md。
4. 使用匹配的恢复机制。 卸载的 skills 会移至回收站；原生 MCP 条目使用 MCP 备份。不要用文件系统删除代替 CLI 卸载。
5. 不要将凭据放入 MCP 定义。 请使用 {fromEnv: VARIABLE} 引用。 管理设置不需要解析密钥、复制 OAuth 凭据、启动服务或探测其工具。
6. 遵守操作范围。 本地配置工作并不意味着获准提交、推送或发布。仅当用户请求中包含这些操作时，才执行相应命令。

常见工作流

检查和诊断

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
管理完整的原生插件，包括 hooks/MCP	使用 plugin discover 和 plugin add；见下文

如需了解带范围的预览 → 应用 → 更新 → 同步工作流，请阅读 install.md。其中介绍了如何跟踪上游分支的最新内容、被拒绝的标志组合，以及目标筛选器。

如需设置项目，请使用 init -p，然后运行 install -p 和 sync -p。如需重新获取已配置的远程依赖项，请在不指定来源的情况下运行 install。有关完整标志详情和 Agent，请阅读 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。

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 中。

技能中心

skillshare hub add https://example.com/hub.json          # Save a hub source
skillshare hub add https://example.com/hub.json --label my-hub  # With custom label
skillshare hub add [email protected]:team/skills.git --label ghe  # SSH/private/GHE hub source
skillshare hub list                                      # List saved hubs
skillshare hub default my-hub                            # Set default hub
skillshare hub remove my-hub                             # Remove a hub
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Build hub index

启用的 follow_source_links 设置也适用于 hub index（包括 --source）、内置仪表板搜索和 Hub 草稿候选项。

参考资料

请阅读对应文件，了解命令标志、示例和限制。针对单个任务，请勿加载所有参考资料。

主题	文件
原生 Agent、选择、忽略规则和恢复	native-agents.md
MCP 配置、导入、TUI 和恢复	mcp.md
原生钩子、代码绑定、作用域和恢复	hooks.md
完整插件、原生生命周期和同步选择	plugins.md
Init 标志	init.md
同步/收集/提交/推送/拉取	sync.md
安装/更新/卸载/移动/新建	install.md
状态/差异/列表/搜索/检查	status.md
安全审计	audit.md
回收站	trash.md
操作日志	log.md
目标	targets.md
扩展内容（规则/命令/提示词）	extras.md
会话回顾与对已保存笔记进行 Dreaming	memory-review.md
备份/恢复	backup.md
故障排除	TROUBLESHOOTING.md