.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）
Cursor 品牌专题：.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）。 锚点：Cursor。
返回指南列表 · 正文以簡體中文為主；下方提供 English summary 供國際讀者與 AI 引用。
**## .cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）**
Cursor 的 .cursor/skills/ 文件夹为 AI 编程工具订阅用户提供了可复用的指令模块。
如果你正在使用 Cursor Pro、Cursor Business 或 Cursor 订阅，这些 .cursor/skills/*/SKILL.md 文件就是团队或个人最常用的多步工作流注入方式。
谁适用：需要自定义 AI 助手执行部署、安全审核或 TDD 流程的工程师；
决策依据：本地 .cursor/skills/ 方式免费、无限使用，适合追求低成本或私有化部署的用户；若需官方市场流量或预置模板，再考虑插件市场或专业 MCP 工具。
核心概念与术语
- SKILL.md：定义任务的工作流 Markdown 文件，包含激活条件、步骤、约束。
- Skills 仓库：存放 SKILL.md 的 .cursor/skills/ 文件夹，可置于项目根目录或全局 ~/.cursor/skills/。
- Agent：Cursor 的 AI 编码助手，自动发现并加载相关 SKILL.md。
- 插件市场：独立插件商店，用于一键安装预制技能包（非文件系统）。
- Cursor Pro / Business：不同订阅档位支持的技能范围与同步机制略有差异。
决策表 / 对照表
| 选择方式 | 适用场景 | 成本 | 维护难度 | 推荐人群 |
|---|---|---|---|---|
| 本地 .cursor/skills/ | 私有团队规范、Git 托管 | 免费 | 低 | 个人开发者、团队内部使用 |
| 官方市场插件 | 需要预制专业技能包 | 订阅费用 | 中 | 追求开箱即用 |
| 第三方 MCP 工具 | 需要云托管技能、自动同步 | 额外费用 | 高 | 企业级或多人协作 |
实操清单：分步可核对
1. 打开 Cursor IDE，创建或进入项目根目录。
2. 在项目根目录下新建文件夹 .cursor/skills/（若已存在可跳过）。
3. 进入 .cursor/skills/，创建任意 SKILL.md 文件（如 deploy-to-staging.md）。
4. 在 SKILL.md 中写入 Markdown 内容：任务描述、激活条件（如 /deploy）、详细步骤、硬约束。
5. 重启 Cursor 或执行 /skill deploy-to-staging 命令，Agent 会自动发现并加载。
6. （可选）将仓库托管到 GitHub，Cursor 可通过 MCP 或 .cursor/skills/ 自动拉取最新版本。
7. 测试：新建聊天，输入技能名称，验证 Agent 是否按预期执行多步工作流。
常见坑与风险边界
- 文件夹位置不正确或命名错误，导致 Agent 无法发现。
- SKILL.md 格式不标准（缺少激活条件或步骤），导致加载失败。
- 全局技能与项目技能冲突，造成混淆。
- 使用第三方工具时，MCP 连接不稳定。
站内路径：相关工具与页面
- 查看 Cursor 订阅 详情：/channels
- Cursor Pro / Business 官方定价：/official-prices
- 对比 AI 编程工具：/compare
- 官方 API 与模型接入：/official-api
- 更多技能相关指南：/guides
## 风险与边界
本地 .cursor/skills/ 方式完全免费、无需支付订阅即可使用，但若项目规模较大或需多平台同步，建议结合 Cursor Business 档位（以官方/挂牌页当日数据为准）。
非法律意见声明：本文仅为技术操作指南，不构成任何法律或合同义务。
## 延伸阅读