安裝
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，沒有記載的安裝器不要使用。