一个 SKILL.md，适配所有工具：Claude Skills 在 Cursor、Windsurf 和 Gemini CLI 中也能用

当 Anthropic 在 2025 年 10 月推出 Claude Skills 时，初始定位很明确：在 Claude Code 中安装 skills，用 Claude 获得更好的结果。接下来发生的事让所有人惊讶。

几周内，开发者发现 SKILL.md 文件在 Codex CLI 中也能工作。然后是 Gemini CLI。社区工具出现了，可以为 Cursor 和 Windsurf 自动转换 skills。到 2026 年初，VoltAgent 的 awesome-agent-skills 仓库将 SKILL.md 描述为"兼容 Codex、Antigravity、Gemini CLI、Cursor 等"——并为此收获了 10,000+ 星。

Claude Skill 规范，事实证明，成为了 AI 智能体指令的开放标准。以下是这在实践中意味着什么。

为什么 SKILL.md 成为跨平台标准

SKILL.md 格式故意简单：一个 YAML frontmatter 块后跟纯 Markdown 指令。没有 Claude 特定的 API，没有工具特定的语法，没有专有脚手架。它就是结构化文本。

---
name: code-reviewer
description: >
  聚焦安全的代码审查，检查 OWASP Top 10 漏洞、
  常见注入模式和硬编码凭据。
triggers:
  - "review my code"
  - "security review"
  - "check for vulnerabilities"
---

审查代码时，始终检查：
1. 数据库调用中通过字符串拼接的 SQL 注入
2. 硬编码的密钥（API 密钥、密码、令牌）
3. 未验证的用户输入到达敏感操作
...

任何接收此文件作为上下文的 LLM 都可以遵循这些指令。唯一工具特定的部分是文件如何被加载——这就是生态系统分化的地方。

逐工具：Agent Skills 如何加载

第一梯队：原生 SKILL.md 支持

这些工具原生读取 .claude/skills/*/SKILL.md：

Claude Code——原创者。Claude 在会话开始时扫描 skill frontmatter（每个 skill ~100 token），仅在相关时加载完整指令。渐进式披露意味着 20 个安装的 skills 在启动时总共大约花费 2,000 token。

Codex CLI（OpenAI）——直接支持 Agent Skills 规范。像 Claude Code 一样安装 skills；Codex 自动发现它们。

Gemini CLI（Google）——从兼容的 skill 目录读取 SKILL.md 文件。Simon Willison 早期确认了为 Claude Code 编写的 skills 无需修改即可在 Gemini CLI 中工作。

Antigravity——原生 SKILL.md 支持是发布功能。Anthropic 兼容的目录结构被视为规范安装路径。

OpenCode——社区驱动的 Claude Code 替代方案，完全兼容 SKILL.md。

第二梯队：需要适配器

Cursor——使用 .cursor/rules/*.mdc 文件和 glob 模式。SKILL.md 文件不会原生加载，但内容可以直接翻译。

Windsurf——使用单个 .windsurfrules 文件，在每次提示时整体加载。没有按请求加载——所有 skill 内容进入一个文件，因此需要有选择性。

GitHub Copilot——使用 .github/copilot-instructions.md。类似于 Windsurf：始终加载，所以保持精简。

转换工具包

agent-skill-creator

FrancyJGLisboa/agent-skill-creator（支持 14+ 工具）接收 SKILL.md 源并为每个目标生成平台特定格式：

# 安装
npm install -g agent-skill-creator

# 从 SKILL.md 生成所有支持工具的格式
agent-skill-creator convert ./my-skill/SKILL.md --targets claude,cursor,windsurf,copilot

skills.sh

skills.sh 包注册表支持跨工具安装：

# 安装 skill 到 Claude Code
skills install trailofbits/skills/static-analysis

# 安装同一 skill 适配 Cursor
skills install trailofbits/skills/static-analysis --target cursor

跨平台经济学

一个经常被忽视的 SKILL.md 格式优势是不同工具间的 token 成本差异。

Claude Code（渐进式披露）：

• 启动：每个 skill ~100 token（仅 frontmatter）
• 激活时：完整 skill 内容（~1,000-5,000 token）
• 20 个 skills → 启动 ~2,000 token + 按需加载 skills

Windsurf（.windsurfrules，始终加载）：

• 每次提示：完整 .windsurfrules 内容
• 如果添加全部 20 个 skills：每次提示 ~100,000 token
• 实际限制：3-5 个聚焦规则，不是 20 个

Cursor（.mdc，glob 匹配）：

• 按文件：仅匹配当前文件路径的规则
• 对文件特定规则高效，对对话触发器效率较低

这不是避免 Cursor 或 Windsurf 的理由——而是要有意识地选择将哪些 skills 放在哪里。您的通用 SKILL.md 库可能包含 20 个 skills；您的 Windsurf 规则可能只包含最通用的 3 个。

选择适合您工作流的工具

如果您想要...	使用...
最佳渐进式加载	Claude Code
紧密的 IDE 集成	Cursor
单配置简洁性	Windsurf
可脚本化自动化	Codex CLI 或 Gemini CLI
跨平台一切	编写 SKILL.md + 使用 agent-skill-creator

好消息是：您不必永久选择。您今天为 Claude Code 编写的 skills 明天就可以在同事的 Cursor 设置中工作，只需最少的适配。

在哪里找到跨平台 Skills

claudeskills.info 列出了带有跨平台兼容性信息的 skills。您可以按工具支持过滤、按类别浏览并下载安装就绪的包。无论您运行的是 Claude Code、Cursor、Windsurf 还是它们的组合，都有一个不断增长的 skills 库可供使用。

对于希望在不同工具之间标准化的团队，推荐的方法是以 SKILL.md 格式维护规范 skills，并为每个开发者偏好的环境使用自动转换。一次编写，到处运行——开放 Agent Skills 规范的承诺。

---

来源：VoltAgent/awesome-agent-skills · FrancyJGLisboa/agent-skill-creator · Claude Code vs Cursor vs Windsurf 比较 · shinpr/sub-agents-skills