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

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

  •  
  •   konnga403 · 1 day ago · 2628 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 保存为一个技能包。
    36 replies    2026-08-26 10:10:09 +08:00
    yiwayhb
        1
    yiwayhb  
       1 day ago
    好像不支持 WSL
    vnues
        2
    vnues  
       1 day ago   ❤️ 1
    做的很不错 支持 windows 不
    justfindu
        3
    justfindu  
       1 day ago
    cpa 不是可以管理的么
    Kakarrot
        4
    Kakarrot  
       1 day ago
    系统自带内置、全局、项目级、缓存的能识别吗?

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

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