在 Cursor 中，Skill 是一种用于扩展 AI 行为能力的配置单元，本质上是目录 + SKILL.md 文件。下面整理几种常见安装与使用方式。

---

一、本地文件方式（推荐）

Skill 的标准加载方式是：

一个目录 + 目录内必须包含 SKILL.md

---

1. 个人全局 Skill（所有项目可用）

没有这个skills目录自己创建一个,把自己的skill放进去即可

适用于你希望在所有项目中复用的 Skill。

存放路径：

~/.cursor/skills/<skill-name>/SKILL.md

示例结构：

~/.cursor/skills/
  eladmin-fullstack-dev/
    SKILL.md

---

2. 项目级 Skill（当前仓库共享）

这种就是只能这个项目使用

适用于团队项目或单个仓库内复用。

存放路径：

<your-repo>/.cursor/skills/<skill-name>/SKILL.md

示例结构：

your-repo/
  .cursor/
    skills/
      eladmin-fullstack-dev/
        SKILL.md

---

⚠️ 重要约束

• Skill 目录内 **必须包含 ****SKILL.md**
• 不要放在：

~/.cursor/skills-cursor/

该目录属于 Cursor 内置系统使用

• 推荐保持目录命名清晰且唯一

---

二、团队共享（通过 Git 管理）

如果希望团队统一使用 Skill：

做法：

1. 将 Skill 放入项目目录：

.cursor/skills/

2. 提交到 Git 仓库

---

优点

• 团队成员 clone 后即可使用
• Skill 版本统一
• 避免环境差异问题

---

三、从已有 Skill 迁移

适用于复用他人或历史项目 Skill。

步骤：

1. 找到 Skill 目录结构：

<skill-name>/SKILL.md

2. 复制到目标位置：

• 个人使用：

~/.cursor/skills/

• 项目使用：

<repo>/.cursor/skills/

3. 检查：
   • name 是否冲突
   • 结构是否完整

---

四、通过 Cursor UI 导入（视版本而定）

部分 Cursor 版本支持 UI 操作：

常见方式：

• 导入 Skill：选择目录或 SKILL.md
• 创建 Skill：自动生成目录结构
• 编辑 Skill：在界面内修改配置

⚠️ 具体入口随版本变化，以实际 UI 为准

---

五、安装完成后的验证方式

可以通过以下方式确认 Skill 是否生效：

1. UI 检查

• 在 Cursor Skill 列表中是否出现

2. 对话中调用

• 显式引用 Skill 名称进行触发

---

六、常见问题排查

如果 Skill 不生效，优先检查：

• SKILL.md 是否存在
• 路径是否正确（全局 / 项目）
• YAML 是否正确（通常需要 frontmatter）：

---
name: xxx
---

---

七、多个 Skill 的行为机制

1. 可以同时安装多个 Skill 吗？

可以，每个 Skill 是独立目录。

---

2. 会同时生效吗？

取决于 Skill 配置：

disable-model-invocation

disable-model-invocation: true

行为理解：

• 设置为 true
  • ❌ 不会自动触发
  • ✔️ 需要手动调用
• 未设置或为 false
  • ✔️ 可能自动匹配触发
  • ✔️ 多 Skill 可能同时参与

---

3. 如何只使用一个 Skill？

推荐做法：

方法一：限制自动触发

disable-model-invocation: true

用于关闭不希望自动生效的 Skill。

方法二：显式调用

在对话中明确指定 Skill 名称，只启用目标 Skill。

---

总结

Cursor Skill 的核心原则：

目录结构 + SKILL.md + 正确放置路径

推荐实践：

• 个人用：~/.cursor/skills/
• 团队用：.cursor/skills/
• 控制行为：disable-model-invocation