.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）
Cursor 品牌专题：.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）。 锚点：Cursor。
**## .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 档位（以官方/挂牌页当日数据为准）。
非法律意见声明：本文仅为技术操作指南，不构成任何法律或合同义务。
## 延伸阅读
English summary
Cursor's .cursor/skills/*/SKILL.md files provide reusable instruction modules for the AI coding Agent in Cursor IDE. These plain Markdown files enable custom workflows such as staging deployments or security audits without external plugins.
This guide covers who benefits (especially Cursor Pro and Business subscribers), the key concepts like SKILL.md and the skills folder, and a decision table comparing local setup, market plugins, and third-party MCP tools.
It includes a clear step-by-step checklist for adding and activating skills, plus common pitfalls to avoid. Related Cursor resources are linked for pricing, comparisons, and API details.
All recommendations are based on official Cursor documentation and are updated to current subscription structures.