一个 Skills 管理工具,解决一些痛点问题,已开源

konnga403 2026-08-25 10:03 1

现在 Skills 生态已经发展的很好了,而随着 AI Agent 的壮大,Skills 的管理也成了一个头痛的问题。


image.png


Agent 用的越多,Skills 却散落在各处


image.png


现在同时使用多个 Agent 变得很常见:


开发者可能在不同场景下使用:



  • Claude Code

  • Codex

  • Cursor

  • Gemini CLI

  • GitHub Copilot

  • Trae

  • OpenCode

  • CodeBuddy

  • WorkBuddy

  • ...


不同 Agent 的 Skills 通常保存在各自约定的目录中。


当只使用一个 Agent 、安装三五个 Skills 时,直接管理文件夹并没有什么问题。可是一旦 Agent 和 Skills 的数量增加,事情就变得复杂了。


你可能会遇到这些情况:



  • 不知道电脑里一共安装了多少 Skills ;

  • 不知道某个 Skill 被安装到了哪些 Agent ;

  • 同一个 Skill 被复制到多个目录,占据了多个独立副本;

  • 新安装一个 Agent 后,需要重新寻找和安装常用 Skills ;

  • 全局 Skills 和项目级 Skills 混在一起;

  • 已经不再使用的 Skill 留在某个角落,很久以后才被发现。


文件夹只能告诉用户“文件放在哪里”,却很难回答“当前拥有哪些能力”。


这就是第一个明显的管理痛点:Agent 众多,但缺少一个统一的 Skills 视图管理。


缺少的不是一个 Skills 市场,而是可视化管理


image.png


现在已经有 skills.sh 、skillhub 、GitHub 等渠道帮助我们发现 Skills ,也有命令行工具帮助用户完成安装。


它们很好地解决了 “去哪里找”“怎么装” 的问题。


但长期使用时,用户还需要知道:



  • 这个 Skill 是做什么的?

  • 它来自哪里?

  • 它安装在哪些 Agent 中?

  • 它属于全局范围还是项目范围?

  • 它当前是否启用?

  • 多个 Agent 中的同名 Skill 内容是否一致?

  • 哪些 Skills 是自己的,哪些来自插件或系统?


当 Skills 从几个变成几十个甚至更多时,继续依赖命令行和文件目录,会逐渐失去整体视角。


更理想的方式,是提供一个类似软件包管理器的工作台,打开以后就能看到本机所有 Agent 、Skills 、安装位置和状态,而 SkillBuddy 则是为此而来。


同一个 Skill ,为什么会出现好几个版本?


img.png


把一个 Skill 安装到多个 Agent ,本质上通常意味着在多个目录中保存它的副本。


刚安装时,它们的内容完全相同。但使用一段时间后,很容易出现这样的情况:



  1. Codex 中的 Skill 规则被修改;

  2. Claude Code 中还保留着旧内容;

  3. Cursor 的项目目录中又有一个针对当前项目调整过的版本;

  4. 三个目录里的文件名相同,但内容已经不一样了。


这类问题可以称为 Skills 内容漂移


它比“有没有安装”更难发现。因为从文件名来看,一切似乎都很正常,只有真正比较文件内容时,才能发现它们已经不是同一份 Skill 。


SkillBuddy 会聚合不同 Agent 中的同名 Skills ,并提示内容不一致。用户可以查看差异,选择一个可信版本作为基准,再同步到其他目标。


这意味着 Skills 管理不再只是复制文件,还包括:



  • 识别重复副本;

  • 检测内容差异;

  • 判断哪个版本是基准;

  • 预览同步范围;

  • 将确认后的内容分发到其他 Agent 。


全局 Skills 和项目 Skills ,也应该分开管理


image2.png


并不是所有 Skills 都适合全局安装。


例如:



  • Vue 3 通用开发规范,可以作为个人全局 Skill ;

  • 某家公司的接口约定,只适合公司的项目;

  • 某个仓库的目录结构和业务规则,只应该跟随当前项目;

  • 临时实验规则,可能只在一个项目中使用几天。


如果把所有 Skills 都放在全局目录中,Agent 会接收到越来越多与当前任务无关的信息。如果全部放进项目,又会出现大量重复配置。


