-
Notifications
You must be signed in to change notification settings - Fork 2
Open
Labels
Description
OpenSkills 是一个通用技能加载器 CLI 工具,它的核心使命是打破不同 AI 编程助手之间的技能壁垒,让 Claude Code 的 Skills 系统变得通用化、跨平台化 。
一句话总结
OpenSkills = AI 编程助手的"Forge"(模组管理器),让你写的技能(SKILL.md)能在 Claude Code、Cursor、Windsurf、Aider 等所有主流 AI 工具中通用 。
核心功能
| 功能 | 说明 |
|---|---|
| 跨平台兼容 | 100% 兼容 Claude Code 的 SKILL.md 格式,让其他 AI 助手也能使用 |
| Git 安装 | 支持从 GitHub、私有仓库、本地路径安装技能,不限于官方市场 |
| 统一管理 | 通过 CLI 命令安装、更新、删除、同步技能,像 npm 一样管理 |
| Universal Mode | 将技能安装到 .agent/skills/,避免与 Claude Code 内置路径冲突 |
| 版本控制 | 技能用 Git 管理,团队协作时可锁定版本,避免配置漂移 |
为什么需要 OpenSkills?
痛点场景
场景 1:团队工具不统一
- 同事 A 用 Claude Code,同事 B 用 Cursor
- 同样的代码规范,却要分别配置两套 Skills → 重复劳动
场景 2:技能来源受限
- Claude Code 官方市场技能有限,想装 GitHub 上的社区技能 → 装不了
场景 3:企业私有规范
- 公司有内部开发规范、API 文档模板,想做成 Skill → 无法私有化部署
场景 4:多工具切换
- 写代码用 Cursor,调试复杂逻辑用 Claude Code,脚本任务用 Aider → 每套工具都要重新配置 Skills
OpenSkills 的解决方案
写一次 SKILL.md → 所有 AI 助手通用
从 GitHub 随便装 → 官方、社区、私有仓库都行
团队统一配置 → 提交到 Git,全员同步
如何使用 OpenSkills?
1. 安装 CLI 工具
# 全局安装(推荐)
npm install -g openskills
# 或使用 npx(无需全局安装)
npx openskills2. 安装技能(以 Anthropic 官方技能库为例)
# 安装到项目本地(默认 .claude/skills/)
npx openskills install anthropics/skills
# 安装到通用目录(推荐多工具共存时使用)
npx openskills install anthropics/skills --universal
# 从私有仓库安装
npx openskills install git@github.com:company/private-skills.git3. 同步生成 AGENTS.md
# 扫描已安装技能,生成/更新 AGENTS.md
npx openskills sync执行后,AI 助手就能在对话中识别并使用这些技能了 。
4. 常用命令速查
| 命令 | 作用 |
|---|---|
openskills list |
查看已安装的所有技能 |
openskills read <skill-name> |
读取某个技能的详细内容 |
openskills update |
更新技能到最新版本 |
openskills remove <skill-name> |
卸载指定技能 |
openskills sync |
重新生成 AGENTS.md |
实际应用场景
场景 1:团队协作统一配置
# 在项目根目录执行
npx openskills install company/internal-skills --universal
npx openskills sync
# 提交到 Git
git add .agent/skills AGENTS.md
git commit -m "Add team skills"团队成员 clone 项目后,无论用 Claude Code 还是 Cursor,AI 都会自动识别这些 Skills 。
场景 2:多工具无缝切换
你可能在不同场景使用不同工具:
- 写代码用 Cursor(IDE 集成好)
- 调试用 Claude Code(上下文长,适合复杂分析)
- 脚本任务用 Aider(轻量快速)
通过 OpenSkills,你的 Skills 配置在所有工具间无缝迁移,避免重复配置 。
场景 3:企业私有知识库
将内部开发规范、API 文档、代码模板做成 Skill:
npx openskills install git@github.com:company/private-skills.git这些 Skill 只在内部使用,不会泄露到公网,保护专有知识 。
技术细节:Universal Mode
如果你同时使用 Claude Code 和其他 AI 助手,建议开启 Universal Mode:
npx openskills install anthropics/skills --universal这会安装到 .agent/skills/ 而非 .claude/skills/,避免与 Claude Code 内置技能冲突 。
技能查找优先级(从高到低)
./.agent/skills/(项目级,Universal)~/.agent/skills/(全局,Universal)./.claude/skills/(项目级,Claude Code)~/.claude/skills/(全局,Claude Code)
意味着:项目级技能 > 全局技能,Universal > Claude 专用
与 Claude Code 原生 Skills 的区别
| 特性 | Claude Code 原生 | OpenSkills |
|---|---|---|
| 安装来源 | 仅限官方市场 | 任意 Git 仓库、本地路径、私有仓库 |
| 支持工具 | 仅 Claude Code | Claude Code、Cursor、Windsurf、Aider 等 |
| 调用方式 | Skill("pdf") 工具 |
openskills read pdf 命令 |
| 技能格式 | SKILL.md | 完全相同的 SKILL.md |
| 文件夹结构 | .claude/skills/ |
.claude/skills/ 或 .agent/skills/ |
总结
OpenSkills 是 AI 编程生态的"通用适配器":
- 对开发者:一次编写,处处运行,不再为不同 AI 工具重复造轮子
- 对团队:统一规范,版本可控,把团队知识沉淀成可复用的 Skills
- 对企业:私有化部署,保护核心知识资产
如果你在使用多个 AI 编程助手,或者想让 Claude Code 的技能在团队内共享,OpenSkills 是目前最优雅的解决方案 。
Reactions are currently unavailable