开源一个Skill管理神器

来源：htmlDecode("AI产品黄叔")

原文链接：https://mp.weixin.qq.com/s/xMFZhFC3Dyj7Y4Den7upTQ

你电脑里有多少个 Skill？

我数了一下，超过100个
作为一直在研究和玩耍Skill的AI玩家，不知不觉发现自己似乎有了太多的Skill，是的， 整整超过100个。

也发现自己的社群用户在 Skill 上面管理遇到了各种各样的问题。

有必要去做一个 Skills 管理神器。是的，黄叔已经把它开源，一键安装，功能强大。下面来给大家介绍一下怎么用它来方便你的 skill 管理。
只要你的 skill 超过20个，我就建议你装一个，非常的简单。
01
PART
社群里的问题，就是产品的起点
我自己做社群，教大家写 Skill、用 Skill。每天社群里都有人在分享自己写的 Skill，也有人在问各种问题。
教着教着，有两类问题开始反复出现：
** "黄叔，Skill 越装越多，怎么管理啊？" **
** "黄叔，我改了一个 Skill 效果变差了，怎么回到上一版？" **
说实话，看到这些问题的时候我愣了一下——因为我自己也有完全一样的困扰。
我甚至都不知道自己电脑里到底有多少个 Skill。感觉很多，但不知道它们在哪，不知道怎么管理，不知道都有什么。就是很乱。
有些在  ~/.claude/skills/ ，有些在插件目录下三四层，有些在某个项目的  .claude/skills/  里——那个项目我已经两个月没打开了。想找一个 Skill？靠记忆。想改一个 Skill？翻目录。改坏了想退回去？没有版本历史。
我一直想给社群用户做一些产品，来解决他们真实遇到的问题。这次，他们的问题和我的问题完全重合了。
那就做吧。
02
PART
Git 是正确答案，但门槛太高
比如版本管理这件事，我第一反应想到的是 Git。
Skill 的本质就是一个文件夹，里面就是 SKILL.md 和一些配置文件。文件夹 + 纯文本，天然适合用 Git 管理。 git init 、 git commit 、改坏了  git checkout  回去——所有问题都解决了。
我也确实想教大家用 Git 来管理 Skill 版本。
但想了想，这件事对普通用户来说门槛太高了。
我社群里大部分人不是程序员。他们学会了用 Claude Code 写 Skill，已经很厉害了。你现在跟他们说"装个 Git，学一下 commit、push、pull、merge，遇到冲突要手动解决"——这不是在帮他们，是在劝退他们。
有没有一种可视化的方式，把 Git 的能力包在一个用户友好的界面里？让版本管理、Skill 查找、冲突检测这些事，变成 点一下鼠标 就能完成的操作。
我在Skill管理器里，只要点开任意一个Skill，就能看到 版本历史 按钮，点击一下，可以快速完成版本管理：

这就是 Skill Hub 的起点——给社群里的普通用户，做一个他们真正用得起来的 Skill 管理器。
03
PART
让 CC 搭第一版
想清楚要什么之后，剩下的事交给 Claude Code。我描述需求，CC 写代码，中间遇到问题它自己调试。核心逻辑就三件事： ** 扫描、展示、编辑 ** 。
** 扫描 ** 覆盖了能想到的所有位置：全局 Skill 目录、插件目录（递归）、注册过的项目目录、常见开发路径（ ~/Documents 、 ~/Projects 、 ~/Developer ……），甚至会往当前目录的上面再扫三级。
一次扫描，100+个 Skill 全部聚合到一个页面。每个 Skill 有名字、描述、来源（本地 / 插件 / 符号链接）、作用域（全局 / 项目）、最后修改时间。
** 展示 ** 可以按来源分组、按作用域分组、按项目筛选、按关键词搜索。终于不用  find  了。

