Cursor如何使用Agent Skills？技能功能完整教程

🎯 一、什么是Agent Skills

技能的定义

Agent Skills是一种用于为AI Agent扩展专门能力的开放标准。你可以把Skills理解为AI Agent的"技能包"——它将特定领域的知识、工作流程和工具打包在一起，让Agent能够执行更专业的任务。

与MCP协议连接外部工具不同，Skills更侧重于提供知识和指令，告诉Agent"如何"完成某类任务。

技能的特点

1. 可移植：技能可以在任何支持Agent Skills标准的Agent中使用，不局限于Cursor
2. 版本控制：技能以文件形式存储，可以在代码仓库中进行管理和追踪，或通过GitHub仓库链接安装
3. 模块化：每个技能是独立的模块，可以按需组合使用
4. 自动触发：Agent会根据任务上下文自动判断并调用相关技能

⚙️ 二、技能的工作方式

启用Agent Skills后，Cursor的工作流程如下：

1. 加载技能：Cursor启动时加载所有启用的技能，Agent获得可用技能列表
2. 智能匹配：当你发送请求时，Agent根据任务上下文判断哪些技能可能相关
3. 自动调用：如果某个技能与当前任务相关，Agent会自动将该技能的信息拉取到上下文中
4. 执行任务：Agent根据技能提供的知识和指令执行任务

📄 三、SKILL.md文件格式

每个技能都在一个SKILL.md文件中定义。这个Markdown文件包含技能的指令和元数据，Agent会根据这些内容判断何时以及如何使用该技能。

基本格式如下：

# Skill Name

Description of what this skill does and when to use it.

## Instructions

- Step-by-step guidance for the agent
- Domain-specific conventions
- Best practices and patterns

一个完整的技能目录结构通常包含：

skill-name/
├── SKILL.md          # 必需：技能定义文件
├── scripts/          # 可选：可执行脚本（Python/Bash等）
├── references/       # 可选：参考文档
└── assets/           # 可选：模板、图标等资源文件

🔓 四、启用Agent Skills

要在Cursor中使用Agent Skills，需要完成以下步骤：

步骤1：切换到Nightly更新渠道

1. 打开Cursor设置（快捷键 Cmd+Shift+J 或 Ctrl+Shift+J）
2. 选择 Beta 选项卡
3. 将更新渠道设置为 Nightly
4. 等待更新完成后重启Cursor

步骤2：开启Skills功能

1. 打开 Cursor Settings → Rules
2. 找到 Import Settings 部分
3. 切换 Agent Skills 开关将其开启（下图所示）

📦 五、使用OpenSkills安装技能

如果你想在Cursor中使用Claude Code的Skills（如Anthropic官方提供的技能），可以使用OpenSkills这个开源工具。

步骤1：安装OpenSkills

打开终端，运行以下命令将OpenSkills安装到系统全局：

npm i -g openskills

此命令只需执行一次。

步骤2：安装Anthropic官方Skills

你可以选择将技能安装到当前项目或全局：

安装到当前项目：

openskills install anthropics/skills

安装到全局：

openskills install anthropics/skills --global

运行命令后，OpenSkills会克隆Anthropic官方Skills仓库。你可以通过空格键选择要安装的具体技能。安装成功后，你会在文件管理区看到.claude/skills文件夹。

步骤3：创建AGENTS.md文件

安装技能后，还需要创建AGENTS.md文件让Cursor能够发现和使用这些技能：

1. 在项目根目录创建一个空白的 AGENTS.md 文件
2. 运行同步命令：

openskills sync

3. 选择你要写入AGENTS.md的技能
4. 按回车确认，所选技能将被写入AGENTS.md文档

AGENTS.md将作为Cursor使用Skills的指导文件。

步骤4：调用Skills

Skills可以被Agent自动调用，也可以在提示词中手动指定：

调用 frontend-design skills，用HTML开发一个视频剪辑软件的SaaS介绍页

或者：

调用 frontend-design skills，用HTML创建一个现代化的个人博客网站原型

🛠️ 六、创建自定义Skills技巧

如果你想创建自己的Skills，以下是一些实践心得：

1. 学习官方示例：最便捷的方法是把Anthropic官方skills仓库克隆到本地，让AI先阅读其中的skill-creator技能，它会教AI如何创建规范的skill
2. 梳理工作流：创建Skills的目的是将某个工作流标准化。你需要提前将这个工作流清晰地梳理出来
3. MVP先行：不必一次性做到完美。先做一个MVP版本的Skills跑一遍，发现问题后针对性调优
4. 版本管理：使用Git管理Skills的迭代过程，方便回溯和协作
5. 倒推法：对于复杂的Skills，可以先实现最终的脚本，测试通过后再往前倒推，最后用skill-creator串联成完整的SKILL.md