Claude Code技能太多管不过来?我写了个CLI工具
用 Claude Code 写代码有一段时间了,不知道你有没有这种感觉:技能(skills)越装越多,时间一长根本不知道哪个在用、哪个重复、哪个该删。Claude Code 本身没有提供一个可视化的界面来管理这些技能,装完就完了,想看看装了啥都得去找配置文件。
我自己遇到了这个问题,就写了一个小工具叫 skills-mgr,专门用来管理 Claude Code 和 Codex 上的技能。下面来分享下安装和使用方法。
为什么要管理技能
一开始装技能很随意,看到一个有用的就装一个。装了二十多个之后,问题就来了:
- 不知道哪些在用。技能多了之后,根本不知道哪些经常触发、哪些吃灰。
- 不知道哪些重复。有些技能功能相似,但触发关键词不同,很容易重复触发。
- 不知道缺少依赖。有些技能需要
bun或者node环境,但没装也不知道。 - 没有统一的查看入口。每次想看看装了哪些技能,都得去找配置文件。
这些问题促使我写了 skills-mgr。
安装 skills-mgr
skills-mgr 的安装方式很简单。一种是通过 npx 作为技能安装,然后运行安装脚本:
1 | npx skills add Jackeyzhe/skills-mgr |
安装脚本会把 skills-mgr 以及 skills-analyzer、skills-remove、skills-doctor、skills-update、skills-sync 等 6 个命令链接到 ~/.local/bin/,这样你就可以在任意终端直接使用这些命令了。
如果你想开发或调试,也可以直接用 Python 运行源码:
1 | git clone https://github.com/Jackeyzhe/skills-mgr.git |
我比较推荐第一种方式,安装后可以在任意终端直接使用 skills-mgr 命令。安装完成后的效果大概是这样的:

查看已安装的技能
skills-mgr list 可以查看所有已安装的技能:
1 | skills-mgr list |
命令输出会显示每个技能的名称、版本、大小、文件数量,以及在 Claude Code 和 Codex 中的链接状态。我的环境里装了 29 个技能,总大小 2.9 MB。技能按类型分成了 Conversion、Image Gen、Meta、Other、Publishing、Tool 等几个类别。

分析技能使用情况
想知道哪些技能用得多、哪些吃灰?用 skills-mgr analyze 命令:
1 | skills-mgr analyze --top 10 |

这个分析基于对话记录中的关键词匹配,不是精确的调用次数,但能给你一个大概的参考。从结果看,baoyu-url-to-markdown 用得最多,其次是 baoyu-image-gen。
找出重复的技能
有些技能功能重叠,但你可能不知道。用 skills-mgr duplicates 可以检查:
1 | skills-mgr duplicates |

输出会显示两种情况:黄色标记 🟡 表示一个技能是另一个的子集,建议保留父集;绿色标记 🟢 表示关键词有重叠,需要自己判断是否真的冗余。从图中可以看到,baoyu-xhs-images、baoyu-cover-image、baoyu-comic 等都是 baoyu-image-gen 的子集,它们只是在前者的基础上封装了不同的提示词。
检查运行环境
有些技能需要 bun、node、python3 等环境,缺了某些依赖技能可能无法正常工作。skills-mgr doctor 可以帮你检查:
1 | skills-mgr doctor --summary |

从图中可以看到,我的环境里 node、python3、bun、npx 都装了,总共 28 个技能中 19 个状态正常,有 1 个缺少依赖。
更新技能
技能多了之后,手动更新也很麻烦。skills-mgr update 可以查看本地所有技能的版本:
1 | skills-mgr update |

这个命令默认是只读模式,只会显示版本信息,不会实际更新。如果想应用更新,可以使用 skills-mgr update --apply。
同步技能链接
Claude Code 和 Codex 的技能目录是分开的,有时候会出现一边装了技能另一边没装的情况。skills-mgr sync 可以帮你把 ~/.agents/skills 中的技能同步到 Claude Code 和 Codex:
1 | skills-mgr sync |
这个命令是单向的,只会从 ~/.agents/skills 同步到其他目录,不会反向操作。

卸载技能
如果某个技能不再需要,可以使用 skills-mgr remove 来卸载:
1 | skills-mgr remove <skill-name> |
这个命令会自动备份被删除的技能到 ~/.local/share/skill-backups/,如果发现删错了,还可以用 skills-mgr restore 恢复回来。

总结
skills-mgr 可以帮你查看所有已安装的技能、分析使用频率、找出重复技能、检查依赖、版本更新、同步链接,以及安全卸载。其中同步是单向的,从 ~/.agents/skills 到 Claude Code 和 Codex,不会反向操作。卸载会自动备份,误删可以恢复。
如果你也在用 Claude Code,并且装了不少技能,这个工具值得试试。