Cursor 自己写 Skill 完整教程
Cursor没有你想要的 Skill？自己写一个。Skill 的本质是一个说明文档，不需要写代码，会 Markdown 就够了。
Skill 的本质就是一个文件夹，里面放一个SKILL.md，告诉 OpenClaw「遇到什么情况、按什么步骤干活」。不需要写代码，不需要懂 API，会写 Markdown 就够了。复杂一点的 Skill 可以带脚本，但最小可用版本就是一个纯文本文件。
Skill 更像是给 AI 的一份操作说明书。你在SKILL.md里写清楚：什么时候用这个技能、用的时候按什么步骤走、输出什么格式。
文件结构：最小只需要一个文件
一个最简单的 Skill 长这样：
~/.openclaw/workspace/skills/ └── my-skill/ └── SKILL.md ← 这一个文件就够了复杂一点，带脚本和参考资料：
~/.openclaw/workspace/skills/ └── trend-scout/ ├── SKILL.md ← 核心：技能说明和工作流程 ├── scripts/ │ └── scan-trends.sh ← 辅助脚本（可选） └── references/ └── sources.md ← 参考资料（可选）放哪里？
存放位置
- 个人 Skill（
~/.cursor/skills/）：所有项目都能用 - 项目 Skill（
.cursor/skills/）：只对当前项目生效，可随仓库分享
SKILL.md 怎么写：三个部分
--- name: todo-manager description: 管理代办事项的 Skill，提供结构化 JSON 结果 --- # Todo Manager Skill 这里写你的具体操作逻辑和规则 ## Examples - 增加 ToDo: “添加任务 写报告 截止 2026-01-20” - 标记完成: “完成任务 写报告” - 列出未完成任务 ## Guidelines - 所有输出应尽量用 JSON - 不要包含无关文本一个标准的SKILL.md分三个部分：frontmatter、Instructions、Examples。
第一部分：frontmatter(元数据)（必须有）
--- name: trend-scout description: > 扫描 V2EX、Hacker News、GitHub Trending、少数派、小众软件， 发现适合博客的选题方向。 Use when: 用户要找新选题，或每 2 天定期触发。 NOT for: 分析已有流量数据（那个用 GSC/Bing 工具直接查）。 ---frontmatter 里最关键的是description。Cursor在决定「要不要用这个 Skill」的时候，主要靠这段描述判断。写清楚两件事：适合什么场景用，以及不适合什么场景。后者经常被忽略，但很重要——AI 不知道边界的话，会在不该用的时候用。
第二部分：Instructions（指令）
这部分用自然语言写就行，不需要代码。目的是让 AI 知道这个 Skill 的使用时机。