vue-skills 将 Vue 3 生态长期沉淀的经验拆分为多个独立技能（Skills），覆盖开发的主要场景：

Vue 3 最佳实践（vue-best-practices）：涵盖 Composition API 正确用法、常见陷阱规避、SSR 性能优化与项目可维护性规范。

Options API 规范：提供 this 上下文管理、生命周期钩子与 TypeScript 适配策略。

Vue Router 4 指南：封装导航守卫配置、路由参数处理与路由组件生命周期规范。

Pinia 状态管理：定义 Store 类型设计、TS 推导、模块化组织与响应式模式。

测试规范：包含 Vitest、Vue Test Utils 与 Playwright 的组件单元测试及 E2E 测试指南。

Vue JSX 语法：说明与 React JSX 在作用域和指令上的差异，避免混用错误。

调试手册（vue-debug-guides）：内置运行时错误、异步异常处理与 hydration 问题的排查指南。

Composable 封装：支持基于 MaybeRef 与 MaybeRefOrGetter 的标准化可复用逻辑封装。

使用 vue-skills 非常简单，只需几步即可让 AI 助手掌握 Vue 开发规范：

第一步，安装技能包：在终端执行 npx skills add vuejs-ai/skills 命令，将 vue-skills 添加至本地环境。

第二步，选择 AI 工具：根据交互提示选择支持的 AI 工具，如 Cursor、Claude Code、GitHub Copilot 等。

第三步，配置安装范围：选择全局或项目级安装范围，确认安全评估后完成配置。

第四步，显式触发技能：在 AI 对话中为提示词加上前缀“Use vue skill, ”，例如“Use vue skill, 帮我写一个符合 Vue 3 最佳实践的表单组件”，确保 AI 稳定调用对应规则。

第五步，描述开发需求：直接描述你的 Vue 开发任务，AI 会自动参考技能规范生成符合官方标准的代码。

Claude Code 用户也可通过 /plugin marketplace add vuejs-ai/skills 添加市场，再使用 /plugin install vue-best-practices@vue-skills 安装单个或全部技能。

权威来源：由 Vue 核心团队与 VoidZero 成员维护，规则基于真实 issue 与官方文档验证，而非社区二手整理，可信度高。

按需加载：采用渐进式披露机制，仅当任务匹配时才动态加载完整指令，避免长期占用 Token 和上下文窗口。

跨工具兼容：遵循 Agent Skills 开放标准，支持 Cursor、Claude Code、GitHub Copilot、Gemini CLI 等 30 余种 AI 工具。

自动化验证：每条规则均通过自动 eval 测试，仅保留“无技能则失败、有技能则通过”的有效规则，确保质量可控、无冗余噪音。

持续演进：项目开源并接受社区反馈，规则随 Vue 生态发展持续更新，帮助 AI 紧跟最新特性。

以同生态的 nuxt-skills 为例进行对比：

定位：vue-skills 面向 Vue 3 通用开发规范与避坑指南；nuxt-skills 则聚焦 Nuxt 框架专属的服务端/全栈开发规范。

维护方：vue-skills 由 Vue 核心成员 Yunfei He（VoidZero）维护；nuxt-skills 由 Nuxt 社区成员 onmax 维护。

覆盖范围：vue-skills 覆盖 Composition API、Options API、Vue Router、Pinia、VueUse、Testing、JSX 等客户端开发场景；nuxt-skills 则聚焦 Nuxt 3 路由系统、渲染模式（SSR/SSG/CSR）、模块开发与 Nitro 引擎。

适用项目：vue-skills 适合纯 Vue 3 单页应用或组件库；nuxt-skills 适合基于 Nuxt 的全栈应用与服务端渲染项目。

与框架关系：vue-skills 是 Vue 官方生态独立项目，可脱离 Nuxt 单独使用；nuxt-skills 依赖 Nuxt 框架上下文，属于其专属扩展。

Q1: vue-skills 是 Vue 官方正式发布的工具吗？
A1: 目前它是早期实验/社区项目，由 Vue 团队成员 Yunfei He 发起，并获得 Vue 作者尤雨溪的转发点赞。若项目成熟，作者计划将其移交至 Vue 官方组织，服务更广泛的社区。
Q2: vue-skills 支持哪些 AI 工具？
A2: 它遵循 Agent Skills 开放标准，支持 Cursor、Claude Code、GitHub Copilot、Gemini CLI 等 30 余种主流 AI 编程工具，安装后可自动识别。
Q3: 为什么安装后 AI 没有自动使用技能？
A3: 技能触发依赖提示词与技能描述的关键词匹配，可能不稳定。建议在提示词前显式添加“Use vue skill, ”前缀，即可稳定启用对应规则。
Q4: 安装 vue-skills 会占用很多 Token 吗？
A4: 不会。它采用渐进式披露机制，仅在任务匹配时动态加载完整指令，平时不常驻上下文，对 Token 消耗影响极小。
Q5: 安装 vue-skills 会影响我现有的项目代码吗？
A5: 不会。它只向 AI 提供开发规范与建议，不会修改已有代码，也不会改变你的技术栈，可放心使用。
Q6: vue-skills 是免费开源的么？
A6: 是的。它完全免费开源，采用 MIT 协议，可在 GitHub（vuejs-ai/skills）查看源码、提交反馈或参与贡献。