在深度使用 Claude Code 的过程中，我发现了一个有趣的现象：Claude Skills 的能力设计得很完善，但却被局限在 Claude Code 的生态内。

这让我思考——为什么不能让这些精心设计的技能跨越工具边界，在 Cursor、Windsurf 等其他 AI 编码助手中也能使用呢？

OpenSkills 项目的出现，恰好解决了这个痛点。本文将从实践角度出发，说明如何通过 OpenSkills 实现 Claude Skills 的跨平台使用。

传送门：https://github.com/numman-ali/openskills

环境要求

要使用 OpenSkills，需要满足以下前置条件：

• Node.js 版本 20.6 或更高
• Git（用于克隆仓库）

全局安装 OpenSkills 工具：

npm i -g openskills

Skill 安装的三种方式

OpenSkills 提供了灵活的安装方式，适应不同的使用场景：

1. 从 Anthropic 官方市场安装

项目级别安装（存储到 ./.claude/skills）：

openskills install anthropics/skills

全局安装（存储到 ~/.claude/skills）：

openskills install anthropics/skills --global

2. 从 GitHub 仓库安装

支持安装自定义或第三方的 Skill：

openskills install your-org/custom-skills

3. 从本地路径安装

用于本地开发或私有 Skill：

openskills install /path/to/my-skill

跨工具同步 Skill 的核心操作

安装完 Skill 后，需要将其同步到各个 AI 编码助手能识别的格式。OpenSkills 提供了统一的同步命令：

同步到默认的 AGENTS.md：

openskills sync

同步到自定义目录（若不存在则自动创建）：

openskills sync --output .ruler/AGENTS.md
openskills sync -o custom-rules.md

在 Qoder 中使用 Claude Skills 的实操流程

以 Qoder 为例，演示具体的集成步骤：

第一步：安装 Skill

可以通过两种方式将 Skill 放置在 Qoder 识别的目录：

• 手动放置到 ~/.agent/skills/ 目录
• 使用 openskills 命令自动安装到对应路径

安装时，系统会提示是否覆盖已存在的技能。

第二步：创建规则文件

在 Qoder 的「规则」中新增一个 AGENTS.md 文件（初始为空）。

第三步：执行同步

openskills sync --output .qoder/rules/AGENTS.md

命令执行后，会交互式地让你选择要安装的 Skill，同步完成后，这些 Skill 将在 Qoder 中始终生效。

实际应用场景

比如向 Qoder 输入指令：「把当前项目的 README.md 使用 pdf skill 转为 PDF 并放到项目中」，Qoder 会按照 AGENTS.md 规则中的指导，正确调用 pdf skill 将 README.md 转为 PDF 格式。

Cursor、Trae、Windsurf 等工具的通用方案

这些工具都支持规则文件（Rule）的加载机制，采用与 Qoder 相同的集成方式：

• 在工具对应的规则目录中创建 AGENTS.md 文件
• 执行 openskills sync 将 Skill 定义写入规则文件
• 工具加载规则后，AI 助手即可调用相应的 Skill

 

技术原理：Skill 的工作机制

Claude Code 中的实现

Claude Code 通过系统提示词的方式让模型感知可用 Skill。

When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively.

How to use skills:
- Invoke skills using this tool with the skill name only (no arguments)
- When you invoke a skill, you will see The "{name}" skill is loading
- The skill's prompt will expand and provide detailed instructions

Important:
- Only use skills listed in  below
- Do not invoke a skill that is already running




pdf
Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms...
plugin



xlsx
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis...
plugin

系统会向模型注入：

• 可用 Skill 列表（）
• 调用方式（Skill("skill_name")）
• Skill 加载和使用的规则

工作流程为：用户请求 → 模型扫描 available_skills → 调用匹配的 Skill → 加载 Skill 的 prompt 内容 → 执行任务。

OpenSkills 中的实现

OpenSkills 遵循相同的架构逻辑，但将 Skill 定义写入 AGENTS.md 文件，结构如下：

## Available Skills



When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively.

How to use skills:
- Invoke: Bash("openskills read ")
- The skill content will load with detailed instructions
- Base directory provided in output for resolving bundled resources

Usage notes:
- Only use skills listed in  below
- Do not invoke a skill that is already loaded in your context





pdf
Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms...
project



xlsx
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis...
project

工作流程为：用户请求 → 模型扫描 available_skills → 执行 Bash("openskills read skill-name") → 加载 Skill 的 prompt 到上下文 → 执行任务。

 

Claude Code 与 OpenSkills 的差异对比

维度	Claude Code	OpenSkills
系统提示词	内置	写入 AGENTS.md
调用方式	Skill("pdf")	Bash("openskills read pdf")
提示词格式	XML	XML（一致）
文件夹结构	.claude/skills/	.claude/skills/（一致）
Skill.md 格式	YAML + Markdown	YAML + Markdown（一致）
渐进式加载	支持	支持
绑定资源	references/, scripts/, assets/	references/, scripts/, assets/（一致）
市场来源	Anthropic 官方市场	GitHub（anthropics/skills）

 

OpenSkills 的路径优先级机制

OpenSkills 采用分层加载策略，优先级从高到低为：

1. ./.agent/skills/（项目级别 - 通用）
2. ~/.agent/skills/（全局 - 通用）
3. ./.claude/skills/（项目级别 - Claude）
4. ~/.claude/skills/（全局 - Claude）

这种设计允许用户在不同粒度上覆盖和定制 Skill 配置。

 

OpenSkills 命令行工具集

命令	功能说明
openskills install	从 GitHub、本地或私有仓库安装 Skill
openskills sync	更新 AGENTS.md（或自定义输出文件）
openskills list	显示已安装的 Skill 列表
openskills read	加载指定 Skill 的内容（供 Agent 使用）
openskills manage	交互式移除 Skill
openskills remove	移除特定 Skill

 

openskills install  [options]  # 从 GitHub 安装 Skill, 本地和私有仓库都支持
openskills sync [-y] [-o ]       # 更新 AGENTS.md (or custom output)
openskills list                        # 显示已安装 skills
openskills read                  #加载 skill (for agents)
openskills manage                      # 移除 skills (交互式)
openskills remove                # 移除特定 skill

常用参数说明

• --global — 将 Skill 安装到 ~/.claude/skills（默认为项目级别）
• --universal — 安装到 .agent/skills/ 而非 .claude/skills/（优先级更高）
• -y, --yes — 自动覆写（适用于脚本或 CI 流程）
• -o, --output — 自定义 sync 输出路径（默认：AGENTS.md）

 

总结

作为一个持续深度使用 Claude Code 的开发者，我认为 OpenSkills 项目的意义在于它打破了 Claude Skills 与特定工具之间的耦合关系。

通过统一的安装、同步和调用机制，开发者可以在 Qoder、Cursor、Windsurf 等不同的 AI 编码助手中复用同一套 Skill 库，大幅提升了工具选择的灵活性和 Skill 的投资价值。

如果你已经在某个 AI 编码工具中工作，不妨尝试用 OpenSkills 引入 Claude Skills 的能力。

特别是在团队协作场景中，标准化的 Skill 定义可以显著降低知识转移成本。期待看到更多开发者贡献自己的 Skill 到这个生态中。