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 的使用时机。

第三部分：Examples（示例）