:"我给自己写了个 Skills 管理工具,专治 Skills 散落各处的毛病"
author:"蔡蔡啊"
description:"如果你也在用 Claude Code、Cursor、Codex 等多个 AI 工具,大概率会遇到这个痛点"上期我在文章末尾提了嘴可以用 Symlink 进行 Skills 管理,于是有观众提问怎么用 Symlink 来管理多 Agent 的 Skills ?
这其实也是我自己的痛点:
同一个 Skill,我在 Claude Code 插件里装了,Codex 里却没有,需要重新找、重新配 有些 Skill 明明之前用过,但死活想不起来装在哪个项目里了 想备份自己的 Skills 库,发现它们分散在十几个不同的目录里,放弃了 ……
所以我开发了这个来用来管理多 Agent Skills 的小工具 —— oh-my-skills。
oh-my-skills 的 v0.1.0 版本做得很克制,核心功能其实就是两个:发现 Skills,以及同步 Skills。
大家第一次使用时, oh-my-skills 会自动扫描本地可用的 Agent,识别出你安装了哪些支持 Skills 的 Agent 工具。不需要手动配置路径,它会自己去找。
目前支持 27 个主流工具(覆盖 App/CLI/Extension 三种形态),Claude Code、Cursor、Codex、Trae、Windsurf …… 后续如果有不支持的,再考虑增加一个自定义添加功能;
接着它会识别这些已经安装在本地的 Agent 的可用 Skills,识别范围包括从 skill.sh、Github,到 Plugins 和 本地开发的多种 Skills;
至于那些已卸载的 Agent 的残留 Skills,v0.1.0 版本暂时不做识别展示。
这些识别出来的 Skills 在 oh-my-skills 会分别在 全局工作区 和 项目工作区 展示,这里的全局工作区和项目工作区,就是对应 Skills 两种生效范围:全局和项目。
全局工作区的 Skills 是自动扫描识别的,大家在结果列表可以看到哪些 Agent 装了哪些全局 Skills ,以及这些 Skills 的状态(可用/可更新/需检查)。不过不建议全局放太多 Skills ,因为会挤占上下文进而影响 Agent 表现。
项目工作区的 Skills 则需要自己手动选择,有两种选择方式:
- “关联项目”是选择包含 Skills 的某个具体项目,适合你本身就知道这个项目有 Skills;
- “扫描发现”是你知道某个上级目录(包含多个项目)里一定有某个项目包含 Skills,它就会把这个层级下包含 Skills 的项目都给扫描出来。
如果你想查看某个 Skill 更详细的介绍,可以在结果列表中点击目标 Skill,在展开的详情卡片中,你可以看到它的本地路径、description、来源,或者是检测出来的问题。

以上就是这个小工具的第一个功能,发现你在本地安装的多个 Agent 的可用 Skills。
知道自己本地都有哪些 Skills 后,接下来就可以解决开篇提到的 Skills 迁移或同步问题?
比如这段时间 Codex 很火,不少人从 Claude Code 迁移到 Codex,那怎么将之前在 Claude Code 中的 Skills 快速迁移到 Codex 中呢?
以之前通过 Claude Code 的 Plugins 安装的 blog-translator skill 为例。
不论你是从全局工作区还是项目工作区扫描发现的 Skills,只要勾选左侧的按钮(支持多选),底部就会出现下方这个交互窗口,其中有”快速同步“和“导入中心库“两个按钮。
选择“快速同步”,就会将选中的 Skill 带到”同步 Skills - 快速同步“窗口,接下来你只需要选择:
同步方式:复制副本,或者创建软链接(Symlink) 目标 Agent:这里我们选择的就是 Codex 生效范围:也分为全局和项目

“导入中心库”的核心流程和“快速同步”差不多,区别在于先把 Skills 复制到中心库,再用软链接分发到目标 Agent。这种更适合长期管理。
Skills 导入中心库后,原来的 Skills 还在,暂时不做帮用户删除 skills 的功能。用户自行判断是否要两边都保留,还是只维护一份中心库。
不论你选择哪种同步方式,在正式会给你先做个操作预览,有冲突的内容(比如你要同步过去的 Agent 已经有这个 skills 了)会在预览中被拦住/跳过,不会直接覆盖。
老实讲,这个工具不是每个人都需要。
如果你只用一款 AI 工具(比如只用 Claude Code ),那它对你的价值不大。你手动管理 .claude/skills 目录就够了。
但如果你是像我这样的多 Agent 工具用户或者 Skills 重度用户,它可能会帮你省不少事。
这个小工具目前还比较粗糙。比如:
目前只支持 macOS(因为我自己主要用 Mac) UI/UX 还有很多细节要打磨 一些边界问题可能还没解决 一些高级功能(比如 Skills 的版本对比、冲突解决)还没做
这个工具是开源的:🔗 https://github.com/nextcaicai/oh-my-skills
如果你在使用中有任何问题,都欢迎反馈或提 Issue;如果你想贡献代码,更欢迎提 PR。
以上就是今天的全部内容,谢谢你看到了这里。
