工具支持
Agent Skills 作为开放标准，已被多种 AI 编程工具支持。本章介绍各工具对 Skills 的支持情况和使用方法。
支持工具概览
| 工具 | 支持状态 | Skills 目录 | 特殊功能 |
|---|---|---|---|
| Claude Code | ✅ 完全支持 | .claude/skills/ | 自然语言安装 |
| Trae IDE | ✅ 完全支持 | .trae/skills/ | Skill 创建工具 |
| Cursor | ✅ 支持 | .cursor/skills/ | - |
| Windsurf | ✅ 支持 | .windsurf/skills/ | - |
| Gemini CLI | ✅ 支持 | .gemini/skills/ | - |
| OpenAI Codex | 🔄 计划中 | - | - |
Claude Code
Claude Code 是 Anthropic 官方的命令行 AI 编程助手，对 Skills 有最完整的支持。
安装 Skills
方式一：自然语言安装
直接告诉 Claude Code 安装 Skill：
帮我安装 skill，项目地址是：https://github.com/anthropics/skills/blob/main/skills/code-reviewer
方式二：手动创建
在项目根目录创建 Skills 目录：
mkdir -p .claude/skills/my-skill
创建 SKILL.md 文件：
touch .claude/skills/my-skill/SKILL.md
方式三：从 GitHub 克隆
cd .claude/skills
git clone https://github.com/anthropics/skills.git temp
mv temp/skills/* .
rm -rf temp
使用 Skills
安装后，Skills 会根据 description 自动触发：
用户：请审查这段 Python 代码
AI：（自动使用 python-code-reviewer skill）
也可以显式调用：
用户：使用 code-reviewer skill 审查这个文件
管理 Skills
查看已安装的 Skills：
列出所有已安装的 skills
更新 Skill：
直接编辑 .claude/skills/ 目录下的文件。
删除 Skill：
rm -rf .claude/skills/skill-name
Trae IDE
Trae IDE 是一款支持 Agent Skills 的集成开发环境，提供了可视化的 Skill 管理功能。
安装 Skills
方式一：使用 Skill 创建工具
Trae IDE 内置了 Skill 创建工具，可以通过界面引导创建新的 Skill。
方式二：手动创建
mkdir -p .trae/skills/my-skill
创建 SKILL.md 文件并编写内容。
目录结构
项目根目录/
├── .trae/
│ ├── skills/
│ │ ├── code-reviewer/
│ │ │ └── SKILL.md
│ │ └── test-generator/
│ │ └── SKILL.md
│ └── rules/
│ └── project_rules.md
└── ...
使用 Skills
在对话中直接描述需求，Trae IDE 会自动匹配并触发相应的 Skill：
用户：帮我审查一下 src/main.py 这个文件
AI：（自动使用 code-reviewer skill）
创建 Skill 的最佳实践
Trae IDE 提供了 Skill 创建的最佳实践模板：
---
name: "skill-name"
description: "功能描述。Invoke when [触发条件]。"
---
# Skill 标题
[详细指令内容]
注意：description 中建议使用 "Invoke when" 来描述触发条件，这是 Trae IDE 的推荐格式。
Cursor
Cursor 是一款流行的 AI 编程编辑器，支持 Agent Skills。
配置 Skills
Skills 存放在 .cursor/skills/ 目录：
项目根目录/
├── .cursor/
│ └── skills/
│ └── my-skill/
│ └── SKILL.md
└── ...
使用方式
在 Cursor 的 AI 对话中，Skills 会根据用户输入自动触发。
Windsurf
Windsurf 是另一款支持 Agent Skills 的 AI 编程工具。
目录结构
项目根目录/
├── .windsurf/
│ └── skills/
│ └── my-skill/
│ └── SKILL.md
└── ...
使用方式
与 Claude Code 类似，Skills 会根据 description 自动触发。
Gemini CLI
Google 的 Gemini CLI 也支持 Agent Skills 标准。
目录结构
项目根目录/
├── .gemini/
│ └── skills/
│ └── my-skill/
│ └── SKILL.md
└── ...
全局 Skills
除了项目级别的 Skills，大多数工具还支持全局 Skills，适用于所有项目。
全局 Skills 位置
| 工具 | 全局 Skills 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Trae IDE | ~/.trae/skills/ |
| Cursor | ~/.cursor/skills/ |
全局 vs 项目 Skills
- 全局 Skills：适用于所有项目，适合通用技能（如代码审查、文档生成）
- 项目 Skills：仅适用于当前项目，适合项目特定需求（如特定框架规范）
优先级
当全局和项目中存在同名 Skill 时，项目级 Skill 优先。
Skills 共享
GitHub 仓库
可以将 Skills 发布到 GitHub 仓库供他人使用：
my-skills/
├── README.md
├── skills/
│ ├── code-reviewer/
│ │ └── SKILL.md
│ └── test-generator/
│ └── SKILL.md
└── LICENSE
安装共享的 Skills
从 GitHub 仓库安装：
# Claude Code
git clone https://github.com/user/my-skills.git temp
mv temp/skills/* .claude/skills/
rm -rf temp
或使用自然语言：
帮我安装 skill，地址是：https://github.com/user/my-skills
跨工具兼容性
由于 Agent Skills 是开放标准，同一个 Skill 可以在不同工具中使用。
兼容性注意事项
- 目录位置：不同工具使用不同的目录名
- description 格式：建议同时包含功能描述和触发条件
- 特殊功能：某些工具可能有特殊功能，但核心格式保持一致
跨工具使用示例
假设你有一个 Skill：
---
name: "code-reviewer"
description: "审查代码质量。当用户请求代码审查时触发。"
---
# 代码审查专家
...
这个 Skill 可以直接复制到不同工具的 skills 目录中使用：
# 复制到 Claude Code
cp -r my-skill .claude/skills/
# 复制到 Trae IDE
cp -r my-skill .trae/skills/
# 复制到 Cursor
cp -r my-skill .cursor/skills/
调试 Skills
验证 Skill 格式
确保 SKILL.md 文件格式正确：
- frontmatter 使用
---包围 - name 和 description 字段存在
- description 不超过 1024 字符
测试触发
测试 Skill 是否正确触发：
- 使用 description 中包含的关键词
- 观察是否正确调用 Skill
- 检查输出是否符合预期
常见问题
Skill 不触发
- 检查 description 是否包含正确的关键词
- 确认 Skill 文件位置正确
- 验证 frontmatter 格式
输出不符合预期
- 检查指令是否清晰
- 添加更多示例
- 明确输出格式
小结
各工具对 Agent Skills 的支持情况：
- Claude Code：最完整的支持，支持自然语言安装
- Trae IDE：内置 Skill 创建工具，推荐格式略有不同
- Cursor/Windsurf/Gemini CLI：支持基本功能
- 跨工具兼容：核心格式一致，可跨工具使用
下一章是 知识速查表，汇总所有关键知识点。