因此,Skills 管理需要明确区分:



  • 用户级 Skills:面向个人,在多个项目中复用;

  • 项目级 Skills:跟随仓库,只服务于特定项目;

  • 插件或系统 Skills:由外部工具维护,通常不应随意修改。


SkillBuddy 可以添加项目目录,扫描项目中的 Skills ,并把它们与用户级 Skills 分开展示。


一个 Skill 不够,还需要管理“技能包”


img


在真实项目中,开发者很少只依赖一个 Skill 。


以 Vue 项目为例,一套完整的开发能力可能包括:



  • Vue 3 最佳实践;

  • Vue Router 使用规范;

  • Pinia 状态管理规范;

  • VueUse 组合式函数规范;

  • 组件测试规范;

  • UI 组件库规范;

  • 项目自己的代码和设计规范。


如果每次创建项目都逐个寻找、选择和安装,不仅操作重复,还很容易漏掉其中一项。


这和开发环境中的依赖管理很相似:最终需要管理的不是一个个孤立工具,而是一套可以复用的能力组合。


所以 SkillBuddy 支持把多个 Skills 组合成技能包,用于:



  • 保存常用的个人开发组合;

  • 一次安装到多个 Agent ;

  • 给新项目快速配置一套 Skills ;

  • 导入、导出和分享组合;

  • 批量启用或管理相关 Skills 。


可以建立:



  • Vue 前端技能包;

  • React 性能优化技能包;

  • UI 设计审查技能包;

  • Node.js 后端技能包;

  • 代码评审技能包;

  • 某个岗位或项目的专属技能包。


Skills 只有能够被组织和复用,才会逐渐从“几份提示词文件”变成真正的能力体系。


个人 Skills 和团队 Skills ,分开管理


image.png


个人使用 Skills 时,更关心:



  • 安装了什么;

  • 哪些 Agent 可以使用;

  • 多台电脑之间如何迁移;

  • 如何备份自己编写的 Skills ;

  • 如何保持多个副本一致。


因此,SkillBuddy 支持将个人用户级 Skills 和技能包备份到私有 Git 仓库。更换电脑时,可以先预览远端内容和安装目标,再决定恢复哪些资源。


但团队管理完全是另一个层次的问题。


团队不能把未经确认的 Skill 直接分发给所有成员。它通常需要考虑:



  • 哪些 Skills 已经通过团队审核;

  • 谁可以维护和发布 Skills ;

  • 如何记录每次修改;

  • 不同岗位应该安装哪些 Skills ;

  • 新成员如何快速获得标准能力;

  • 项目要求的 Skills 是否缺失或过期;

  • 如何阻止不符合安全要求的 MCP 配置。


只把文件放进一个共享目录,并不能解决这些问题。


SkillBuddy 的团队库使用 Git 仓库作为事实来源。团队可以在仓库中管理经过审核的 Skills 、MCP 定义、岗位技能包和项目策略,并继续利用 Git 已有的分支、提交和 Pull Request 审核流程。


还有更多功能特性,欢迎下载查看👇


下载和体验


SkillBuddy 已经在 GitHub 开源,使用 MIT 协议。



  • GitHub:https://github.com/konnga/skill-buddy

  • 下载地址:https://github.com/konnga/skill-buddy/releases

  • 问题反馈:https://github.com/konnga/skill-buddy/issues


安装完成后,可以先尝试下面这条最短体验路径:



  1. 打开 SkillBuddy ,查看自动检测到的 Agent ;

  2. 查看本机已有的用户级 Skills ;

  3. 添加一个项目目录,检查项目级 Skills ;

  4. 选择一个 Skill ,查看它在不同 Agent 中的安装状态;

  5. 尝试把它安装或同步到另一个 Agent ;

  6. 将几个常用 Skills 保存为一个技能包。

