教程依据所列 Cursor 官方文档；截至核验时文档确认原生 Agent Skills，但未说明该功能最低 Cursor 版本。Cursor 兼容部分 Claude/Codex 技能目录，不代表所有其他平台技能都兼容。MCP 是连接外部工具和数据源的协议，不等同于 Skill。Skills-SI 每个技能包的下载地址、许可证及依赖应逐项核实；本次未下载或安装任何包，也未登录或实机验证。用户级未同步技能仅本机可用；官方文档未给手动复制技能单独的卸载菜单。
준비
- 已安装 Cursor 桌面端并打开目标项目；官方快速入门列出 macOS 12+、Windows 10+ 及 Linux 安装方式。
- 准备从 Skills-SI 市场卡片进入实际 HTTPS 下载入口；确认作者、许可证和技能适用范围。
- 安装前检查下载包中的 SKILL.md、附属资源及脚本；技能可能要求额外运行环境或依赖，不要放入密钥或敏感资料。
설치 및 사용 단계
- 01
准备 Cursor 与目标项目
从 Cursor 官方下载页获取桌面端，按官方快速入门安装并打开一个测试项目。官方文档确认当前支持 Agent Skills；没有公布技能功能的最低版本号，若界面不同先核对当前版本，不要猜测菜单。
근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 02
从本站安全获取技能包
在 Skills-SI 对应技能卡片打开实际下载入口，核对作者、许可证、来源仓库和包内文件。下载完整 ZIP；先检查文件清单与脚本内容，不运行来源不明的代码。具体下载按钮及技能包链接因条目而异，本指南不虚构路径。
근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 03
解压并确认完整目录
解压后找到包含 SKILL.md 的技能根文件夹。保留该文件夹中的 scripts、references、assets 等随包资源，不要只复制 SKILL.md。Cursor 文档要求技能以含 SKILL.md 的文件夹组织；name 应与该文件夹名一致。检查 frontmatter 的 name、description 是否完整。
근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 04
安装到合适范围
将整个技能文件夹放在项目级 `.cursor/skills/<skill-name>/`，仅供该项目使用；或放在用户级 `~/.cursor/skills/<skill-name>/`，供本机使用。Cursor 也支持 `.agents/skills/` 与若干 Claude/Codex 技能目录。官方说明会在启动时发现技能。无需把 MCP 配置当作 Skills 安装。
项目级：.cursor/skills/<skill-name>/；用户级：~/.cursor/skills/<skill-name>/근거와 출처项目级：.cursor/skills/<skill-name>/；用户级：~/.cursor/skills/<skill-name>/작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 05
在 Agent 中调用并做首次练习
在 Agent 对话框输入 `/` 并搜索技能名，或直接输入 `/skill-name`；文档也支持用 `@` 选择技能作为上下文。做一个虚构会议纪要转行动清单的小练习，要求列出事项、负责人占位符和期限占位符，不提供真实客户资料或密钥。
/skill-name근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 06
验证发现与输出
在 Cursor 侧栏 Customize → Skills 查看项目或个人技能是否已发现，再显式调用一次。核对输出是否遵守技能说明，并人工复核内容。技能也可能按上下文自动使用；未自动触发时应显式调用，不能据此认定安装失败。
근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 07
移除本指南手动安装的技能
关闭 Cursor 后，将本次复制的整个技能文件夹从对应技能目录移走或删除，再启动 Cursor 并检查 Customize → Skills。项目级只影响该项目；用户级影响本机使用者。此步骤适用于手动复制安装；插件市场分发的技能应按其插件管理方式处理。
删除对应目录中的 <skill-name> 文件夹；例如项目级 .cursor/skills/<skill-name>/근거와 출처删除对应目录中的 <skill-name> 文件夹；例如项目级 .cursor/skills/<skill-name>/작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다.
연습 및 검수
用虚构的三条会议记录测试技能，将其整理成行动项清单：任务、负责人（用虚构姓名或占位符）、期限和待确认项；检查是否保留原意且没有臆造。
- 在 Customize → Skills 查看技能是否出现。
- 在 Agent 中通过 `/skill-name` 显式调用，并确认回答体现技能内容。
- 核对技能目录仍包含 SKILL.md 和所需随包资源；检查输出是否符合练习要求。
비활성화 및 삭제
- 记录技能安装范围。
- 关闭 Cursor 后，从对应的项目级或用户级技能目录移走/删除整个技能文件夹。
- 重新启动 Cursor，在 Customize → Skills 检查本地技能不再出现；若来自插件而非手动复制，改按插件管理方式移除。
문제 해결
Customize → Skills 中看不到技能。
确认复制的是完整技能文件夹且其中存在 SKILL.md，并确认放在文档支持的目录；检查目录名与 frontmatter 的 name 一致，再重启 Cursor 检查。
技能没有自动触发。
在 Agent 输入 `/` 搜索技能名，或直接使用 `/skill-name`；官方说明默认由 Agent 判断相关性，自动触发并非必然。
调用后内容不完整或找不到参考文件。
重新核对是否只复制了 SKILL.md；恢复该技能包的 references、assets 等必要目录，并检查技能正文所引用的相对路径。
技能脚本无法运行。
查看 SKILL.md 和脚本说明确认运行时、依赖及相对路径；只从可信来源使用并先审阅脚本，不要关闭安全防护。
远程 Agent 或 SSH 会话看不到个人技能。
官方说明未同步的本机技能不会复制到 Cloud Agents、远程 SSH 或自托管 worker；仅 `~/.cursor/skills/` 可按设置同步至 Cloud Agents，项目技能需在仓库中，且团队管理员可能限制同步。
근거와 출처
- https://cursor.com/docs/skills
官方 Agent Skills 说明：自动发现、目录与项目/用户范围、完整技能文件夹结构、手动调用、兼容目录、远程同步限制。
- https://cursor.com/help/customization/skills
官方 Skills 帮助：创建位置、支持目录、Customize → Skills、用 / 或 @ 调用及迁移说明。
- https://cursor.com/docs/get-started/quickstart
官方快速入门：桌面端系统支持、安装与打开项目后的基本流程。
- https://cursor.com/docs/mcp
官方 MCP 文档：MCP 用于连接外部工具和数据源，具有独立配置与管理机制，故不能与 Skills 混为一谈。