skill-manager

skill-manager 快速入门

一句话卖点: 7 个 AI 平台各有一套 Skill？skill-manager 一处定义，处处使用——告别多平台 Skill 碎片化

这是什么?适合谁?

skill-manager 是一个 AI Skill 统一管理器——跨 Claude Code、Codex、OpenClaw、Hermes Agent、OpenCode、Continue、Cursor 等 7 个 AI 平台统一管理 Skills。核心理念：一处定义，多处使用。 AI 编码工具生态碎片化严重——你可能同时使用 Claude Code 做复杂重构、Cursor 做日常编码、Continue 做代码补全。每个平台都有自己的 Skill 格式和存放位置，维护多套 Skill 定义既繁琐又容易出错。skill-manager 解决了这个痛点：在一个地方定义 Skill，自动同步到所有平台。 与单一平台的 Skill 管理工具不同，skill-manager 的核心价值在于跨平台统一——不需要为每个平台重复编写和维护相同的 Skill 定义。中文项目，适合国内开发者使用。 适合：同时使用多个 AI 编码平台的开发者、需要维护跨平台 Skill 的团队。不适合：只使用单一 AI 编码工具的简单场景。

准备工作

1. 安装 Node.js 18+
2. 确定需要管理的 AI 平台（Claude Code / Codex / Cursor 等）
3. 了解各平台的 Skill 格式和存放位置
4. 准备好现有的 Skill 定义文件

3步快速上手

第1步: 安装 skill-manager

git clone https://github.com/aabbcc070403/skill-manager.git
cd skill-manager
npm install
npm run build

第2步: 定义统一 Skill

在 skills/ 目录下创建 Skill 定义文件。skill-manager 使用统一的 Skill 格式，自动转换为各平台的原生格式：

# skills/code-review.yaml
name: code-review
description: 代码审查 Skill
platforms:
- claude-code
- codex
- cursor
- continue
steps:
- name: 静态分析
tool: eslint
- name: 安全检查
tool: semgrep
- name: 最佳实践检查
rules: project-guidelines

第3步: 同步到各平台

npm run sync

skill-manager 会自动：

1. 读取统一的 Skill 定义
2. 转换为各平台的原生格式
3. 部署到各平台的 Skill 目录
4. 输出同步报告

常见踩坑

1. 不同平台的 Skill 能力上限不同——某些高级功能可能只在特定平台可用
2. 同步前备份各平台现有 Skill——首次同步可能覆盖手动配置的 Skill
3. 平台路径可能因操作系统不同而变化——Windows 和 macOS 的 Skill 目录路径不同
4. 部分平台需要重启才能加载新 Skill——同步后可能需要重启 IDE 或 CLI
5. Skill 命名冲突——确保统一 Skill 的名称不与平台内置 Skill 冲突

初级用法

1. 统一 Skill 仓库：在一个地方维护所有 Skill，自动同步到各平台
2. 团队 Skill 共享：团队成员共享同一套 Skill 定义，确保一致性
3. Skill 版本管理：将 Skill 定义纳入 Git，追踪变更历史
4. 平台迁移辅助：更换 AI 编码工具时，Skill 无缝迁移
5. Skill 模板：基于统一格式快速创建新 Skill

高级玩法

1. 平台特定优化：在统一 Skill 中为不同平台添加平台特定的优化配置
2. Skill 组合：将多个 Skill 组合为复合 Skill，一键部署
3. 条件同步：根据项目类型自动选择需要同步的 Skill
4. CI/CD 集成：在项目初始化时自动同步团队标准 Skill
5. Skill 市场集成：从社区 Skill 市场导入 Skill，自动适配各平台

小技巧

1. 从最常用的 2-3 个平台开始，逐步扩展到全部 7 个
2. 为每个 Skill 添加平台兼容性标注，明确哪些功能在哪些平台可用
3. 使用 —dry-run 参数预览同步效果，确认无误后再正式同步
4. 将 skill-manager 配置纳入项目仓库，团队成员 clone 后一键同步
5. 定期检查各平台的 Skill 格式更新，确保 skill-manager 的转换逻辑最新

常见问题 FAQ

Q1: skill-manager 支持哪些平台？ 目前支持 Claude Code、Codex、OpenClaw、Hermes Agent、OpenCode、Continue、Cursor 共 7 个平台。平台列表可能随项目更新扩展。信息来源：GitHub README。

Q2: 如果某个平台不支持 Skill 的某个功能怎么办？ skill-manager 会自动跳过该平台不支持的功能，并在同步报告中标注。你可以为不同平台编写平台特定的配置来优化体验。信息来源：GitHub README。

Q3: 同步会覆盖我手动配置的 Skill 吗？ 首次同步会覆盖目标平台的 Skill 目录。建议在同步前备份现有 Skill，或将手动配置的 Skill 迁移到 skill-manager 的统一格式中。信息来源：GitHub README。

Q4: 支持自定义平台吗？ 可以通过插件机制添加对新平台的支持。参考仓库中的平台适配器开发文档。信息来源：GitHub README。

Q5: 和平台自带的 Skill 管理有什么不同？ 各平台自带的 Skill 管理只能管理本平台的 Skill。skill-manager 的核心价值是跨平台统一管理——避免在 7 个平台重复维护相同的 Skill 定义。信息来源：GitHub README。

参考链接

• GitHub 仓库：github.com/aabbcc070403/skill-manager
• Claude Code Skills 文档：docs.claude.com/en/docs/claude-code/skills
• Codex Skills 文档：github.com/openai/codex
• Cursor Rules 文档：docs.cursor.com
• Continue 文档：docs.continue.dev