.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）
Cursor 品牌专题：.cursor/skills/*/SKILL.md 怎么进仓库（不是插件市场）。 锚点：Cursor。
**## 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 接入）属于非官方行为，风险自负。
站内路径：相关工具与页面
English summary
Cursor Skills is a lightweight system in the Cursor AI editor that lets you store reusable instruction sets as SKILL.md files in a local .cursor/skills folder. This method keeps everything under your control and works independently of the Cursor plugin marketplace. It is ideal for developers who want consistent rules across projects without relying on subscriptions or external extensions. To get started, create the folder, add your SKILL.md file, restart Cursor, and verify loading. The system complements project rules but remains fully local. Note that skill loading can fail if the file format is incorrect, so test thoroughly after changes. For official pricing and comparison details, refer to Cursor’s subscription pages. This approach helps engineers decide between local customization and marketplace options based on their workflow needs.