skilllib — 像管理依赖一样管理 Agent 技能

技能简介

skilllib 是一款把 AI Agent 技能（SKILL.md 目录）当作项目依赖来管理的本地工具。它给每个技能建立唯一主副本与版本历史，每个仓库只安装自己需要的技能，并把同一份真实副本链接进 Claude Code、Cursor、Codex、Zed、Grok 等工具各自的技能目录。装上它之后，团队再也不用手工把技能文件夹复制到 ~/.claude/skills，也不会出现「全局技能在每个仓库都加载、白白吃掉上下文」的老问题。整个工具完全在本地运行，没有服务端、不需要账号、不发起网络请求。

核心能力

1. 单一主副本 + 版本历史：所有个人技能统一存放在 ~/.skilllib/library，每次修改都会生成新版本，避免多仓库副本各自漂移。
2. 按仓库安装并锁定版本：每个仓库根目录生成 skilllib.json，记录技能与版本，sync 可以精确复现，update 升级到最新版本。
3. 一份副本喂给多个 Agent：真实文件只放在仓库里一份，再安全链接到各 Agent 读取的目录，避免重复加载与版本不一致。
4. 技能健康检查：一次性列出未决的全局技能、被加载两次的技能、重复副本、可升级项和失效链接，并给出逐项修复动作。
5. Agent 原生调用：附带一个小技能，教 Claude Code、Cursor、Codex、Zed、Grok 直接使用 skilllib 命令，所有命令支持 --json 输出，改动前会先询问。
6. 终端可视化应用：直接运行 skilllib 打开终端界面，按「位置 → 仓库 → 技能 → 修复」逐层查看来源、被哪些 Agent 加载、是否已提交到 git、使用频次。
7. 可回滚的删除：从仓库移除的技能仍保留在库中，其余被清理的内容统一进备份，一键即可恢复。

安装配置

1. 环境要求：Node.js 22 及以上，支持 macOS、Linux，Windows 使用目录联接实现且无需管理员权限。
2. 全局安装：执行 npm install -g skilllib。
3. 给 Agent 装上使用技能：执行 skilllib agent-skill install，之后在任何仓库新开会话即可让 Agent 调用。
4. 不想全局安装时也可以直接用 npx skilllib 启动终端应用。

使用步骤

1. 首次运行：在终端执行 skilllib，按提示勾选你在用的 Agent（Claude Code、Cursor、Codex、Zed、Grok），并指定项目根目录，工具会自动扫描其中的 git 仓库。
2. 认领技能：进入某个仓库的技能列表，把散落在全局目录、插件、claude.ai 同步或个人拷贝里的技能，逐个决定「迁移到需要的仓库 / 保持全局 / 删除」。
3. 安装到仓库：选中技能后写入仓库，工具生成 skilllib.json 与真实副本，并链接给各 Agent。
4. 日常同步：在新机器或新分支上执行同步即可精确还原；需要升级时执行更新命令。
5. 交给 Agent 打理：直接问 Agent「这个仓库能用哪些技能、哪些全局技能应该只在这里加载」，由 Agent 读取 JSON 结果并执行变更。

适用场景

1. 同时在多个仓库、多个 AI 编码工具之间切换的开发者，希望技能按需加载。
2. 团队把技能提交进仓库共享，但成员用的 Agent 各不相同，读取路径不一致。
3. 全局技能越装越多，上下文被挤占、技能误触发的重度用户。
4. 需要审计「这个仓库到底装了哪些技能、来自哪里、有没有进 git」的技术负责人。
5. 想把技能升级、回滚、副本清理纳入日常工程流程的团队。

适用人群

适合重度使用 Claude Code、Cursor、Codex 等编码 Agent 的独立开发者、平台工程师与研发团队负责人；对希望把技能资产规范化管理的团队尤其合适。轻量尝鲜用户如果只有一两个技能，收益有限。

工作原理

skilllib 把每份技能内容视为一个可版本化的构件：库中保存主副本，仓库只声明依赖并保存一份真实副本，其余 Agent 目录通过链接指向它，因此「一份内容、多端可见」。健康检查基于对实际目录的扫描与来源追踪，判断某个技能是否被重复加载、是否已提交、链接是否失效。所有判断与修复都在本地文件系统完成，不依赖云端索引。

官方链接

• npm 包页面：https://www.npmjs.com/package/skilllib
• 开源仓库：https://github.com/atralice/skillLib
• 许可证：MIT
• 当前版本：1.12.2（近一周 npm 下载约 555 次）