Install
npx skills add vercel-labs/vgpuFür wen
vgpu richtet sich an alle, die WebGPU in TypeScript schreiben: typisierte Shader-Importe, eine kleine GPU-nahe API, und derselbe Code kann im Browser, in Headless Node und in Tests laufen. Das Repository sagt außerdem: Ein Assistent mit Skill-Unterstützung kann eine sehr dünne Dokumentationsroute installieren, die die Docs abfragt, die mit „der in diesem Projekt installierten vgpu-Version“ gebündelt sind.
Eine passendere Nutzung: Sie haben schon ein TypeScript-Projekt oder werden eines haben. Installieren Sie das Paket zuerst über Quick Start, lassen Sie den Assistenten nur Docs abfragen oder nutzen Sie die CLI für Nur-Lese-Prüfungen. Es ist kein eigenständiges, versionsloses API-Handbuch — die Skill selbst enthält keine versionierte API-Referenz.
Mischen Sie die zwei Einstiege nicht zu einem. Projektabhängigkeiten laufen über pnpm add vgpu. Die Assistenten-Skill läuft über npx skills add vercel-labs/vgpu. In einer Umgebung ohne Skill-Unterstützung wenden Sie den zweiten Befehl nicht an.
Erster Versuch in 3 Minuten
Wenn der aktuelle Assistent Skills unterstützt, lautet der offizielle Skill-Befehl npx skills add vercel-labs/vgpu. Das Repository ist https://github.com/vercel-labs/vgpu Folgen Sie nur dieser Seite. Die Skill wird ins Skill-Verzeichnis des Assistenten installiert; sie ersetzt die Projektabhängigkeit nicht.
Voraussetzungen: Im Projekt sollte vgpu schon liegen, weil die Skill die mit dieser Version gebündelten Docs abfragt. Fehlt das Paket, führen Sie Quick Start zuerst in einem wegwerfbaren Projekt aus: pnpm add vgpu und pnpm add -D @webgpu/types. Erfinden Sie keinen undokumentierten Installer.
Erste Aufgabe mit geringem Risiko: Schreiben Sie nicht zuerst eine formale Szene, die Arbeit an die GPU schickt. Nach der Paketinstallation führen Sie npx vgpu check zur Shader-Prüfung aus oder npx vgpu docs, um Docs nur lesend zu öffnen. Erfolgssignal: Die CLI endet und liefert ein Prüf- oder Docs-Ergebnis, nicht dass Ihr Geschäftscode umgeschrieben wurde. npx vgpu examples öffnet die Beispielgalerie; beim ersten Mal nur ansehen, nichts ändern.
Skill-Weg: Stellen Sie nach der Installation eine Nur-Lese-Frage zur vgpu-Nutzung in diesem Projekt. Erfolgssignal: Die Antwort passt zum gerade installierten Paket, nicht zu einem allgemeinen Handbuch ohne Projektbezug. Die Anleitung nennt keinen Slash-Command-Namen der Skill; eine Frage in natürlicher Sprache reicht.
Anwendungsfälle
Fall 1: Die Dokumentationsroute für einen Skill-fähigen Assistenten installieren. Der Befehl ist npx skills add vercel-labs/vgpu. Die Skill ist dünn, enthält keine versionierte API-Referenz und fragt die Docs ab, die mit der im Projekt installierten vgpu mitkommen. Das passt, wenn Sie eine konkrete Version ändern und Handbuch und Code auseinanderlaufen könnten. Fehlt vgpu im Projekt, zuerst per Quick Start installieren, dann fragen. Die Anleitung nennt keinen Offline-Spiegel und keine feste Docs-Site; vgpu.sh veröffentlicht agents.md und llms.txt für Modelle, führt die Veröffentlichungsschritte aber nicht aus.
Fall 2: Dieselbe API über mehrere Laufzeiten entwickeln und per CLI prüfen. Die öffentliche API deckt Browser, Headless Node (vgpu/node, Dawn-Backend) und ein deterministisches Mock für Tests und CI (vgpu/mock) ab. Alltäglich nutzbar sind npx vgpu docs, npx vgpu examples, npx vgpu check. Das passt, wenn Sie Shader vor dem Commit prüfen oder Tests in CI mit dem Mock laufen lassen. Die Anleitung schreibt weder Dawn-Installationsdetails noch eine CI-Vorlage; bevor WebGPU/Dawn auf diesem Rechner bereit ist, nehmen Sie nicht an, dass ein Browserbeispiel in einer Headless-Umgebung durchläuft. Schlägt ein Befehl fehl, gehen Sie zurück zu https://github.com/vercel-labs/vgpu und vergleichen.
Grenzen
Installationsgrenze: Das Projekt nutzt pnpm add vgpu und @webgpu/types; der Assistent nutzt npx skills add vercel-labs/vgpu. Ohne Skill-Unterstützung den zweiten Befehl nicht anwenden. Skill-Grenze: nur Dokumentationsroute, keine versionierte API-Referenz; Abfrageziel ist die im Projekt installierte Version. Laufzeitgrenze: Browser, vgpu/node und vgpu/mock teilen die öffentliche API; die Anleitung garantiert kein identisches Verhalten aller Beispiele in allen drei Umgebungen. CLI-Grenze: prüfbar sind docs, examples, check. Als Paketmanager steht nur pnpm; undokumentierte Installer nicht verwenden.