Skills
Agent Skills 开放标准在 Cursor 里的用法：内置 skills、skill 目录（.agents/skills、.cursor/skills 及兼容 Claude/Codex 目录）、SKILL.md 结构与嵌套目录。
Agent Skills 是用专门能力扩展 AI 智能体的开放标准。Skills 打包领域特定的知识和工作流，智能体可以用它们执行特定任务。一个 skill 是可移植、可版本控制的包，教智能体如何执行领域特定的任务，可以包含智能体用其工具执行的脚本、模板和参考资料：
- 可移植：skills 在任何支持 Agent Skills 标准的智能体上都能用
- 可版本控制：以文件形式存储，可以在你的仓库里跟踪
- 可操作：可以包含智能体用工具执行的脚本、模板和参考资料
- 渐进：按需加载资源，保持上下文使用高效
skills 如何工作
Cursor 启动时自动从 skill 目录发现 skills 并提供给 Agent。智能体看到可用的 skills，并根据上下文决定它们何时相关。也可以手动调用：在 Agent 聊天里输入 / 并搜索 skill 名；这样调用的 skill 附加到一条消息上。要让 skill 在整个会话里保持开启，用 Option+Enter（Mac）或 Alt+Enter（Windows）把它用作 Custom Mode。
内置 Cursor skills
Cursor 包含一小组内置 skills 来改进你的通用工作流，由 Cursor 管理，与你自己添加的 skills 一起显示：
| Skill | 作用 |
|---|---|
/automate | 创建由计划任务、Slack 消息、GitHub 事件等触发的 Cursor Automations |
/autopilot | 监控一个 PR，处理反馈、冲突、失败的检查和后续工作 |
/canvas | 创建与对话并排渲染的交互式 React 产物 |
/create-hook | 创建 Cursor hooks 并更新 hooks.json |
/create-rule | 创建带合适范围和指令的 Cursor 规则 |
/create-skill | 创建 Agent Skills，包括它们的结构和 SKILL.md 文件 |
/create-subagent | 创建有聚焦角色和委派指令的自定义子智能体 |
/cursor-blame | 调查 AI 编写的改动以及产生它们的提示 |
/loop | 按指定间隔重复运行提示或 skill |
/migrate-to-skills | 把符合条件的动态规则和斜杠命令转换为 Agent Skills |
/review | 选择并运行合适的代码评审智能体 |
/review-bugbot | 用 Bugbot 审查代码中可能的 bug 和回归 |
/review-security | 用 Security Review 审查代码的安全漏洞 |
/sdk | 帮你用 Cursor SDK 构建应用和集成 |
/shell | 把提供的文本作为字面 shell 命令运行 |
/split-to-prs | 把大的改动拆成较小的 PR |
/statusline | 配置 Cursor CLI 状态栏 |
/update-cli-config | 更新 ~/.cursor/cli-config.json 里的 Cursor CLI 设置 |
/update-cursor-settings | 查找并更新合适的 Cursor 或 VS Code 设置 |
skill 目录
skills 从这些位置自动加载：
| 位置 | 范围 |
|---|---|
.agents/skills/ | 项目级 |
.cursor/skills/ | 项目级 |
~/.agents/skills/ | 用户级（本机全局） |
~/.cursor/skills/ | 用户级（本机全局） |
~/.cursor/skills/ 里的用户级 skills 留在你机器上，直到你为云端智能体同步它们或发布给团队。Cursor 不会把 ~/.agents/skills/ 或未同步的本地 skills 复制到云端智能体、Agents Window 的远程 SSH 会话或自托管 worker；在自托管 worker 上，使用仓库里的项目 skills 或把 skills 烘焙进 worker 镜像。为了兼容，Cursor 还从 Claude 和 Codex 目录加载 skills：.claude/skills/、.codex/skills/、~/.claude/skills/ 和 ~/.codex/skills/。每个 skill 应该是含 SKILL.md 文件的文件夹：
.agents/
└── skills/
└── my-skill/
└── SKILL.mdskill 还可以包含可选的脚本、参考资料和资源目录：
.agents/
└── skills/
└── deploy-app/
├── SKILL.md
├── scripts/
│ ├── deploy.sh
│ └── validate.py
├── references/
│ └── REFERENCE.md
└── assets/
└── config-template.json嵌套 skill 目录：skill 目录可以组织成子目录，适合按类别、团队或领域对相关 skills 分组；Cursor 递归遍历 skills 根目录并拾取找到的任何 SKILL.md。Skills 的完整 frontmatter 字段、与云端智能体共享个人 skills、发布给团队等细节，以官方原文为准。