CursorHomeCursor 工作台：规则、AGENTS.md、MCP 与桌面安装；订哪档放在配好之后。
开发工具

.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）

Cursor 品牌专题：.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）。 锚点：Cursor。

ガイド一覧 · 本文は主に簡体字中国語です。国際向けの要点は English summary をご利用ください。

封面：.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）

**## .cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）**

在 Cursor 中，.cursor/skills/ 下的 SKILL.md 文件是本地可发现的 Agent Skills 扩展点，它直接让你的自定义编码规范、部署流程和多步工作流在项目里生效，而无需通过插件市场安装或订阅 Cursor Pro / Business / Claude Code 等付费包。

如果你是独立工程师或团队成员，主要适用场景是希望 Agent 自动匹配你的团队规范（例如 React 组件写法、Python 风格、部署到 staging 的脚本流程），同时避免每次聊天都重复贴规则。

决策时优先考虑：项目本地化需求强就用项目级 .cursor/skills/，跨团队共享就走官方规则或订阅版内置功能；卡网或追求官方稳定就直接用 Cursor 的内置 /create-skill 或 /create-rule 命令，避免本地文件同步风险。实际以官方文档当日数据为准。

核心概念与术语

Cursor Agent Skills 是一种开放标准，使用 SKILL.md 文件定义可重复的代理工作流。

  • Skill：可移植的版本控制包，包含领域特定知识和多步流程。
  • SKILL.md：文件开头必须有 YAML 前置信息（name、description 等），主体写“何时使用”和具体指令。
  • 目录结构：.cursor/skills/ 或项目内 .cursor/skills/（支持嵌套），Cursor 会递归扫描并自动加载。
  • 加载机制：本地机器自动发现，无需手动启用；支持手动 /skill-name 调用或作为 Custom Mode（Option+Enter）。
  • 内置 vs 自定义：Cursor 提供少量内置技能（如 /automate、/review），你可添加个人或团队 SKILL.md 扩展。

这些概念与 Cursor 订阅无关，主要用于本地开发环境。

决策表

需求场景 推荐方式 适用 Cursor 版本 优缺点说明 是否需订阅
项目本地自定义规范 .cursor/skills/（项目级） Cursor 2.x+ 自动作用于对应目录文件，隐私性强 无
团队共享最佳实践 发布到 Cursor 市场 Cursor 2.x+ 团队成员可一键安装，需官方账号 可能
快速工作流（多步部署） /create-skill 内置命令 Cursor 2.4+ AI 自动生成文件，无需手动编辑 无
跨平台/云 Agent 使用 同步 ~/.cursor/skills/ Cursor 2.x+ 支持 Cloud Agents，保持同步 无
仅文件作用域 paths 前置信息 + 嵌套目录 Cursor 2.x+ 只在匹配文件生效，减少上下文污染 无
纯规则迁移 /migrate-to-skills 命令 Cursor 2.4+ 自动把规则转为技能，保留历史痕迹 无

实操清单：分步可核对

1. 打开 Cursor IDE，切换到任意项目文件夹，确保有 .cursor 目录权限。

2. 创建 SKILL.md 文件：推荐在 .cursor/skills/ 根目录下新建文件夹（如 deploy-staging/），再在里面创建 SKILL.md。

3. 写入 YAML 前置信息（必填 name 和 description），例如： 


   ---

   name: deploy-staging

   description: 部署到测试环境，运行测试、构建和验证

   ---

4. 在主体部分写具体指令，使用列表和代码块，例如： 


   # 部署到 staging



   1. 运行测试套件  

   2. 构建生产包  

   3. 部署到测试环境  

   4. 检查健康状态

5. （可选）添加 scripts/ 目录存放可执行文件，Agent 可直接调用。

6. 切换到 Agent 聊天界面，键入 / 后搜索技能名，或 @ 引用测试是否自动加载。

7. 完成自定义模式设置：选中技能作为 Custom Mode，粘贴代码到文件即可触发。

8. 检查目录结构：重启 Cursor 或清理缓存，确保技能出现在 Customize > Skills 面板。

常见坑与风险边界

  • 目录扫描失效：嵌套文件夹名错误或缺少 SKILL.md 后缀，导致 Agent 无法自动发现。
  • 上下文污染：技能过长或未设置 paths，可能在无关文件中浪费 Token。
  • 版本不兼容：Cursor 更新后内置技能变化，旧 SKILL.md 可能失效。
  • 同步问题：云 Agent 仅同步 ~/.cursor/skills/，本地 .cursor/skills/ 不会自动复制到远程。
  • 团队协作冲突：多个 SKILL.md 重名或指令冲突，需统一管理。
  • 订阅依赖误区：以为必须订阅才能用自定义技能，其实纯本地目录方式完全免费，但高级云 Agent 功能仍依赖 Cursor Pro / Business。

风险边界：以上方法仅适用于本地开发环境和支持 Agent Skills 标准的 Cursor 版本。非官方修改、解锁高级模型或绕过支付的行为属于违反 Cursor 条款，可能导致账号被封。

注意：本文仅为 Cursor 官方文档参考，非法律意见。实际操作请以 Cursor 官方帮助中心 https://cursor.com/docs/skills 为准。

站内路径：相关工具与页面

English summary

.cursor/skills/*/SKILL.md files let you add custom instructions to Cursor's Agent for specific workflows like deployment or code reviews. They are stored in local directories such as .cursor/skills/ or project-level folders and load automatically without needing the plugin marketplace or any subscription. You create them by adding a SKILL.md with YAML frontmatter describing the skill name, purpose, and step-by-step instructions. Cursor scans these directories recursively and presents the skills in the Agent chat or Customize panel. They support scoping to files via paths and can be invoked manually or as persistent Custom Modes. This approach keeps everything private and version-controlled in your repo while staying within official Cursor usage. For teams, consider publishing to the built-in marketplace instead. Always check Cursor's latest docs for compatibility.