在 AI 编程工具爆发的今天，Claude Code、Antigravity、Cursor、Trae 等工具各有特色，而 Skill（技能）是 Anthropic 率先提出的轻量级 Agent 技能包方案([code.claude.com/docs/zh-CN/… 相较于MCP 方案的繁重，Skill 以简洁的格式为 Agent 提供模块化技能支持。但当前存在一个核心痛点：Skill 格式虽优秀，却因其他 AI 编辑器的系统提示词配置、技能识别逻辑差异等因素，难以直接复用，开发者往往需要为不同工具重复适配同一套 Skill 功能。而 OpenSkills 的出现正是为了解决了这个问题——它就像一座“技能桥梁”，在保持 Anthropic 设定的 Skill 格式不变的前提下，通过大多数 AI 编辑器都支持的方式提供技能信息，让一套 Skill 能在所有 AI 编辑器中无缝复用。本文将从“是什么”“怎么用”“原理是什么”三个维度，带你彻底掌握 OpenSkills。
一、OpenSkills 是什么？为什么需要它？
1. 什么是 OpenSkills？
OpenSkills 是一款开源的跨编辑器 AI 技能管理工具，核心是在完全保留 Anthropic 提出的 SKILL格式标准不变的基础上，解决“Skill 难以在非 Claude 编辑器中直接使用”的问题。简单说，它就是 AI 技能的“格式适配器”和“信息传递者”——通过大多数 AI 编辑器都支持的方式（如标准化提示词片段、配置文件导入等）传递 Skill 信息，让不同 AI 编辑器都能读懂、使用同一套 Skill 文件。
2. 为什么需要 OpenSkills？
在没有 OpenSkills 之前，你可能会遇到这些麻烦：
- 「重复适配」：为 Claude Code 开发的 Skill，换用 Antigravity、Cursor 等编辑器时，需要重新适配系统提示词、调整技能调用逻辑；
- 「识别障碍」：其他编辑器因无原生 SKILL.md 识别逻辑，无法直接读取 Claude 生态的 Skill 文件；
- 「管理混乱」：适配后的技能分散存储在不同编辑器的配置中，后续维护、更新要逐个操作。
而 OpenSkills 刚好解决这些问题：它不改变 Anthropic 设定的 Skill 核心格式，而是通过“标准化信息同步 + 通用导入方式”，让 Skill 信息能被各类 AI 编辑器识别，实现“一次开发/安装，全编辑器复用”，极大降低了 Skill 的适配成本和维护成本。
3. OpenSkills 的核心作用
- 格式兼容保留：严格遵循 Anthropic SKILL.md 标准，不修改原有 Skill 格式，保障与 Claude 生态的兼容性；
- 跨编辑器适配：通过标准化方式传递 Skill 信息，让 Antigravity、Cursor 等非 Claude 编辑器也能使用 Skill；
- 简化技能调用：通过简单命令就能读取 Skill 完整内容，快速导入到编辑器系统提示中；
- 同步技能信息：自动生成/更新 AGENTS.md 文件，汇总所有 Skill 信息，方便编辑器统一读取。
二、OpenSkills 基础使用：从安装到技能部署
在使用 OpenSkills 前，需先确保电脑安装了 Node.js（版本 ≥20.6.0） ，可通过 node -v 命令验证（若未安装，前往 Node.js 官网 下载安装）。
1. 第一步：安装 OpenSkills
打开终端（Windows 用 PowerShell/CMD，macOS/Linux 用 Terminal），执行以下命令全局安装：
# 全局安装 OpenSkills
npm install -g openskills
# 验证安装成功（显示版本号即成功）
openskills --version
# 查看命令帮助（了解所有可用功能）
openskills --help
2. 第二步：通过 OpenSkills 安装技能
OpenSkills 支持多种技能来源：GitHub 仓库、本地路径、Git URL 等，核心命令是 openskills install <技能来源>，不同参数对应不同安装路径，适配不同场景。
2.1 三种核心安装参数（路径说明）
OpenSkills 有 3 种常用安装模式，对应不同的存储路径，优先级从高到低为：项目级 > 全局级，同名技能会覆盖低优先级版本。
| 安装参数 | 默认安装路径（Windows 示例） | 默认安装路径（macOS/Linux 示例） | 适用场景 |
|---|---|---|---|
| 无参数（默认 --project） | 当前项目目录/.claude/skills | 当前项目目录/.claude/skills | 仅当前项目使用，兼容 Claude Code 原生目录 |
| --global | C:\Users\你的用户名.claude\skills | ~/.claude/skills | 所有项目共享，适配 Claude Code 全局技能 |
| --universal | 当前项目目录/.agent/skills | 当前项目目录/.agent/skills | 跨编辑器通用（Antigravity、Trae 等均支持） |
2.2 具体安装示例
# 示例 1：安装 Anthropic 官方 PDF 技能（项目级，默认到 .claude/skills）
openskills install anthropics/skills/pdf
# 示例 2：安装 Excel 技能（全局级，所有项目可用）
openskills install anthropics/skills/xlsx --global
# 示例 3：安装前端设计技能（跨编辑器通用，到 .agent/skills）
openskills install anthropics/skills/frontend-design --universal
# 示例 4：安装本地自定义技能（路径为本地文件夹）
openskills install ./my-custom-skill --project
# 示例 5：批量安装所有官方技能
openskills install anthropics/skills --project
3. Windows中出现路径识别问题的解决办法
在 Windows 系统中，执行 openskills install --universal 时，可能会因路径解析兼容问题而出现错误。此时推荐 手动克隆 + 复制 的兜底方案，步骤如下：
# 第一步：克隆目标技能仓库（以 Anthropic 官方技能为例）
git clone https://github.com/anthropics/skills.git temp-skills
# 第二步：手动创建目标目录（按需选择，以 .agent/skills 为例）
mkdir -p C:\Users\你的用户名\Desktop\项目名.agent\skills
# 第三步：复制技能文件到目标目录（Windows 用 xcopy 命令）
xcopy temp-skills* C:\Users\你的用户名\Desktop\项目名.agent\skills /E /I /Y
# 第四步：删除临时克隆目录（清理文件）
rmdir /s /q temp-skills
说明：xcopy 命令中，/E 复制所有子目录，/I 假设目标是目录，/Y 覆盖现有文件，无需手动确认。
三、OpenSkills 工作原理：读懂这两点就够了
OpenSkills 的核心逻辑很简单：统一技能存储路径 + 生成标准化技能信息 + 提供通用读取命令，具体通过两个核心机制实现。
1. 机制一：通过 openskill sync 同步技能信息到 AGENTS.md
AGENTS.md 是 AI 编辑器识别技能的“说明书”，OpenSkills 通过 sync 命令自动扫描已安装的技能，将技能信息（名称、描述、路径）整理成标准化格式，写入 AGENTS.md 中。
1.1 sync 命令的核心作用
- 自动扫描：按固定路径优先级扫描已安装的技能（下文会详细说明扫描路径）；
- 生成/更新文件：若当前目录没有 AGENTS.md，自动创建；若已有，则追加/更新技能信息；
- 标准化格式：生成 AI 能识别的 XML 片段，包含所有技能的核心信息。
1.2 sync 命令的扫描路径（优先级从高到低）
执行 openskill sync 时，会按以下顺序扫描技能，确保优先识别项目专属技能，避免冲突：
- 当前项目目录/.agent/skills（--universal 安装的跨编辑器技能）；
- 用户全局目录/.agent/skills（全局跨编辑器技能，Windows 路径：C:\Users\你的用户名.agent\skills）；
- 当前项目目录/.claude/skills（--project 安装的 Claude 项目级技能）；
- 用户全局目录/.claude/skills（--global 安装的 Claude 全局技能）。
1.3 sync 命令使用示例
# 基础用法：生成/更新当前目录的 AGENTS.md
openskills sync
2. 机制二：通过 openskill read 读取技能内容
当 AI 编辑器需要使用某个技能时，OpenSkills 提供 openskill read <技能名> 命令，快速输出该技能的完整内容（包含 YAML 元信息 + 详细操作指令），供 AI 解析使用。
2.1 read 命令的路径读取规则
read 命令的路径扫描顺序和 sync 命令一致（项目 .agent > 全局 .agent > 项目 .claude > 全局 .claude），找到第一个匹配的技能后就停止扫描，避免同名冲突。
2.2 技能读取注意事项
读取技能时，若遇到「技能未找到」的问题，可先通过 openskills list 命令查看当前已安装的所有技能，确认技能名称是否正确（技能名称区分大小写，需与安装时一致）。
总结
- 安装 OpenSkills：全局安装，一步到位；
- 安装 + 同步技能：用 install 安装技能，用 sync 生成 AGENTS.md；
- 编辑器适配：按编辑器类型导入 AGENTS.md 或可以选择进一步适配根据当前编辑器的使用规范，将
openskills sync生成的 AGENTS.md 中 片段配置到编辑器的项目级或全局级 Rule（规则）、Workflow（工作流）中即可复用。
通过 OpenSkills，你无需再为不同编辑器重复配置技能，一次安装、全平台通用，让 AI 工具的效率最大化。如果需要进一步学习自定义技能开发，可参考 Anthropic 官方技能规范：agentskills.io/specificati…。
优质 Skills 推荐
以下是经过验证的优质技能资源，可直接安装使用：
-
Anthropic 官方提供：github.com/anthropics/…
-
社区整理合集：github.com/ComposioHQ/…
