Cursor 必备神器：Skills 技能安装完整教程

Cursor 必备神器：Skills（Agent Skills）安装与使用完整教程（2026 最新版）

Agent Skills 是 Cursor 中最强大的自定义功能之一。它能让 AI Agent 掌握特定领域的工作流、模板和最佳实践，按需动态调用，显著提升开发效率。

Skills 采用开放标准，兼容 Claude、Cursor 等工具。

1. Skills 核心概念

• Rules（.cursorrules）：始终生效的规则（如编码规范、架构要求）。
• Skills（SKILL.md）：按需调用的能力包（如代码审查、部署流程、特定框架脚手架）。
• Skills 通过 /skill-name 或 Agent 智能判断触发。

推荐目录结构（Cursor 自动识别）：

项目根目录/
├── .cursor/
│   └── skills/
│       └── my-skill-name/     # 每个技能一个文件夹
│           └── SKILL.md
├── .agents/skills/            # 兼容旧版
└── ~/.cursor/skills/          # 全局技能（所有项目生效）

2. 安装 Skills 的三种方式

方式一：手动创建/安装（推荐，最灵活）

1. 在项目中创建目录：

   mkdir -p .cursor/skills/my-awesome-skill

2. 在文件夹内创建 SKILL.md 文件，写入以下结构：

---
name: "Code Reviewer Pro"
description: "专业的代码审查技能，检查 bug、安全问题、性能和规范"
version: "1.0"
tags: ["review", "quality", "security"]
---

# Instructions
你现在是高级代码审查专家。请严格按照以下步骤审查代码：

1. 检查潜在 bug 和逻辑错误
2. 评估安全性风险（注入、权限等）
3. 分析性能瓶颈
4. 验证是否符合项目编码规范
5. 给出具体改进建议和代码示例

# Examples
**输入**：一段有内存泄漏的代码
**输出**：详细审查报告 + 修复代码

# Templates
代码审查报告模板：
- 严重问题：
- 中等问题：
- 优化建议：

3. 保存后，按 Cmd/Ctrl + Shift + P 输入 “Reload Skills” 或重启 Cursor 即可加载。

方式二：从 GitHub 一键安装（最方便）

Cursor 原生支持远程 GitHub 规则（含 Skills）：

1. 打开 Cursor Settings（Cmd/Ctrl + ,）
2. 进入 Rules
3. 点击 Add Rule → 选择 Remote Rule (Github)
4. 输入 GitHub 仓库 URL（如 https://github.com/username/awesome-cursor-skills）

或者使用社区工具（如 openskills、add-skill）批量安装。

方式三：使用命令行工具批量安装

# 安装 openskills（全局一次）
npm install -g openskills

# 安装 Anthropic 官方 Skills
openskills install anthropics/skills

# 安装到全局
openskills install anthropics/skills --global

其他优秀仓库推荐：

• spencerpauly/awesome-cursor-skills
• 搜索 GitHub “awesome cursor skills”

3. 如何使用 Skills

• 在 Chat / Composer / Agent 中输入 /skill-name 手动触发。
• 让 Agent 智能判断：描述任务时，Agent 会根据 description 自动选择合适 Skills。
• 查看已安装 Skills：Settings → Rules → Agent Decides 部分。

4. 最佳实践

1. 技能命名：使用 kebab-case（如 flutter-page-generator）。
2. 保持精简：每个 Skill 聚焦一个明确领域。
3. 使用 Frontmatter：添加 description、tags、paths（限制作用范围）。
4. 版本控制：把 .cursor/skills 提交到 Git。
5. 全局 vs 项目：

• 通用技能（如代码审查）→ 全局（~/.cursor/skills）
• 项目特定技能 → 项目内（.cursor/skills）

1. 与 Rules 配合：Rules 定规范，Skills 做流程。

5. 常见问题排查

• Skills 不生效 → 执行 Reload Skills 或重启 Cursor。
• 路径错误 → 确认使用 .cursor/skills/ 或 .agents/skills/。
• 想用 Claude Skills → 直接复制到 Cursor 对应目录即可（兼容）。
• Nightly 版功能更全 → Settings → Beta → 使用 Nightly 版本。

一句话总结：
Skills 是 Cursor 从“会写代码”进化到“懂你工作流”的关键。熟练掌握后，你会发现 AI 不再是简单补全工具，而是一个真正懂业务的“资深同事”。

想要我继续补充：

• 推荐 10 个必装 Skills 清单
• 手把手教你写一个复杂 Skill（带脚本）
• Rules + Skills + Agents 最佳组合方案
• Cursor Settings 完整优化配置

告诉我你的具体需求，我立刻给你写！