Skills Manager：用一款 macOS 原生应用统一管理所有 AI 编程助手的 Skills

Skills Manager 是一款 macOS 原生应用，用来集中管理你所有 AI 编程助手的 skills——Claude Code、Cursor、Codex、Gemini CLI、Qwen Code 等四十多个工具的技能，都能在一个界面里发现、安装、测试和管理。

项目简介

写代码的人手上往往不止一个 AI 编程助手。Claude Code 用一套 skills，Cursor 用另一套，Codex、Gemini CLI 各有各的格式和安装路径，散落在系统的不同角落里。Skills Manager 想解决的就是这个「各管各的」混乱局面，把所有 agent 的 skills 收拢到同一个地方。

这个项目由 yibie 开发维护，目前在 GitHub 上拿到了 172 颗星，主要用 Swift 编写（占 67%），配套还有一个 TypeScript 写的终端 UI。最新版本是 v1.0.5。

解决什么问题

每个 AI 编程助手都有自己的 skills 体系：安装位置不同、文件格式不同、管理方式也不同。手动管理意味着你要记清楚每个工具的目录在哪、格式怎么写、怎么更新。当 agent 数量一多，这件事就会变成持续的心智负担。

Skills Manager 做的事是把这些差异抹平：

• 统一界面查看所有 agent 已安装的 skills
• 从 skills.sh 等社区源一次性发现新 skills
• 一键安装到多个 agent，不用每个目录去手动放
• 内置 LLM 沙箱，安装前先试一下效果

核心特性

多源发现：除了内置的 skills.sh 列表，还支持全站搜索，能找到初始列表之外的内容。本地有缓存，离线也能用。

多目标安装：一个 skill 可以同时装到多个 agent，不用反复操作。目前在多选安装器里支持的 agent 包括 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、Qwen Code、Roo Code、Continue 等。

沙箱测试：装之前能在内置的 LLM 沙箱里先跑一遍，确认这个 skill 真的好用再决定要不要留下。

统一管理：更新、删除、收藏都在一个界面完成，还能实时监控所有 agent 的 skills 目录变化。

中文翻译：发现页面的 skill 描述做了中文翻译，内置了一份翻译目录；对新加载的、还没翻译的描述，保留一个按需翻译的按钮作为兜底。

支持的 Agent

Skills Manager 通过 AgentRegistry 检测和扫描下面这些 agent。带「安装目标」标记的，可以出现在多选安装器里；其余的也会被检测和扫描。

完整列表覆盖了四十多个 agent，从主流的 Claude Code、Cursor 到相对小众的 Pi、MCPJam、Mux 都包含在内。

技术栈

桌面端是纯原生实现：

• SwiftUI + Swift 6 — 界面和业务逻辑
• SwiftData — 本地数据持久化
• macOS 14+ — 最低系统要求

终端 UI 用的是 TypeScript：

• Blessed TUI — 当前主要的终端实现
• Ink TUI — 保留作历史参考，不再是目标运行时

整个应用是纯本地架构，没有后端服务器。除了 Discover 刷新、详情加载、翻译兜底、沙箱 LLM 调用这几个联网功能外，其余都离线可用。它直接读写 agent 的配置文件，用本地 Git 历史做版本管理。

安装指南

桌面应用

最简单的方式是从 GitHub Releases 页面下载，拖进 Applications 就能用。

要求：

• macOS 14（Sonoma）或更高
• 至少装了一个 AI 编程助手

也可以从源码构建：

git clone https://github.com/yibie/skills-manager.git
cd skills-manager
open SkillsManager.xcodeproj

终端 UI

仓库里的 tui/ 目录是终端版本，基于 Blessed TUI：

cd tui
npm exec skills-manager

如果想全局安装，在 tui/ 目录里执行一次：

npm link

之后就能在任何地方用 skills-manager 命令启动。

终端 UI 能做什么

终端版目前支持的功能：

• 三栏式、键盘优先的导航
• 从 skills.sh 发现新 skills
• 安装、卸载、收藏
• 打开 skill 源文件、跳转到发现页源页面
• 搜索、详情浮层、全量刷新
• 区分本地 skill 和插件（包含 Codex 插件缓存、Pi 包资源）

版本历史功能目前暂时禁用了，后续会补回来。

Discover 与翻译

Discover 页面启动很快，先从本地缓存 ~/.skills-manager/cache/discover-directory.json 读取，然后在后台从 skills.sh 刷新。

搜索逻辑：联网时走 skills.sh 的全站 API，离线时回退到缓存的查询快照。

翻译这块有个细节值得说。本地起的 Ollama 和 LM Studio 服务，macOS 的 localhost 会解析到 IPv6 的 ::1，导致连不上。Skills Manager 在运行时把这些端点统一规范化成 IPv4 的 127.0.0.1，绕开了这个问题。如果你自己接本地模型碰到过连接失败的坑，这个小处理能省不少排查时间。

架构设计

整个项目的定位是「纯本地、无后端」：

• 数据全部存在本地，SwiftData 管理
• 直接读写 agent 的配置文件，不经过中间层
• 版本管理用本地 Git 历史
• 只有联网功能（Discover 刷新搜索、详情加载、翻译兜底、沙箱 LLM）才需要网络

这种设计的好处是隐私和数据自主权——你的 skills 配置、使用记录都不会离开你的机器。

Roadmap

项目还在持续迭代，已经规划的方向包括：

• 发现的 skills 自动更新检测
• 跨 agent 的 skill 冲突检测
• skill 集合的导出和导入
• 通过共享 skills 仓库做团队同步

项目链接

• GitHub 仓库：https://github.com/yibie/skills-manager
• 官方网站：https://www.gtdstudy.com/skills-manager/
• 最新版本：v1.0.5
• 开源协议：MIT

如果你手上 agent 比较多、skills 管理已经有点失控，Skills Manager 值得装一个试试。终端版本甚至不用开 Xcode 就能跑起来，门槛很低。