Cursor Skills 与 .cursor 目录：SKILL.md 放哪、怎么被加载

仓库根目录出现 .cursor，或者有人丢来一个 Skill，这跟鼠标光标主题没关系。按 Agent Skills 官方文档 的说法，技能是带说明文件的小包装：教 Agent 怎么完成某一类专项工作，还能进版本库。

搜「cursor skills」或「.cursor」的人，常把规则、技能、普通配置目录混成一团。这篇只把技能目录和说明文件讲清楚，总览仍见 Rules / Skills / MCP。

会从哪些地方加载

文档列出的位置包括项目级与用户级的 skills 目录，例如项目下的 .cursor/skills 与 .agents/skills，以及用户目录中的对应路径；同时也兼容一部分其它工具的 skills 目录。每个技能一个文件夹，里面至少要有 SKILL.md，还可以附带脚本、参考资料和静态资源目录。

允许用子目录做分类，但技能身份以包含说明文件的那一层文件夹名为准。单体仓库里，子项目下的技能目录也可能被发现，并更偏向作用于那个子树。

说明文件里最少写什么

文件头部需要名称与描述。名称用小写、数字和连字符，并与文件夹名一致。描述要写清「做什么、何时用」，因为 Agent 就是靠它判断相不相关。你可以用路径模式限定它作用于哪些文件，也可以设成只在手动用斜杠命令调用时才注入，免得它自动来打扰。

在 Agent 对话里输入 / 就能搜技能。客户端侧栏的自定义/技能页面能看到已发现的项（文案以你版本为准）。文档还列了一批内置技能，比如创建技能、把旧规则迁成技能等等，完整名单以官方页为准。

和规则如何分工、如何落地

规则更像长期约束：风格、禁区、始终要记住的事。技能更像可调用的专项流程，必要时带着脚本。手上已经有一些动态规则或斜杠命令时，可以用文档提到的迁移技能帮忙转换，但不是所有规则都适合迁。

落地建议：先写一个最小的说明文件，手动调用一次确认它被加载了，再慢慢加脚本。别一上来就把整个社区技能库抄进仓库。从远程导入时走客户端给的流程，别随便执行不明来路的安装脚本。

.cursor 下还有规则、钩子这些东西，别把整个目录都当成技能。技能写得薄而清楚，比又长又空有用；写空了只会白占上下文。

和 Rules / MCP 的总览见 Rules、Skills、MCP；Agent 模式见 Agent 入门。