Menu
简短说明：这个技能做什么、什么时候用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| title | Skill 使用介绍（Cursor / Codex Agent Skills） |
| tags | ["AI","Agent","Skill"] |
Agent Skills 是一套开放标准，用于为 AI 代理扩展领域能力。本文介绍在 Cursor、Codex 等环境中如何发现、安装、使用和自建 Skill。参考 Cursor 官方文档 与 Agent Skills 开放标准。内容与示例基于 Cursor 2.x 及开放生态（2025–2026 主流实践），Cursor 2.0+ 起完整支持 Agent Skills。
适用读者：已在使用 Cursor、Codex 或支持 Agent Skills 的 IDE/平台，希望为 Agent 增加可复用流程与规范的开发者或进阶用户。
Skill（技能） 是一个可移植、可版本控制的「能力包」，用来教 Agent 如何完成某一类具体任务。它可以包含：
SKILL.md 里写清何时用、怎么用、步骤与规范references/、assets/ 中，按需加载与 MCP（模型上下文协议） 的定位不同：MCP 定义的是「模型如何连接外部工具/数据源」的协议与接口；Skill 定义的是「在何种场景下、按何种步骤、使用何种脚本或规范」完成任务。二者互补：MCP 提供「能力通道」，Skill 提供「使用规范与流程」。
| 特点 | 说明 |
|---|---|
| 可移植 | 支持 Agent Skills 标准的任何代理都能用同一套 Skill |
| 可版本控制 | 以文件形式存在，可放进 Git 仓库或通过 GitHub 安装 |
| 可执行 | 可包含脚本、模板，Agent 能按说明调用工具执行 |
| 按需加载 | 资源渐进加载，有利于控制上下文长度 |
Cursor / Codex 会在以下目录自动发现 Skill（每个 Skill 是一个文件夹，且内含 SKILL.md）：
| 路径 | 作用域 |
|---|---|
.cursor/skills/ | 当前项目 |
.codex/skills/ | 当前项目（Codex 兼容） |
.claude/skills/ | 当前项目（Claude 兼容） |
~/.cursor/skills/ | 用户全局 |
~/.codex/skills/ | 用户全局 |
~/.claude/skills/ | 用户全局 |
Agent 启动时会扫描这些目录，根据当前对话上下文自动判断是否启用某个 Skill；你也可以在对话里手动调用（见下文）。
/，会弹出可用的 Skill 列表，搜索并选择即可。/skill-name 或 $skill-name 直接指定要用的技能（视具体产品而定）。Cmd+Shift+J，Windows/Linux：Ctrl+Shift+J）Agent Skills 开放生态 提供用命令行管理 Skill 的方式：
# 按关键词搜索 Skill
npx skills find [关键词]
# 安装整个技能库或指定技能（二选一）
npx skills add vercel-labs/agent-skills -g -y
npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices -g -y
# 检查/更新已安装 Skill
npx skills check
npx skills update
# 列出已安装技能
npx skills list
-g 表示装到用户目录（全局），-y 表示跳过确认。也可用 --skill <名称> 只安装仓库中的某一个技能。该 CLI 支持 Cursor、Codex、Claude Code 等 30+ 种 Agent；若不想上报匿名使用统计，可设置环境变量 DISABLE_TELEMETRY=1。安装后一般需要重启 Cursor/Codex 才能识别新 Skill。
SKILL.md 的 Skill 文件夹复制到上面任一「Skill 目录」即可，例如：
<项目根>/.cursor/skills/my-skill/~/.cursor/skills/my-skill/ 或 ~/.codex/skills/my-skill/每个 Skill 必须有一个 SKILL.md，且带有 YAML 前置元数据。
---
name: my-skill
description: 简短说明：这个技能做什么、什么时候用。
---
# My Skill
给 Agent 看的详细说明。
## When to Use
- 当用户需要……时使用
- 适合用来……
## Instructions
- 步骤一
- 步骤二
- 若需和用户确认，可使用提问类工具
| 字段 | 必填 | 说明 |
|---|---|---|
name | 是 | 技能标识，必须仅含小写字母、数字与连字符，且必须与所在文件夹名一致（否则可能无法被正确识别） |
description | 是 | 一句话说明用途与适用场景，供 Agent 判断是否采用 |
license | 否 | 许可证名称或引用 |
compatibility | 否 | 环境要求（如系统依赖、网络等） |
disable-model-invocation | 否 | 设为 true 时，只有用户显式输入 /skill-name 时才会加入上下文，不会自动被 Agent 选用 |
若希望某个 Skill 像传统「斜杠命令」一样，仅在被明确输入时才生效，在 frontmatter 里加上：
disable-model-invocation: true
除了 SKILL.md，还可以在同一个 Skill 目录下增加可选子目录：
| 目录 | 用途 |
|---|---|
scripts/ | 可执行脚本（如 deploy.sh、validate.py），在 SKILL.md 里用相对路径引用 |
references/ | 补充文档，按需被 Agent 加载 |
assets/ | 静态资源（模板、配置、图片等） |
示例结构：
.cursor/skills/deploy-app/
├── SKILL.md
├── scripts/
│ ├── deploy.sh
│ └── validate.py
├── references/
│ └── REFERENCE.md
└── assets/
└── config-template.json
在 SKILL.md 里用相对路径说明如何调用脚本，例如：
## Usage
运行部署脚本：`scripts/deploy.sh <环境>`，其中 `<环境>` 为 staging 或 production。
部署前请先执行校验：`python scripts/validate.py`
Agent 会按你的说明在合适时机执行这些脚本。
自 Cursor 2.4 起引入 Agent Skills；若你之前用 Cursor 的「动态规则」（.cursor/rules/*.mdc）或「斜杠命令」（.cursor/commands/*.md），可用内置迁移能力转成 Skill：
/migrate-to-skills.cursor/skills/ 下生成对应 Skilldisable-model-invocation: true 的 Skill，保持「仅手动调用」的行为迁移完成后检查 .cursor/skills/ 里的内容，按需微调 SKILL.md。
description 是否清晰描述了适用场景，便于模型做相关性判断；或改用 disable-model-invocation: true 后通过 /skill-name 手动调用。scripts/ 下文件有执行权限，且 SKILL.md 中引用的路径为相对路径、与目录结构一致。npx skills find/add/list 等）.curated 等，可用 skill-installer 类 Skill 或文档说明的方式安装.cursor/skills/ 或 ~/.codex/skills/ 等目录后，可被自动选用，或在对话里用 / + 技能名手动调用。npx skills add、或直接复制 Skill 文件夹到上述目录。SKILL.md（必含 name、description），需要时可加 scripts/、references/、assets/。把 Skill 和 MCP、RAG 一起用：MCP 负责「连工具」，RAG 负责「查知识」，Skill 负责「定流程与规范」，三者结合能更稳定、可复现地用好 AI 代理。
延伸阅读：What is MCP（协议与工具连接）、RAG 技术（知识增强）、AI Agent 入门（Agent 组成与实战）。