Skip to main content

Skills Manager:把散落 15+ AI 编程工具的 Skills 统一管起来

· 8 min read

Skills Manager 解决多 AI 编程工具 Skills 分散管理的痛点,15+ 工具用一套中央库 + 工作区 + 预设搞定,再也不用手动复制。

  • 痛点:每个工具自己一份 Skills 目录,复制几次后不知道哪份是新的
  • 解法:中央技能库统一托管,跨工具一键同步(复制或软链接二选一)
  • 三层工作区:全局(每工具默认生效)/ 项目(仅当前项目生效)/ 预设(一组常用技能打包)
  • 跨设备同步:接私有 Git 仓库自动备份,冲突时本地版不会被覆盖
  • 适用:同时用 2+ AI 编程工具 / 自己写 Skill / 团队共享常用技能
  • 边界:偶尔用网页聊天的人先不用装,装任何 Skill 前先看 SKILL.md

这个项目解决什么问题

单 AI 编程工具时代,Skills 只需要管一个目录——比如 ~/.claude/skills/。一旦同时用 Claude Code、Cursor、Codex、Windsurf,混乱就开始:

场景后果
GitHub 下载一个 Skill 装到 Claude Code想给 Cursor 用,得手动复制一份
改了一个 Skill 的内容一周后忘了 Cursor 那份还是旧版
不同工具 Skills 目录约定不一致找隐藏目录找到怀疑人生
团队想共享一套 Skills靠文档 + 手动复制 1-by-1

xingkongliang/skills-manager 是个 Tauri 2 桌面应用(Rust 后端 + React 19 前端),做的事很简单——把 Skills 集中托管到一个中央库,跨工具的安装 / 更新 / 删除 / 备份全部在一处操作。截至 2026-07-07 仓库已 2.8K 星,License MIT,最新版本 v1.28.1(2026-07-05)。

核心设计:中央库 + 工作区 + 预设

Skills Manager 的概念图非常清晰:

逐个拆:

中央技能库(Library) —— 安装入口。从 Git 仓库 / 本地文件夹 / .zip .skill 压缩包 / skills.sh 市场装进来的 Skills 全部沉淀到 ~/.skills-manager/,每个 Skill 一张卡片,可看标签、来源、已同步到哪些工具,点开能看到 SKILL.mdREADME.md

全局工作区(Global Workspace) —— 工具级别的可见性。每个 AI 工具有独立页面,列出 它实际能看到的所有 Skills —— 不只是 Skills Manager 装的,还有原本就在工具目录里的(用于排查"我装到哪去了")。

项目工作区(Project Workspace) —— 项目级别的可见性。比如视频项目需要动画 / 字幕 / 截图 Skills,前端项目需要 UI 组件 / 样式 Skills,没必要全局启用。给项目单独建一组 Skills,项目切换自动跟随。

预设(Presets) —— 把常用 Skills 打包。"前端组"、"视频组"、"资料组",点一下预设就把这一组 Skill 加到指定工具和项目;再点一下整组拿掉。这是 一次性同步,不是实时链接——预设调整后不会反向污染中央库。

同步机制:复制 vs 链接

Skill 同步到工具目录时,可选两种模式:

  • 复制:物理拷贝,最稳妥,Windows 上不会因权限问题失败
  • 链接:软链接(symlink / junction),中央库改一处、所有工具同步生效

Windows 上链接权限受限是历史难题,作者在 UI 层做了兜底,不会让同一个 Skill 在机器上被反复复制成 N 份

每张 Skill 卡片上有一个"agent icon badge"——看到哪个工具的图标亮起,就知道这个 Skill 在那个工具里已激活。点图标即可单独装 / 卸,不用打开全局工作区。

跨设备同步:Git 备份 + 智能合并

多设备切换是 Skill 管理的另一个老问题。Skills Manager 把 Skills 库备份到私有 Git 仓库,换电脑时同步回来。几个设计细节值得说:

  1. GitHub 一键登录:走 8 位 device-flow,token 存 OS keychain,不进 repo 配置文件也不进本地文件
  2. Skill-aware merge:按 Skill 文件粒度合并,不是按文本行——A 机改名 + B 机改内容,两个变更可以同时落地,不会变成冲突
  3. 真冲突不阻塞:同一个 Skill 在两台机器同时改,其他 Skill 正常同步;冲突的那个 Skill 在 Library 卡片上有角标,进 "Needs attention" 让你选 keep mine / use remote / keep both
  4. 快照可回滚:每次手动备份都是一个 snapshot 版本,回滚时先存当前状态、再恢复历史版本
  5. 100 MB 以上的 Skill 自动排除:避免 Git 仓库膨胀;本地仍保留使用

