用途：Skillshare CLI 用于把技能从单一来源同步到多个 AI CLI 工具（Claude、Cursor、Windsurf 等），避免在各工具间重复维护。
两种模式：全局模式将 ~/.config/skillshare/skills 分发到 ~/.claude/skills、~/.cursor/skills 等；项目模式将 .skillshare/skills/ 分发到仓库内的 .claude/skills、.cursor/skills。当当前目录存在 .skillshare/config.yaml 时自动进入项目模式，可用 -p（项目）或 -g（全局）强制指定。
主要命令：检查类 status、diff、list、doctor；同步类 sync、collect；远程 push、pull（需配合 git）；技能管理 new、install、uninstall、update、check、search；目标管理 target add/remove/list；安全审计 audit [name]；回收站 trash list|restore|delete|empty；日志 log [--audit] [--tail N]；备份 backup、restore；Web UI ui（-g 全局，-p 项目）；升级 upgrade [--cli|--skill]。多数命令修改后需执行 sync 才能分发变更。
非交互用法：AI 无法响应交互提示，需传参跳过。例如全局初始化 skillshare init --no-copy --all-targets --git --skill；项目初始化 skillshare init -p --targets "claude,cursor"；安装全部 skillshare install user/repo --all；选择特定 skillshare install user/repo -s pdf,commit。
安全与限制：install 会自动扫描技能，CRITICAL 发现会阻止安装（可用 --force 覆盖）；install 会显示 SKILL.md frontmatter 中的许可证。uninstall 支持多名称与 --group/-G 批量移除，并自动识别分组目录；卸载会移入回收站（保留 7 天），可用 trash restore <name> 恢复。切勿对符号链接技能执行 rm -rf，会删除源文件，应使用 skillshare uninstall 或 target remove。push、pull、backup、restore 不支持项目模式自动切换。更多细节见 init.md、sync.md、install.md、status.md、audit.md、trash.md、log.md、targets.md、backup.md 与 TROUBLESHOOTING.md。