最新回复 (30)
  • yiwayhb 08-25 10:09
    1
    好像不支持 WSL
  • vnues 08-25 10:10
    2
    做的很不错 支持 windows 不
  • justfindu 08-25 10:12
    3
    cpa 不是可以管理的么
  • Kakarrot 08-25 10:12
    4
    系统自带内置、全局、项目级、缓存的能识别吗?

    删除的话是否可以支持项目级全量删除和全局级全量删除干净?
  • justfindu 08-25 10:14
    5
    @justfindu #3 不对, 是 cc switch
  • konnga403 楼主 08-25 10:17
    6
    @yiwayhb 这个我还没有试过,触及我的盲区了,可以试试安装 linux 或者 windows 版本看看?
  • konnga403 楼主 08-25 10:18
    7
    @vnues 支持的~
  • konnga403 楼主 08-25 10:19
    8
    @Kakarrot 支持的,全局和项目级都支持
  • konnga403 楼主 08-25 10:20
    9
    @justfindu cc switch 那个太简陋了,不是他们的主要功能
  • SilentOrFight 08-25 10:27
    10
    @justfindu #5 ccswitch 的 skills 管理和 mcp 管理都是半残废吧,不能批量管理,mcp 各种 bug 经常删除了又跳出来,扫描过的存在它数据库里的会强制写回 Agent 的配置文件中。
  • Kakarrot 08-25 10:28
    11
    我没有装 claude code 被检测到
    workbuddy 我删除后 还是被检测到
  • avenger 08-25 10:59
    12
    我用 `npx skills`
  • ffalex 08-25 11:05
    13
    能否再增加对 agents.md 的可视化管理,一样可以区分项目级和全局
  • konnga403 楼主 08-25 11:15
    14
    @Kakarrot 可能是在 vscode 或者其他 ide 安装过 claude code 的插件?

    workbuddy 删除的话,没有删除干净,可能残留 ~/.workbuddy 目录
  • konnga403 楼主 08-25 11:15
    15
    @ffalex 好的呀,这是一个痛点!
  • aowugong 08-25 11:19
    16
    挺不错的一目了然
  • bearbest 08-25 11:32
    17
    哈哈,我也有类似的想法,不过实现的方式不同,我弄了一个类似 npm 包管理工具的 ctxpm 上下文包管理工具,AI 驱动的一个管理协议: https://bear.best/products/bear-ctxpm/ ,ctxpm 采用的是外部 AI 资源和项目资源分开管理的理念,项目资源跟随项目进行版本管理,外部资源通过类似 `package.json` 的声明文件 `ctxpm.yaml` 进行管理。
    另外资源复用我用的是软链接的形式,这样就不用同一个文件到处复制,也没有一处更新到处都要更新一遍的问题了,SkillBuddy 也可以采用这种模式,小小建议哈。
  • steve009 08-25 11:59
    18
    支持一下
  • foursking 08-25 12:10
    19
    UI 好看 已经支持,整体功能挺好用的,把之前本地的一些删除掉了,支持下 up
  • kalman03 08-25 12:21
    20
    我也在 7 个月前,开源了一个 https://github.com/extrachatgpt-com/ananke
  • moooooooo 08-25 12:41
    21
    不错
  • Flagship9945 08-25 14:37
    22
    intel macos 被放弃了吗
  • xing666 08-25 15:07
    23
    本来想支持的,但是不支持 intel macos ,只能放弃支持了
  • weberCd 08-25 15:16
    24
    点赞
    1. 简单用了下,功能还不错的,也确实解决了我多应用管理 skill 的痛点(还没深入用)
    2. 我觉得最难得的是,UI 挺不错的;不是那种一眼 AI 味,间距阴影圆角都有问题的 UI 界面,这在 vibe coding 的时代,这很难得;楼主有自己的审美和要求;
  • konnga403 楼主 08-25 15:24
    25
    @Flagship9945 @xing666 两位老哥别走,等我腾出手来,本周上线支持 intel macos
  • xing666 08-25 15:58
    26
    @konnga403 #25 感谢,加油
  • fangyuanjianjian 08-25 16:18
    27
    点击 skill 卡片信息时,有些会跳转白屏,只能退出软件重新打开才能使用
  • huija 08-25 16:22
    28
    支持一下,能不能根据 git repo 可以自动预设技能包出来,有些 git repo 有很多的 skill ,一个个加应该也挺烦的
  • konnga403 楼主 08-25 17:32
    29
    @fangyuanjianjian 收到,尽快修复🫡
  • konnga403 楼主 08-25 17:34
    30
    @huija 是指从项目中已有的 skills 中自动整理出对应前端,后端,设计的技能包吗?还是说智能的给项目推荐一些合适的技能包?
* 帖子来源V2EX
返回