这意味着 它不只是个"备份工具",还是个分布式 Skill 协作平台 —— 适合团队共享同一套常用 Skill 库的场景。

它支持的 16 个工具

截至 v1.28.1,内置覆盖:

类型工具
命令行Claude Code · Codex · Gemini CLI · Goose
IDECursor · Windsurf · TRAE IDE
编辑器扩展GitHub Copilot
AI 终端Amp · Kilo Code · Roo Code · OpenCode
实验性Grok · Antigravity · Clawdbot · Droid

不在列表里的工具可以走 Custom Tools——告诉 Skills Manager 你的 Skills 目录在哪,它按同样的方式管理。这个口子对自研 Agent 或者小众 IDE 很关键。

我的几点看法

1. Skills Manager 是 Skill 范式走向成熟的信号。

早期 Skill 都是"给 Claude Code 写一个 SKILL.md"这种单点动作。当 Skills 数量超过 20、跨工具场景出现后,管理本身就是产品。Skills Manager、book-to-skill、Superpowers 这些项目的密集出现,说明 Skill 不再是 LLM 的一次性扩展,而是和插件 / dotfile 一样进入"个人 / 团队基础设施"阶段。

2. 预设机制是个被低估的设计。

很多工具做 Skills 管理会卡在"列表 + 标签 + 搜索"——能用,但用起来很累。预设直接对应"我现在要干什么"这个心智模型,一次点击切换一组 Skill 比逐个勾选快 10 倍。这套 UX 思路和 VS Code 的 Profile、IntelliJ 的 Workspace 是一脉相承的。

3. 跨设备同步走 Git 是对的选择。

不用弄私有云、不用弄 WebSocket 同步——直接复用 Git 的 commit / push / pull 模型。Skill-aware merge 是真正的差异化:它知道 Skill 文件的边界,不像文本 diff 那样在 SKILL.md 中间切一刀。这套思路可以推广到 dotfile 管理(chezmoi / yadm 还在做文本 diff)。

4. macOS Gatekeeper 警告是当前最大门槛。

Skills Manager 没付费 Apple Developer ID,ad-hoc 签名首次启动会被 Gatekeeper 拦。第一次安装需要手动 右键 → 打开 → 确认。这是所有非商店分发的 macOS 应用共同的问题,不是 Skills Manager 独有,但确实是首次使用最大的认知摩擦。

适用 vs 不适用

适用不适用
同时用 2+ AI 编程工具(Claude Code + Cursor 等)偶尔用网页版聊天
自己写过 / 改过 Skill一个工具用到死
团队有共享 Skills 的需求完全没碰过 Skills 概念
多设备(公司机 + 个人机 + 笔记本)切换单台机器一工具

怎么开始

桌面端走 GitHub Release 装包,命令行党可以装 CLI:

# CLI 直接调用(与桌面端共享同一 SQLite 数据库)
cargo install --path src-tauri --bin skills-manager-cli --locked --force

# 列出当前 Skills
skills-manager-cli skills list

# 从 GitHub 装一个 Skill 到中央库(默认不同步到任何工具)
skills-manager-cli skills install vercel-labs/agent-skills@react-best-practices

# 装完同步到 Claude Code
skills-manager-cli skills sync --tool claude_code

桌面应用启动后从侧边栏进 Library 装 Skills → Global Workspace 选工具激活预设 → 需要时接 GitHub 走多设备同步。整个流程不需要碰任何隐藏目录。

Skills Manager 把 Skill 管理从"手工复制时代"推进到"基础设施时代"——和 dotfile 管理(chezmoi)、容器镜像管理(Docker)一个量级。值得每个跨工具重度用户装一个试试。

References

  1. xingkongliang/skills-manager —— 本文核心项目,MIT License
  2. AIlazy俊:2.4K 星 Skills Manager 视频拆解 —— 完整功能演示
  3. Claude Code Skills 官方文档 —— Skill 范式基础
  4. book-to-skill —— 同属 Skill 范式,专注知识入库
  5. Karpathy 4 条规则 —— SKILL.md 写作同样适用 Simplicity First