安装
npx skills add vercel-labs/vgpu适合谁
vgpu 面向要用 TypeScript 写 WebGPU 的人：它提供带类型的着色器导入、偏 GPU 的小 API，并且同一套代码可以跑在浏览器、无头 Node 和测试里。仓库还写明：具备 skill 支持的助手可以安装一层很薄的文档路由，用来查询“当前项目已安装的那个 vgpu 版本”自带的文档。
更贴的用法是：你已经有或准备有一个 TypeScript 项目，先按 Quick Start 装好包，再让助手只查文档、或用 CLI 做只读校验。它不适合当一份独立的、与版本无关的 API 手册——技能本身不包含带版本号的 API 参考。
两条入口不要混成一条。项目依赖走 pnpm add vgpu。助手技能走 npx skills add vercel-labs/vgpu。没有 skill 支持的环境，不要套用后一条命令。
3 分钟完成第一次尝试
若当前助手支持 skill，官方技能命令是：npx skills add vercel-labs/vgpu。仓库地址是 https://github.com/vercel-labs/vgpu 请只按这一页操作。技能安装位置是助手的技能目录；它不会代替项目依赖。
前置条件：项目里最好已经装了 vgpu，因为技能会查询该版本捆绑的文档。若还没有包，先在可丢弃的项目里执行 Quick Start：pnpm add vgpu，以及 pnpm add -D @webgpu/types。不要编写未记载的安装器。
低风险第一次任务：不要先写会提交到 GPU 的正式场景。装好包后执行 npx vgpu check 做着色器校验，或执行 npx vgpu docs 只读打开文档。成功信号是 CLI 跑完并给出校验/文档结果，而不是你的业务代码已被改写。npx vgpu examples 会进入示例画廊，第一次可以只看、不改。
若走技能路径：安装后向助手提一个关于当前项目 vgpu 用法的只读问题。成功信号是回答能对上你刚装的包，而不是一份与项目无关的泛泛手册。说明没有写技能的斜杠命令名，因此用自然语言提问即可。
使用案例
案例一：给支持 skill 的助手装文档路由。命令是 npx skills add vercel-labs/vgpu。技能很薄，不含带版本的 API 参考，而是查询项目里已安装 vgpu 自带的文档。适合你正在改某个具体版本、怕手册和代码对不上的时候。若项目里还没有 vgpu，先按 Quick Start 安装，再提问。说明没有写离线镜像或固定文档站地址；vgpu.sh 会发布 agents.md 和 llms.txt 供模型阅读，但没有展开发布步骤。
案例二：用同一套 API 做多运行时开发，并用 CLI 校验。公开 API 同时覆盖浏览器、无头 Node（vgpu/node，Dawn 后端）以及给测试和 CI 用的确定性 mock（vgpu/mock）。日常可用 npx vgpu docs、npx vgpu examples、npx vgpu check。适合你要在提交前先校验着色器、或在 CI 里用 mock 跑测试的时候。说明没有写出 Dawn 的安装细节，也没有写 CI 配置模板；未看到本机 WebGPU/Dawn 就绪前，不要假设浏览器示例一定能在无头环境跑通。若命令失败，回到 https://github.com/vercel-labs/vgpu 对照。
使用边界
安装边界：项目用 pnpm add vgpu 和 @webgpu/types；助手用 npx skills add vercel-labs/vgpu。没有 skill 支持就不要套用后一条。技能边界：只做文档路由，不含带版本 API 参考，查询对象是项目已安装版本。运行时边界：浏览器、vgpu/node、vgpu/mock 共用公开 API；说明没有保证所有示例在三种环境行为完全一致。CLI 边界：能核对到 docs、examples、check。包管理器只写了 pnpm，没有记载的安装器不要使用。