** 编辑 ** 直接在浏览器里改 SKILL.md，保存就生效。而且每次保存前会自动拍一个版本快照——改坏了随时回滚。不用学 Git，点一下"回退"就行。
一行命令启动：
skill-hub
浏览器自动打开  localhost:3456 ，完事。
第一版解决了最核心的问题： 看得见、找得到、改得了、退得回。
04
PART
发到社群之后，需求才真正开始
第一版做完发到社群之后，反馈来得很快。而且每一条都是我没预料到的。
** 有人用 Codex，不只用 Claude Code。 **  我写扫描器的时候只扫了  ~/.claude/skills ，因为我自己只用 Claude Code。但社群里有人同时用 Codex、Cline、Warp，Skill 散落在完全不同的位置。
这不是"没想到"，是 没有使用场景就没有感知 。
**
**
** 有人有两台电脑。 **  Mac mini 在家当主力写 Skill，MacBook Air 出门用。167 个 Skill，怎么同步？
这个需求听起来就是"上传下载"。但一展开，全是决策点： 问题 为什么难 冲突策略 两边都改了同一个 Skill，以谁为准？ 增量 vs 全量 100+ 个 Skill 每次全量比对太慢，增量需要维护状态 网络异常 同步到一半断了，部分写入算不算脏数据？ 多设备 不止两台，可能台式机 + 笔记本 + 公司电脑 私有 Skill 有些 Skill 里有 API key，要不要排除？
这些细节在 PPT 里永远不会出现。只有手沾泥巴的时候才会一个个撞上。

** 还有人说删 Skill 能不能批量？ **  简单但高频。167 个 Skill 里有不少试验品，一个一个删太痛苦。

每条反馈都变成了下一版功能。
05
PART
每条反馈都变成了下一版
基于这些反馈，密集迭代。批量删除加回收站、冲突标记、启用禁用开关这些都是常规操作，做了就有。
但有两个功能值得展开说。
第一个是相似检测
扫出来 167 个 Skill 之后我自己都吓了一跳——我居然有好几对"几乎一样"的 Skill。同一个功能，不同时间写的，名字不同但内容重叠度 80%。社群里很多人也有这个问题：装了七八十个 Skill，根本记不清哪些撞了。
所以加了基于关键词的相似度检测。自动把疑似重复的 Skill 聚类展示，支持中英文混合匹配。点进去能看两个 Skill 的内容差异，决定保留哪个。相当于给你的 Skill 库做了一次 "体检" 。

第二个是 Git 同步
多设备同步这个需求，我一开始想自己做一套 sync 协议。但马上否掉了——冲突处理、增量传输、断点续传，每个展开都是一个工程。
然后我想到：这些问题 Git 全都解决过了。
最终方案是用 GitHub 私有仓库当免费后端：
本地 Skill → git push → GitHub 私有仓库 → git pull → 另一台设备
冲突处理交给 git merge，增量同步 git 天然只传 diff，私有仓库免费不用搭服务器。用户只需要在界面上设一个仓库地址加一个 Token，就能实现多端同步。Mac mini push，MacBook Air pull，不用懂一行 Git 命令。

把复杂度交给 Git，我只做上层体验。 这和搭知识库的逻辑一样——不是什么都自己造，是找到好的基础设施，在上面做好用户看得见的那一层。
06
PART
需求不是想出来的，是用出来的
回过头看这个项目，我觉得最值得记录的不是功能列表，而是一个体感：
需求不是想出来的，是用出来的。
每一个"我没想到"的功能——多平台扫描、相似检测、多设备同步——都不是我坐在那里想出来的。是真实用户拿着他们的真实场景，帮我撞出来的。
在社群里教 Skill 的好处是，我离用户足够近。痛点不需要调研，不需要问卷，它们每天自己会冒出来。
做产品的第一步不是画原型，是自己先用起来，然后丢给真实用户。他们的使用习惯，就是最好的产品经理。

Skill Hub 现在开源了，一行命令就能用：
npm install -g https://github.com/Backtthefuture/skillmanager/raw/main/release/claude-skill-hub.tgz && skill-hub
整个仓库放在： https://github.com/Backtthefuture/huangshu

如果你的 Claude Skill 超过了 20 个，你可能已经需要它了。
如无必要，勿增实体。基于这个原则，我并没有去开发 Mac 版本，我觉得使用浏览器就足够简单了。 如果不小心你把浏览器给关闭了，可以使用一行命令，在终端里就能够重新打开它。
skill-hub
我也做了期视频介绍，欢迎大家查看：