当前位置: 首页 > news >正文

cursor全局skills放置的目录

cursor全局skills放置的目录

Cursor 的全局 Skills(全局技能)应该放在用户主目录下的 ~/.cursor/skills/ 文件夹中。

具体路径说明

  • 全局(用户级,所有项目可用)
    ~/.cursor/skills/
    (Windows 上通常是 C:\Users\你的用户名\.cursor\skills\

  • 项目级(仅当前项目可用)
    在项目根目录下创建 .cursor/skills/.agents/skills/(两者都支持,.cursor/skills/ 是 Cursor 推荐的)。

Cursor 会自动从以下位置加载 Skills(按优先级/兼容性):

  • ~/.cursor/skills/(全局)
  • 项目下的 .cursor/skills/.agents/skills/
  • 兼容旧路径:~/.claude/skills/~/.codex/skills/、项目下的 .claude/skills/ 等。

如何正确放置一个全局 Skill

每个 Skill 必须是一个独立的文件夹,里面至少包含一个 SKILL.md 文件。

示例结构(全局):

~/.cursor/
└── skills/└── my-awesome-skill/          ← 技能文件夹名(随意取)└── SKILL.md               ← 必须的文件,里面写技能描述、指令、工作流等├── scripts/               ← 可选:放可执行脚本├── references/            ← 可选:参考文档└── assets/                ← 可选:资源文件
  1. 在终端或文件管理器中进入 ~/.cursor/(如果没有这个文件夹就新建)。
  2. 新建 skills 文件夹。
  3. skills 里新建一个技能专属文件夹(比如 frontend-best-practices)。
  4. 在该文件夹里创建 SKILL.md,写入你的技能内容(Markdown 格式,开头可以加 frontmatter 如 name、description)。

注意事项

  • 重启 Cursor 或刷新 Agent/Chat 后,全局 Skills 就能在 Composer / Agent 中被自动识别或通过 / 命令调用。
  • 推荐把通用、可复用的技能(如编码规范、部署流程、测试最佳实践等)放在全局 ~/.cursor/skills/
  • 项目特定的技能(如业务逻辑、特定架构要求)建议放在项目内的 .cursor/skills/,这样便于版本控制。
  • 每个技能文件夹必须有 SKILL.md,否则不会被识别。

示例

image

然后,cursor就可以看到新增加的个人全局skills了
image