Agent Skills是Cursor支持的一种开放标准,用于为AI Agent扩展专门能力。Skills将特定领域的知识和工作流打包成可复用的模块,Agent可以根据上下文自动调用相关技能。本文将详细介绍Skills的概念、启用方法、OpenSkills工具的使用,以及创建自定义技能的实践技巧。Skills功能与Rules规则类似,但更加模块化和可移植。
⚠️ 功能可用性说明
Agent Skills 目前仅在Cursor Nightly更新渠道中可用。如需使用此功能,请先切换到Nightly渠道。
📑 本文目录
🎯 一、什么是Agent Skills
技能的定义
技能的特点
⚙️ 二、技能的工作方式
📄 三、SKILL.md文件格式
🔓 四、启用Agent Skills
📦 五、使用OpenSkills安装技能
安装OpenSkills
安装官方Skills
创建AGENTS.md
调用Skills
🛠️ 六、创建自定义Skills技巧
🎯 一、什么是Agent Skills
技能的定义
Agent Skills是一种用于为AI Agent扩展专门能力的开放标准。你可以把Skills理解为AI Agent的"技能包"——它将特定领域的知识、工作流程和工具打包在一起,让Agent能够执行更专业的任务。
与MCP协议连接外部工具不同,Skills更侧重于提供知识和指令,告诉Agent"如何"完成某类任务。
技能的特点
可移植:技能可以在任何支持Agent Skills标准的Agent中使用,不局限于Cursor
版本控制:技能以文件形式存储,可以在代码仓库中进行管理和追踪,或通过GitHub仓库链接安装
模块化:每个技能是独立的模块,可以按需组合使用
自动触发:Agent会根据任务上下文自动判断并调用相关技能
⚙️ 二、技能的工作方式
启用Agent Skills后,Cursor的工作流程如下:
加载技能:Cursor启动时加载所有启用的技能,Agent获得可用技能列表
智能匹配:当你发送请求时,Agent根据任务上下文判断哪些技能可能相关
自动调用:如果某个技能与当前任务相关,Agent会自动将该技能的信息拉取到上下文中
执行任务:Agent根据技能提供的知识和指令执行任务
💡 Skills与Rules的区别
Skills被视为"由Agent自主触发的规则"——与普通Rules不同,Skills无法配置为"始终应用"或"手动应用",完全由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更新渠道
打开Cursor设置(快捷键 Cmd+Shift+J 或 Ctrl+Shift+J)
选择 Beta 选项卡
将更新渠道设置为 Nightly
等待更新完成后重启Cursor
步骤2:开启Skills功能
打开 Cursor Settings → Rules
找到 Import Settings 部分
切换 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文件夹。
ℹ️ 安装其他Skills
你也可以安装其他非官方Skills,只需将仓库地址替换为对应地址:openskills install your-org/custom-skills
步骤3:创建AGENTS.md文件
安装技能后,还需要创建AGENTS.md文件让Cursor能够发现和使用这些技能:
在项目根目录创建一个空白的 AGENTS.md 文件
运行同步命令:
openskills sync
选择你要写入AGENTS.md的技能
按回车确认,所选技能将被写入AGENTS.md文档
AGENTS.md将作为Cursor使用Skills的指导文件。
步骤4:调用Skills
Skills可以被Agent自动调用,也可以在提示词中手动指定:
调用 frontend-design skills,用HTML开发一个视频剪辑软件的SaaS介绍页
或者:
调用 frontend-design skills,用HTML创建一个现代化的个人博客网站原型
🛠️ 六、创建自定义Skills技巧
如果你想创建自己的Skills,以下是一些实践心得:
学习官方示例:最便捷的方法是把Anthropic官方skills仓库克隆到本地,让AI先阅读其中的skill-creator技能,它会教AI如何创建规范的skill
梳理工作流:创建Skills的目的是将某个工作流标准化。你需要提前将这个工作流清晰地梳理出来
MVP先行:不必一次性做到完美。先做一个MVP版本的Skills跑一遍,发现问题后针对性调优
版本管理:使用Git管理Skills的迭代过程,方便回溯和协作
倒推法:对于复杂的Skills,可以先实现最终的脚本,测试通过后再往前倒推,最后用skill-creator串联成完整的SKILL.md
💡 进一步学习
了解更多关于Agent Skills的信息,可以访问官方网站 agentskills.io