.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）
Cursor 品牌专题：.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）。 锚点：Cursor。
All guides · Full article is primarily Simplified Chinese; use the English summary below for quick takeaways (GEO-friendly).
**## Cursor 视角：.cursor/skills/*/SKILL.md 进仓库不走插件市场**
Cursor 品牌专题：**.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）。这是一篇专为开发者准备的实用指南，核心结论是：如果你想在 Cursor 中添加个人或团队自定义技能定义（SKILL.md 文件），最直接的方式就是把文件放在本地 .cursor/skills 文件夹下，然后重启 Cursor 或让 Agent 自动扫描**。这与 Cursor 官方插件市场完全无关，后者是安装 Cursor 扩展插件的通道。
适合人群：
- 已经订阅 Cursor Pro 或 Cursor Business 的开发者
- 需要在多项目间复用通用代码规范、Agent 行为规则或自定义指令集的人
- 想避免插件市场搜索到的「社区扩展」干扰日常编码流程的工程师
决策依据：
- 使用本地
.cursor/skills适合需要完全控制规则、不想每次都重装插件的场景。 - 如果只是偶尔测试新技能，优先看 Cursor 插件市场，但注意风险边界。
- 以官方/挂牌页当日数据为准（2026 年 9 月）。
核心概念与术语
Cursor 内置的技能系统是其 Agent 上下文管理的一部分：
- SKILL.md：每个技能文件夹内的核心文件，必须包含指令、示例和上下文定义。
- .cursor/skills/：Cursor 项目根目录下的隐藏文件夹（
.开头）。 - Skills：可加载的指令包，Cursor Agent 会按需加载到提示上下文中。
- Rules（项目规则）：另一种持久上下文配置，与 Skills 功能互补，但规则通常在项目设置里管理。
- Agent：Cursor 的核心 AI 编码助手，受 SKILL.md 定义影响。
这些概念直接服务于 Cursor 订阅 带来的高效编码体验，无需额外扩展。
决策表：本地仓库 vs 插件市场
| 维度 | 进 .cursor/skills/ 仓库 | 进插件市场（Cursor 社区插件） |
|---|---|---|
| 适用场景 | 个人/团队长期规则复用 | 想集成新语言支持或外部工具扩展 |
| 控制权 | 完全本地，可随时修改 | 通过 Cursor 官网审核，可能被移除 |
| 订阅依赖 | 不需要 Cursor Pro | 需要 Cursor Pro 或 Business 才能用 |
| 风险边界 | 本地文件不兼容时需手动排查 | 插件被禁用时可能丢技能 |
| 推荐人群 | 希望「一键复用技能」的开发者 | 追求新功能集成的人 |
移动端横向滚动友好，表格列数适中。
实操清单：分步可核对
1. 准备项目根目录
在你正在编辑的 Cursor 项目文件夹下创建隐藏文件夹 .cursor/skills/（使用终端 mkdir .cursor/skills 或文件管理器直接建）。
2. 创建 SKILL.md 文件
进入 .cursor/skills/ 目录，新建 my-custom-skill/SKILL.md 文件，写入清晰的指令（示例参考官方文档风格）。
3. 重启 Cursor
完全关闭并重新打开 Cursor（或按 Ctrl+Shift+P 输入 “Restart” 重启），让 Agent 扫描文件夹。
4. 验证加载
新建一个聊天窗口，输入 @Skill 或相关提示，检查是否自动加载自定义规则。
5. 团队共享（可选）
把 .cursor/skills 文件夹同步到 Git（推荐），团队成员克隆项目后同样生效。
6. 调试与优化
编辑 SKILL.md 后重启测试，或使用 Cursor 的搜索功能定位加载日志。
7. 退出本地模式（可选）
如果以后想移除，删除文件夹并重启即可。
常见坑与风险边界
- 文件加载失败：SKILL.md 格式错误或缺少必要字段，Cursor Agent 不会加载，需检查语法。
- 权限问题：Windows/macOS 下隐藏文件夹有时被误删，建议用终端操作。
- 性能影响：过多 SKILL.md 文件可能让 Agent 上下文变大，建议只保留常用技能。
- 与插件冲突：如果同时启用 Cursor 插件市场扩展，可能导致规则重复或冲突。
风险边界：这些是 Cursor 官方支持的本地配置范围，不涉及任何 IDE 修改器、账号切换或注入操作。超出边界（如把 IDE 席位改造成 API 接入）属于非官方行为，风险自负。