一、 技能分类:全局 vs 项目
在 Cursor 和主流 AI 编码 Agent(如 Claude Code 等)所采用的 Agent Skills 开放标准中,技能确实被明确分为**全局(Global)和项目(Project)**两种安装模式。
| 维度 | 全局技能(Global) | 项目级技能(Project) |
|---|---|---|
| 安装位置 | 用户主目录(如~/.agents/skills/) | 项目根目录(如项目/.cursor/skills/或.agents/skills/) |
| 生效范围 | 电脑上的所有项目和编辑器窗口。 | 仅在当前项目打开时生效。 |
| 共享与团队 | 无法直接通过 Git 分享,其他同事必须自己本地安装。 | 可以直接提交到 Git 仓库,团队成员拉取后自动开箱即用。 |
| 对上下文的影响 | 如果安装太多,可能会在不相关的项目中误触发,浪费 Token。 | 只有项目匹配时才触发,能保持 AI 上下文干净、专注。 |
建议:我该装全局还是项目?
- 建议项目级安装:针对特定技术栈、特定业务逻辑的技能。例如
vercel-react-best-practices(仅 React 项目需要)、better-auth-best-practices(仅使用 Better Auth 的项目需要)。 - 建议全局安装:针对通用工具、元技能、跨项目通用工作流的技能。例如
skill-creator(用来帮你写新技能的工具)、agent-browser(让 AI 可以使用浏览器上网)、seo-audit(通用的 SEO 检查)。
关于“以后开新项目是不是又要装一次”的顾虑:
如果采用项目级安装,新项目的确需要重新“添加”一次。不过,你不需要重新下载和配置。
- 非常简单的一键命令:在新项目中只需运行一行
npx skills add <name>,1 秒钟就能搞定。 - 保持轻量化:避免了在写一个 Python 后端项目时,AI 还在偷偷读取 React 最佳实践规章,从而浪费你宝贵的 Token。
二、 准备工作:安装 Skills 命令行工具
目前社区和 Vercel 推荐的 Agent Skills 标准管理工具是skillsCLI,它可以帮我们一键下载、更新和管理这些技能。
在你的终端中,可以使用npx skills直接调用(系统会自动下载所需的运行环境)。
注意(避坑提示):在安装技能时,CLI 有时会询问你是使用Symlink(符号链接)还是Copy(复制文件)。在 Cursor 中,强烈建议选择 Copy(复制),因为 Cursor 对符号链接的兼容性有时不够稳定,选择 Copy 能保证 Cursor 正确将其识别为
.cursor/rules规则。
三、 目标 Skills 的安装命令指南
以下是你提到的 7 个技能的精准安装指令。你可以根据需要,选择在命令后加上-g(全局安装)或者不加(默认安装在当前项目下)。
1. vercel-react-best-practices & 2. web-design-guidelines
这两个技能均包含在 Vercel 官方维护的agent-skills仓库中。
- 项目级安装(推荐,React项目专用):
bash
代码解读
复制代码
npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices npx skills add vercel-labs/agent-skills --skill web-design-guidelines - 全局安装:
bash
代码解读
复制代码
npx skills add -g vercel-labs/agent-skills --skill vercel-react-best-practices npx skills add -g vercel-labs/agent-skills --skill web-design-guidelines
3. skill-creator & 5. frontend-design
这两个是由 Anthropic 官方提供的优秀技能,前者用于帮助你用自然语言生成新的技能。
- 项目级安装:
bash
代码解读
复制代码
npx skills add anthropics/skills --skill skill-creator npx skills add anthropics/skills --skill frontend-design - 全局安装(推荐把
skill-creator装在全局):bash
代码解读
复制代码
npx skills add -g anthropics/skills --skill skill-creator npx skills add -g anthropics/skills --skill frontend-design
4. better-auth-best-practices
YC 孵化的知名认证框架 Better Auth 的官方最佳实践技能。
- 项目级安装(推荐,仅在需要身份认证的项目里安装):
bash
代码解读
复制代码
npx skills add better-auth/skills --skill better-auth-best-practices - 全局安装:
bash
代码解读
复制代码
npx skills add -g better-auth/skills --skill better-auth-best-practices
6. agent-browser
给 AI 提供一个真实的无头浏览器(Headless Browser),让它在处理任务时能自己去点开网页、登录或截取 Log。
- 全局安装(推荐,属于通用工具类):
bash
代码解读
复制代码
npx skills add -g vercel-labs/agent-browser
7. seo-audit
由 Corey Haines 维护的专业 SEO 审计与优化建议技能。
- 全局安装(方便随时对任何前端项目做 SEO 评估):
bash
代码解读
复制代码
npx skills add -g coreyhaines31/marketingskills --skill seo-audit
四、 如何在 Cursor 中确认和使用这些技能?
- 确认安装结果:
- 如果是项目级安装,安装完成后,你会发现项目根目录下多出了
.cursor/skills/(或.agents/skills/)文件夹,里面包含各个技能的SKILL.md和规则文件。 - 某些版本的 Cursor 会将这些技能自动识别并加载为
.cursor/rules规则。
- 如果是项目级安装,安装完成后,你会发现项目根目录下多出了
- 如何触发使用:
- 这些技能通常都带有触发器(Triggers)。在日常对话中,当你的输入契合了触发条件时,Cursor 的 Agent 会自动加载它们。
- 例如:当你输入"帮我重构这个 React 组件的性能",Cursor 会自动激活并参考
vercel-react-best-practices里的 40+ 条性能优化规则进行调整,而不需要你手动复制粘贴提示词。