Cursor Skill 是一个 Markdown 文件(SKILL.md),
用来教 AI Agent 如何完成特定任务 — 比如按团队规范做 Code Review、
生成特定格式的报告、查询数据库 Schema,或任何你Repeatedly 需要的工作流。
把 Skill 上传到 GitHub 后,其他人只需把仓库克隆到本地 Skill 目录,
就能让 Cursor Agent 自动学会你的专属工作流。一次编写,全员复用。
Skill 文件结构
my-skill/
├── SKILL.md # 必需 — 主指令文件
├── reference.md # 可选 — 详细参考文档
├── examples.md # 可选 — 使用示例
└── scripts/ # 可选 — 辅助脚本
└── validate.py
SKILL.md 最小模板
---
name: my-skill-name
description: 简要描述 Skill 做什么、何时使用。Use when the user mentions XXX.
---
# My Skill Name
## 使用说明
1. 第一步做什么
2. 第二步做什么
3. 输出格式要求
## 示例
输入:用户说「帮我生成日报」
输出:按以下 HTML 模板生成...
完整创建流程(6 步)
-
确定 Skill 用途
想清楚要解决什么问题。例如:「每天自动生成 AI 热点 HTML 报告并部署到 GitHub Pages」。
-
创建 Skill 目录
个人 Skill(所有项目可用):~/.cursor/skills/my-skill/
项目 Skill(随仓库共享):.cursor/skills/my-skill/
-
编写 SKILL.md
必填 frontmatter:name(小写+连字符,最多 64 字符)和 description(第三人称,包含触发关键词)。正文写清晰的分步指令。
-
本地测试
在 Cursor 中对 Agent 说:「请读取 my-skill 并按其指令执行」。确认 Agent 能正确理解和遵循。
-
上传到 GitHub
创建公开仓库(如 yourname/cursor-skills),推送 Skill 文件夹。
-
分享给他人
他人在终端运行:
git clone https://github.com/yourname/cursor-skills.git ~/.cursor/skills/shared-skills
或在项目里:git submodule add ... .cursor/skills/shared-skills
Description 写法要点(决定 Agent 能否自动发现)
- 用第三人称写:「Generates daily AI reports」而非「I can help you...」
- 包含WHAT(做什么)和 WHEN(什么场景触发)
- 加入用户可能说的关键词,如「daily report」「HTML」「hot topics」
- 示例:
description: Generate daily AI programming hotspot HTML reports. Use when the user asks for today's AI news, daily report, or hotspot summary.
GitHub 分享仓库推荐结构
cursor-skills/ # GitHub 公开仓库
├── README.md # 说明有哪些 Skill、如何安装
├── ai-daily-report/ # Skill 1
│ └── SKILL.md
├── code-review/ # Skill 2
│ ├── SKILL.md
│ └── STANDARDS.md
└── deploy-github-pages/ # Skill 3
└── SKILL.md
README.md 安装说明模板(供分享用)
# Cursor Skills 合集
## 安装方式
### 方式 A:克隆到个人 Skill 目录(推荐)
git clone https://github.com/yourname/cursor-skills.git \
~/.cursor/skills/shared-skills
### 方式 B:只安装单个 Skill
cp -r ai-daily-report ~/.cursor/skills/
## 包含的 Skills
| Skill | 用途 |
|-------|------|
| ai-daily-report | 生成 AI 编程热点 HTML 日报 |
| code-review | 按团队规范做 Code Review |
💡 注意事项:
不要创建 Skill 到 ~/.cursor/skills-cursor/(Cursor 内置目录);
SKILL.md 建议控制在 500 行以内;避免写时间敏感内容(如「2026年8月前用旧 API」);
路径统一用 Unix 风格(scripts/helper.py 而非反斜杠)。