yibie/skills-manager

Skills Manager – 用于组织 LLM 编码代理 skills 的 macOS UI

是什么

• 一款基于 SwiftUI/Swift 6 编写的原生 macOS（Sonoma +）应用程序，可让你发现、安装、测试和组织适用于大量代码生成代理（如 Claude Code、Cursor、Gemini CLI、OpenHands 等）的 skills（以提示为导向的扩展）。
• 以本地文件系统作为唯一可信来源：Library 存储原始技能包，Collections 将其分组用于项目或工作流，Mounts 按需创建符号链接到每个代理自身的技能目录中。

核心概念

层级	作用
Library	所有已下载技能包的中央只读存储库。
Collection	Library 中技能的可重用命名组（例如 Web‑dev、Data‑Science）。
Mount	一组符号链接，将一个 Collection 无复制地暴露于一个或多个代理中。

主要功能

• 发现 – 从公开的 skills.sh 目录拉取技能列表，本地缓存，并在联网时支持全站搜索。
• 试用 – 在确认安装前，可对本地配置的 LLM（Claude、OpenAI、OpenRouter、Ollama、LM Studio）运行技能进行测试。
• 安装 / 卸载 – 一键安装到任意支持的代理子集；卸载仅移除符号链接，保留 Library 不变。
• 冲突与状态视图 – 显示跨代理的缺失、共享、部分应用或分歧副本，支持手动解决。
• 翻译 – 内置 8 语言技能描述目录，新条目支持按需调用 LLM 作为后备。
• 终端 UI – 一个 blessed 风格的 TUI（tui/），功能与 macOS 应用完全一致，并保留本地 Git 历史用于回滚。
• 自动监控 – 监控代理的技能文件夹，当磁盘文件发生变化时自动刷新 UI。

支持的代理（通过内部 AgentRegistry 检测）。README 中列出超过 40 个代理；标有 Install target 的可在多安装选择器中选择，其余仍用于冲突扫描。

安装

1. 从 GitHub 发布页面下载签名的 zip 包，拖入 Applications（需 macOS 14+）。
2. 或使用 Xcode 构建源码（open SkillsManager.xcodeproj）。
3. 对于 TUI，cd tui && npm exec skills-manager（或 npm link 以全局安装 skills-manager 命令）。

架构与离线优先策略

• 完全本地优先：无远程后端，除非你显式刷新目录、翻译描述或调用 LLM 进行 Try，否则数据不会离开设备。
• 应用程序直接写入每个代理的配置文件，并维护本地 Git 日志以支持差异对比和回滚。
• 发现数据缓存于 ~/.skills-manager/cache/discover-directory.json；网络仅用于目录刷新、全站搜索、翻译后备和 LLM Try 调用。

路线图（截至 README）

• 发现技能的自动更新检测（计划中）
• 技能集的导出/导入（计划中）
• 通过共享仓库实现团队级同步（计划中）

许可证 – MIT。

---

Skills Manager 是为使用多个 LLM 基础编码助手的开发者量身打造的真实、生产级工具，提供统一方式管理日益增长的代理专用提示扩展生态。