爱意满满的作品展示区。
konnga403

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

  •  
  •   konnga403 · 16h 23m ago · 2156 views

    现在 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 协议。

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

    1. 打开 SkillBuddy ,查看自动检测到的 Agent ;
    2. 查看本机已有的用户级 Skills ;
    3. 添加一个项目目录,检查项目级 Skills ;
    4. 选择一个 Skill ,查看它在不同 Agent 中的安装状态;
    5. 尝试把它安装或同步到另一个 Agent ;
    6. 将几个常用 Skills 保存为一个技能包。
    31 replies    2026-08-26 00:24:51 +08:00
    yiwayhb
        1
    yiwayhb  
       16h 16m ago
    好像不支持 WSL
    vnues
        2
    vnues  
       16h 16m ago   ❤️ 1
    做的很不错 支持 windows 不
    justfindu
        3
    justfindu  
       16h 13m ago
    cpa 不是可以管理的么
    Kakarrot
        4
    Kakarrot  
       16h 13m ago
    系统自带内置、全局、项目级、缓存的能识别吗?

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

    workbuddy 删除的话,没有删除干净,可能残留 ~/.workbuddy 目录
    konnga403
        15
    konnga403  
    OP
       15h 10m ago
    @ffalex 好的呀,这是一个痛点!
    aowugong
        16
    aowugong  
       15h 6m ago   ❤️ 1
    挺不错的一目了然
    bearbest
        17
    bearbest  
    PRO
       14h 54m ago   ❤️ 1
    哈哈,我也有类似的想法,不过实现的方式不同,我弄了一个类似 npm 包管理工具的 ctxpm 上下文包管理工具,AI 驱动的一个管理协议: https://bear.best/products/bear-ctxpm/ ,ctxpm 采用的是外部 AI 资源和项目资源分开管理的理念,项目资源跟随项目进行版本管理,外部资源通过类似 `package.json` 的声明文件 `ctxpm.yaml` 进行管理。
    另外资源复用我用的是软链接的形式,这样就不用同一个文件到处复制,也没有一处更新到处都要更新一遍的问题了,SkillBuddy 也可以采用这种模式,小小建议哈。
    steve009
        18
    steve009  
       14h 26m ago   ❤️ 1
    支持一下
    foursking
        19
    foursking  
       14h 15m ago   ❤️ 1
    UI 好看 已经支持,整体功能挺好用的,把之前本地的一些删除掉了,支持下 up
    kalman03
        20
    kalman03  
       14h 4m ago
    我也在 7 个月前,开源了一个 https://github.com/extrachatgpt-com/ananke
    moooooooo
        21
    moooooooo  
       13h 44m ago
    不错
    Flagship9945
        22
    Flagship9945  
       11h 48m ago
    intel macos 被放弃了吗
    xing666
        23
    xing666  
       11h 18m ago
    本来想支持的,但是不支持 intel macos ,只能放弃支持了
    weberCd
        24
    weberCd  
       11h 9m ago   ❤️ 1
    点赞
    1. 简单用了下,功能还不错的,也确实解决了我多应用管理 skill 的痛点(还没深入用)
    2. 我觉得最难得的是,UI 挺不错的;不是那种一眼 AI 味,间距阴影圆角都有问题的 UI 界面,这在 vibe coding 的时代,这很难得;楼主有自己的审美和要求;
    konnga403
        25
    konnga403  
    OP
       11h 2m ago
    @Flagship9945 @xing666 两位老哥别走,等我腾出手来,本周上线支持 intel macos
    xing666
        26
    xing666  
       10h 28m ago
    @konnga403 #25 感谢,加油
    fangyuanjianjian
        27
    fangyuanjianjian  
       10h 7m ago
    点击 skill 卡片信息时,有些会跳转白屏,只能退出软件重新打开才能使用
    huija
        28
    huija  
       10h 3m ago
    支持一下,能不能根据 git repo 可以自动预设技能包出来,有些 git repo 有很多的 skill ,一个个加应该也挺烦的
    konnga403
        29
    konnga403  
    OP
       8h 54m ago
    @fangyuanjianjian 收到,尽快修复🫡
    konnga403
        30
    konnga403  
    OP
       8h 51m ago
    @huija 是指从项目中已有的 skills 中自动整理出对应前端,后端,设计的技能包吗?还是说智能的给项目推荐一些合适的技能包?
    ykone
        31
    ykone  
       2h 1m ago
    Skill 和 AGENTS.md 管理确实没啥好工具解决。我比较希望是能做到类似包管理工具功能的管理,项目各自有配置文件,配置全局和局部的 skill 和 AGENTS.md 的依赖,然后要提供 cli 工具作为使用核心。会有点像前面有个老哥弄的管理协议。你做的这个软件是挺好的,UI 也挺好,但是我认为真正要做到方便使用,还是必须要终端支持。现在我就不会下这个软件,因为服务器上就没法用。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1036 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 85ms · UTC 18:26 · PVG 02:26 · LAX 11:26 · JFK 14:26
    ♥ Do have faith in what you're doing.