如何安装智能体技能

技能就是包含 SKILL.md 文件的文件夹。安装技能就是将该文件夹放到智能体能识别的位置。以下是各工具对应的目录位置。

通用方法

每个智能体都从特定目录读取技能。有两种作用域：

项目技能

存放在你的仓库中。提交到版本控制。项目中的每个人都可以使用。

个人技能

存放在你的 home 目录中。跨所有项目可用。仅你自己可以使用。

手动下载并保存

最简单的方式——无需 CLI 工具：

在 mdskills.ai 上找到一个技能，点击详情页上的下载按钮。
在项目中创建技能文件夹。例如，对于 Claude Code：
mkdir -p .claude/skills/my-skill
将文件保存为 SKILL.md 到该文件夹中：
mv ~/Downloads/SKILL.md .claude/skills/my-skill/
重启你的智能体（或开始新会话）。技能现在已可用。

文件夹名就是技能名。名为 review-pr 的文件夹在支持斜杠命令的智能体中会变成 /review-pr 命令。

应该保存到哪里？ 请参阅下方各智能体的详细指南获取具体目录路径。简而言之：大多数智能体使用项目根目录下的 .{agent}/skills/{name}/SKILL.md 路径。

通过 CLI 快速安装

从 GitHub 仓库安装技能的最快方式：

# Install from mdskills.ai

npx mdskills install <skill-name>

# Or use the Vercel CLI

npx skills add <owner>/<repo>

# Or install manually — just clone and copy

git clone https://github.com/owner/skills-repo.git

cp -r skills-repo/my-skill .claude/skills/

CLI 工具会自动检测你已安装的智能体，并将技能放到正确的目录。但你不一定需要 CLI——手动复制文件夹同样有效。

各智能体配置指南

Claude Code

文档

项目级：.claude/skills/<skill-name>/SKILL.md

个人级：~/.claude/skills/<skill-name>/SKILL.md

Claude Code 对技能的支持最为深入。技能会显示为斜杠命令——名为 review-pr 的技能会变成 /review-pr。当你的请求匹配到某个技能的描述时，Claude 还会自动加载该技能。

如果你在 .claude/commands/ 中有现有文件，它们仍然有效。技能是更新的格式，支持额外功能，如内置脚本和 frontmatter 配置。

Claude Code 还支持插件，可以将多个技能与 MCP 服务器和其他扩展打包在一起。通过 CLI 中的 /plugins 命令安装插件。

Cursor

文档

项目级：.cursor/skills/<skill-name>/SKILL.md

个人级：~/.cursor/skills/<skill-name>/SKILL.md

Cursor 于 2026 年 2 月推出了市场，将技能作为其插件系统的一部分。技能是五种插件原语之一，与 MCP 服务器、子智能体、钩子和规则并列。

你也可以将技能放在 .agents/skills/ 目录下——多个智能体都能识别此路径，如果你的团队使用不同的工具，这是一个不错的选择。

VS Code (Copilot)

文档

项目级：.github/skills/<skill-name>/SKILL.md

个人级：~/.copilot/skills/<skill-name>/SKILL.md

VS Code 通过 GitHub Copilot 支持智能体技能。项目技能放在 .github/skills/ 目录下，这意味着它们会与代码一起自动纳入版本控制。

VS Code 也识别 .claude/skills/ 和 .agents/skills/ 路径。你可以通过 chat.agentSkillsLocations 设置配置额外的搜索路径。

在 Copilot 聊天中输入 / 即可查看可用技能并直接调用。

OpenAI Codex

文档

项目级：.agents/skills/<skill-name>/SKILL.md

个人级：~/.agents/skills/<skill-name>/SKILL.md

Codex 默认使用 .agents/skills/ 目录。这是多个智能体都能识别的厂商中立路径，如果你发布需要跨工具使用的技能，这是一个安全的选择。

Gemini CLI

文档

项目级：.gemini/skills/<skill-name>/SKILL.md

个人级：~/.gemini/skills/<skill-name>/SKILL.md

Gemini CLI 也会从 .agents/skills/ 作为备选路径读取。如果你专门针对 Gemini CLI，请使用 .gemini/skills/ 路径。对于跨智能体兼容性，请使用 .agents/skills/。

跨智能体兼容性

如果你发布技能并希望它到处都能用，请使用 .agents/skills/ 路径。大多数智能体会将此目录作为备选路径检查。对于团队统一使用同一工具的项目级技能，使用厂商特定路径即可。

提示：你可以将同一个技能放在多个目录中。有些团队会通过符号链接让技能在不同路径下都能访问，这样无论使用哪个智能体都能正常工作。简单的 ln -s 就能搞定。

验证安装是否成功

安装技能后，检查你的智能体是否能识别它：

Claude Code：询问「有哪些可用技能？」或输入 / 在自动补全菜单中查看技能。
VS Code：在 Copilot 聊天面板中输入 /。
任何智能体：询问「你有关于 [任务] 的技能吗？」看它是否能识别技能描述。

如果技能没有显示，请检查文件夹结构。目录中必须包含 SKILL.md 文件（区分大小写）。

浏览可安装的技能 →创建你自己的技能 →最佳实践 →