先说结论
- 1想让所有项目都能用，就放进
~/.cursor/skills/（这也是唯一能同步到 Cloud Agents 的目录）；只给一个项目用，就放进.cursor/skills/。 - 2
SKILL.md里的name必须和文件夹名一致，而且只能用小写字母、数字和连字符。 - 3在 Customize → Skills 里能看到它。用
/skill-name运行，或者用@skill-name把它附到消息里。
Cursor 去哪里找 Skills
Cursor 除了查自己的目录和共用的 ~/.agents/skills/，还会查 Claude Code 和 Codex 的目录。如果你已经在用别的 Agent，那些 Skill 可能早就能在 Cursor 里用了。
| 文件夹 | 用途 |
|---|---|
~/.cursor/skills/ | 所有项目通用。唯一会同步到 Cloud Agents 的目录。 |
~/.agents/skills/ | 这台电脑上的所有项目。Skillry 装在这里，Codex 也读它。 |
.cursor/skills/ 或 .agents/skills/ | 单个项目，放在仓库任意位置都行。嵌套的目录只管它下面的文件。 |
.claude/skills/、.codex/skills/，以及 ~ 下的同名目录 | 为了让 Claude Code 和 Codex 的 Skills 在这里也能用。 |
怎么给 Cursor 添加 Skills
Skillry CLI 默认装到 ~/.agents/skills/，Cursor 会读这个目录，所以不用加参数。如果手动拷贝文件夹，就放进 ~/.cursor/skills/，以后要用 Cloud Agents，只有这个目录能同步过去。
- 1
打开 Skillry 上的 Skill 页面，点 复制安装提示词，再在弹窗里点 复制。
- 2
粘贴到 Cursor 里发出去。它会自己去读 Skillry 的安装说明，执行该跑的命令。
安装提示词 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
浏览器要你批准设备码时，点批准。
正常的话你会看到： Cursor 告诉你装好的版本号和所在目录，就在
~/.agents/skills/下面。
- 1
先登录一次。浏览器会打开一个页面，让你批准设备码。
终端 npx --yes skillry-cli@latest login - 2
直接安装，不用加参数。CLI 默认装到的目录，正好就是 Cursor 读取的目录。
终端 npx --yes skillry-cli@latest install <slug>正常的话你会看到：
Installed <slug> <version> to ~/.agents/skills/<slug>
在 Skill 页面点 下载 ZIP，或者用你从别处拿到的 Skill 文件夹。装之前先翻一遍 SKILL.md 和 scripts/，因为 Agent 会照着里面的说明做事，也可能运行那些脚本。看完再把整个文件夹移过去：
mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/skills/ZIP 解压后经常多套一层，变成 my-skill/my-skill/SKILL.md。SKILL.md 必须直接放在 Skill 文件夹里，否则 Agent 找不到。
Cursor 在启动时查找 Skills。装好后，新开一个对话或重新加载窗口，再到 Customize → Skills 的 Agent Decides 分组里找。
这条命名规则会让 Skill 消失
只有 SKILL.md 里的 name 和所在文件夹的名字完全一样，Cursor 才会加载这个 Skill。对不上时它不会报错，Skill 就是不出现。
它怎么不见了？
你下载了 launch-page，顺手把文件夹改名成 landing，结果它在 Cursor 里不见了。原因是文件夹名和 name 对不上了。把文件夹名改回去，或者把 name 也改成 landing。
Cursor 认的名字
- 只用小写字母、数字和连字符
- 和装着
SKILL.md的文件夹同名 - 同时写了
description
在 Cursor 里运行 Skill
在对话框里输入 / 和 Skill 名字，后面接你的需求：
/launch-page Parcelo，一个给小网店用的包裹追踪面板想让某个 Skill 整个会话都保持开启，在 / 菜单里选中它，按 Option+Enter（Mac）或 Alt+Enter（Windows），或者选 Use as Mode。它会变成一个 Custom Mode，直到你退出才关。
在 Cloud Agents 里使用 Skills
Cloud Agents 不在你的电脑上运行，只能拿到 Cursor 为它同步过去的 Skills。按下面三步设置：
- 1把 Skill 放在
~/.cursor/skills/。项目 Skill 和~/.agents/skills/里的 Skill 只留在本机。 - 2打开 Settings → Agents → Context and Tools，开启 Sync Skills for Cloud Agents。
- 3如果是想把个人 Skill 分享给团队，就在 Customize → Skills 里打开它，选 Publish。
Cursor rules 和 Skills 有什么区别
Cursor rules 是简短的指引，Cursor 会把它放进对话，要么始终生效，要么只对匹配的文件生效。Skill 是一套流程，Agent 只在任务用得上时才加载。约定类的东西写成 rule，多步骤的活写成 Skill。
用到时才调用的流程
- 带
SKILL.md的文件夹 - 相关时自动运行，或者用
/name调用 - 多步骤工作、脚本、模板
放进上下文的指引
.cursor/rules/里的.mdc文件（普通.md会被忽略）- Always Apply、Apply Intelligently、Apply to Specific Files 或 Apply Manually
- 简短的约定。Cursor 也会读
AGENTS.md和CLAUDE.md
想把旧 rules 迁过来？Cursor 内置的 /migrate-to-skills 能把“Apply Intelligently”类型的规则和斜杠命令转成 Skills。
Cursor Skill 没出现？试试这几步
先查名字。name 和文件夹对不上，是 Skill 在 Cursor 里消失最常见的原因。
Customize → Skills 里没有
检查 name 和文件夹是否一致，然后新开对话或重新加载窗口。
Cloud Agents 里没有
移到 ~/.cursor/skills/，并开启同步。
从来不会自动被选中
可能是描述和你的说法对不上，或者 paths 把它限定在了别的文件上。
常见问题
Cursor rules 和 Skills 有什么区别？
Rules 是 Cursor 加进对话的指引，可以始终生效，也可以只对匹配的文件生效。Skills 是装着一套流程的文件夹，Agent 在用得上或者你调用时才会用。
Cursor 能用 Claude 的 Skills 吗？
能。Cursor 会读 ~/.claude/skills/ 和 .claude/skills/，前提是每个 Skill 的 name 都和文件夹一致。
Cursor 的 Skills 存在哪里？
所有项目通用的，放在 ~/.cursor/skills/ 或 ~/.agents/skills/；单个项目的，放在 .cursor/skills/ 或 .agents/skills/。
Skills 能在 Cursor Cloud Agents 里用吗？
只有 ~/.cursor/skills/ 里的 Skills 能用，而且要先开启 Sync Skills for Cloud Agents。
参考来源
这篇对你有帮助吗？
