Skills Manager 是一款专为 AI 编码助手设计的技能管理应用,解决 Claude Code、Codex、Cursor 等 54+ 工具的 Skills 分散、同步困难、状态丢失等问题。

它提供统一技能库、Preset 分组激活、多 Agent 同步、项目/全局/关联三类工作区、内置市场搜索、Git 备份与多设备自动同步(按技能合并、冲突三选一),并允许 Agent 通过 manage-skills 技能反向驱动管理器而非直接写目录,确保来源、预设、更新追踪等元数据完整。支持 macOS(Homebrew/.dmg)、Windows(.exe/.msi)和 Linux(AppImage/deb/rpm),所有安装包自带 CLI。

核心功能矩阵
| 功能模块 | 说明 |
|---|---|
| 统一技能库 | 从 Git/本地/.zip/.skill/skills.sh 安装,集中存储于 ~/.skills-manager |
| 技能市场 | 浏览热门 Skills、关键词搜索、一键安装 |
| Agent 自管理 | Agent 通过 manage-skills 技能调用管理器 API,保留完整元数据 |
| Preset 预设 | 命名分组,一键激活/停用;显示 ✓ 或部分安装计数;一次性复制非实时同步 |
| 全局工作区 | 每个 Agent 独立页面,列出其全局目录所有 Skills(含非管理器安装的) |
| 项目工作区 | 管理项目本地 Skills,支持与中央库双向同步、嵌套目录、按 Agent 导出分配 |
| 关联工作区 | 指定任意目录为 Skills 根,独立管理,不参与全局 Preset 同步 |
| 多工具同步 | 软链接/复制两种模式;卡片角标实时反映各 Agent 同步状态 |
| 批量操作 | 多选启用/禁用/导出/删除;项目 Skills 同样支持 |
| 标签系统 | 归类筛选;新增「未标签」过滤项快速定位漏标 Skills |
| 更新检查 | Git 类检查远端更新;本地技能支持重新导入 |
| 文档预览 | 应用内查看 SKILL.md / README.md |
| 自定义工具 | 添加自定义 Agent/工具并指定路径,可覆盖内置默认路径 |
| 备份与同步 | GitHub 登录或任意 Git 远端;按技能合并;冲突三选一;快照可恢复 |
| 活动日志 | 记录本地操作;支持导出压缩包供 Issue 提交 |
| 应用内更新 | 主动提醒新版本,macOS/Windows 一键安装(不自动下载) |
Agent 自管理机制详解
传统做法是 Agent 直接写入自身 Skills 目录,导致来源、Preset 归属、更新追踪丢失。Skills Manager 的解决方案:
- Dashboard 勾选允许自管理的 Agent → 应用自动将
manage-skills部署到这些 Agent - Agent 通过该技能调用管理器 CLI/API 执行安装/移除/查询
- 所有操作经管理器记录,元数据完整保留
manage-skills本身也是普通 Skill,可单独安装:npx skills add xingkongliang/skills-manager- 无需配置 PATH,应用自动将 CLI 发布到 Agent 查找位置
备份与多设备同步机制
| 特性 | 说明 |
|---|---|
| 连接方式 | GitHub 8 位码授权(令牌存系统钥匙串)或任意 Git 地址(HTTPS+PAT/SSH/自建) |
| 自动同步 | 本地改动停止编辑 ~2 分钟后自动提交上传;远端更新自动合并推送 |
| 合并粒度 | 以技能为单位,非文本行;改名+改内容可正确组合 |
| 冲突处理 | 不阻塞其他技能同步;冲突技能保留本机版本进入「需要处理」列表;三选一(保留本机/使用远端/两者都保留);操作前自动建安全快照 |
| 快照恢复 | 手动备份创建快照;恢复前先存当前状态为新快照 |
| 备份内容 | 技能文件、标签、Preset、Agent 开关;不含 API Key/令牌/代理配置/本机接线;>100MB 技能留本机;SQLite 不进 Git(元数据可从文件重建) |
| 断开选项 | 断开本机 / 撤销 GitHub 授权 / 删除远端备份(需输入仓库名确认) |
安装与快速上手
安装
# macOS
brew install --cask skills-manager
# Windows/Linux:从 GitHub Releases 下载对应安装包
# 所有安装包自带 CLI
五步上手
- 从本地/Git/压缩包/市场安装 Skills
- 侧边栏 → 全局工作区 → 选择 Agent(如 Claude Code)
- 点 Preset 标签一键激活,或点
+ 添加 Skills弹层批量挑选并切换目标 Agent - 项目本地 Skills → 项目工作区 → 同样使用 Preset 或
+弹层 - 设置中配置 Agent 路径、自定义工具、主题、语言、代理、Git 偏好
- (可选)备份页 → GitHub 登录 → 自动备份与跨设备同步
支持的 54+ Agent 工具
开箱支持包括:Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、GitLab Duo、OpenCode、OpenClaw、Hermes Agent、OpenHands、Cline、Goose、Windsurf、Continue、Grok、Antigravity、Qwen Code、ZCode、Crush、Kilo Code、Roo Code、Amp、Kiro CLI、Droid、TRAE IDE、Warp、Qoder、CodeBuddy 等。设置页优先展示本机已检测到的工具,并支持添加自定义工具。
适用场景与边界
✅ 强烈推荐:
- 同时使用多个 AI 编码助手的开发者
- 团队共享 Skills 配置与 Preset
- 多设备间同步技能库
- 需要 Agent 自动化管理 Skills 的工作流
- 项目级 Skills 与全局 Skills 分离管理
⚠️ 注意事项:
- Preset 非实时同步:应用 Preset 是一次性复制,后续修改需重新应用
- 大文件不进备份:>100MB 技能自动留本机,备份页会标注
- 冲突需手动处理:真冲突不自动解决,需用户三选一
- Agent 自管理需显式授权:未在 Dashboard 勾选的 Agent 无法调用
manage-skills - SQLite 不备份:元数据可从技能文件重建,但自定义排序/视图偏好可能丢失
- CLI 依赖 Node.js:
npx skills add需本地有 Node 环境















