.cursor/skills/*/SKILL.md 怎么进仓库(不是插件市场)
Cursor 品牌专题:.cursor/skills/*/SKILL.md 怎么进仓库(不是插件市场)。 锚点:Cursor。
ガイド一覧 · 本文は主に簡体字中国語です。国際向けの要点は English summary をご利用ください。

**## .cursor/skills/*/SKILL.md 怎么进仓库(不是插件市场)**
Cursor 品牌专题:.cursor/skills/*/SKILL.md 怎么进仓库(不是插件市场)。这部分内容是 Cursor AI 编程工具中专门处理 Agent Skills 的地方,SKILL.md 文件是技能包的核心,包含 YAML 前置、参考资料和调用策略。通过 .cursor/skills/ 路径可以直接把本地或第三方技能添加到 Cursor 的 Agent 体系,而非去插件市场添加插件。普通用户主要用于定制自己的工作流,专业工程师则会通过 GitHub 等方式贡献共享技能。
这个方法适合有明确技能需求的用户,比如想快速集成特定编码规则或自动化任务的开发者。决策时建议优先测试官方内置技能,再考虑社区贡献;如果是企业级项目,建议结合 Cursor Business 订阅查看团队共享选项。
核心概念与术语
- SKILL.md:技能包主文件,包含 YAML 前置块、描述、调用策略和可选的脚本或参考。
- Agent Skills:Cursor 内置的 Agent 技能系统,支持自定义指令和自动化。
- Plugin Marketplace:Cursor 插件商店,存放的是扩展功能插件(如 VS Code 风格的工具),与技能包不同。
- Repository:这里特指 .cursor/skills/ 下的仓库目录,不是 GitHub 普通仓库。
决策表
| 适用场景 | 推荐方式 | 订阅/工具要求 | 进入难度 | 适用人群 |
|---|---|---|---|---|
| 个人快速测试 | 手动添加 SKILL.md 到本地 .cursor/skills/ | Cursor Pro 或以上 | 低 | 独立开发者、测试新技能 |
| 团队共享 | 通过 GitHub 仓库或 MCP 服务导入 | Cursor Business | 中 | 开发团队、需要统一规则的项目 |
| 第三方技能库 | 下载公开 SKILL.md 后添加 | Cursor Pro | 中 | 需要特定领域技能的用户 |
| 企业级集成 | Agent SDK + 官方 API 导入 | Cursor Business + 订阅 API | 高 | 大型企业、自定义 Agent 开发 |
数据来源以 Cursor 官方文档和用户实际体验为准,建议访问 Cursor 官方价格页 确认最新订阅方案。
实操清单:分步可核对
1. 打开你的本地项目,在根目录找到或创建 .cursor 文件夹(如果不存在)。
2. 进入 .cursor/skills/ 子目录,新建一个以你的技能名称命名的文件夹(例如 my-skill/)。
3. 在该文件夹下创建一个文件 SKILL.md,写入正确的 YAML 前置块和内容。
4. 保存文件后,在 Cursor 中重启项目或使用 Agent 重新加载技能(可通过命令面板触发)。
5. 测试技能效果:输入匹配的提示词,观察 Agent 是否按预期调用规则。
6. 如果需要共享,推送到 GitHub 仓库并记录贡献说明。
常见坑与风险边界
- 文件命名错误或 SKILL.md 格式不规范会导致加载失败。
- 技能包可能包含敏感指令或脚本,建议先在沙箱环境测试。
- 社区技能质量不一,容易引入不安全或过时规则。
- 订阅后功能可能需要升级,否则加载机制失效。
风险与边界:以上内容仅供参考,非法律意见。请根据自身情况评估,并以 Cursor 官方文档为准。
站内路径:相关工具与页面
English summary
Cursor Agent Skills are built around SKILL.md files placed in the .cursor/skills/ repository. These files define YAML metadata, instructions, and invocation rules for the Cursor AI coding agent. The process differs from the official Plugin Marketplace, which handles extensions instead of skills. Users create a local skills folder, add SKILL.md, and reload via Cursor. This method works for personal customization or GitHub-based sharing in teams. Always validate the skill format before testing in your project. Official Cursor documentation should be checked for the latest supported platforms and features. (6 sentences)