vgpu — скилл
Скилл Vercel Labs для работы с WebGPU-библиотекой vgpu: шейдеры WGSL, 3D-сцены, тесты и ассеты из Blender
- 2 652 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл велит агенту запускать локальный CLI vgpu через npx и менеджеры пакетов
- Необязательный размещенный MCP-сервер vgpu.sh обращается к сети
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/vgpuОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл велит агенту запускать локальный CLI vgpu через npx и менеджеры пакетов
- Необязательный размещенный MCP-сервер vgpu.sh обращается к сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл vgpu от Vercel Labs помогает агенту писать, отлаживать и ускорять проекты на WebGPU с библиотекой vgpu, ее CLI и пакетами @vgpu. Сам скилл тонкий: справочника API в нем нет, документацию он берет из установленной в проект версии пакета через `npx vgpu docs`, а примеры ищет командой `npx vgpu examples search`. Выводить форму API из памяти, ветки репозитория или размещенной документации скилл запрещает, пока есть локальные тексты пакета. Перед работой агент выясняет, какая версия vgpu стоит в нужной части монорепозитория, и проверяет локальный CLI командой `pnpm exec vgpu --version` или `npm exec --no -- vgpu --version`. Флаг `--no` не дает менеджеру пакетов скачать недостающую команду. Для 3D-сцен скилл отсылает к руководству scene.md про иерархии, трансформации, инстансы, камеры и интеграцию анимации и физики. Отдельный раздел посвящен Blender: моделирование, варианты с высокой и низкой детализацией, запекание нормалей и «ambient occlusion», уровни детализации и проверка ассета. Руководство от версии vgpu не зависит; за API рантайма агент идет в локальные документы. Сама библиотека пишет шейдеры как типизированные WGSL-модули и работает в браузере, в Node с Dawn и в тестовом моке `vgpu/mock`.
Для кого. Графическим программистам и фронтенд-разработчикам на WebGPU, которые пишут шейдеры и сцены на vgpu вместе с Claude Code, Cursor или Codex.
Подходит, если
- Шейдер на WGSL подключают как TypeScript-модуль, и агент сверяет типы с документацией установленной версии
- Сцену с камерой, трансформациями и инстансами собирают с нуля по руководству scene.md
- Модель из Blender готовят для рантайма: запекание нормалей и «ambient occlusion», LOD, проверка ассета
- Тесты графики идут в CI без видеокарты, и агент подключает `vgpu/mock`
- Для задачи нужен готовый пример: агент ищет его в галерее и забирает исходник командой `npx vgpu examples pull`
Не подходит, если
- Проект на Three.js или Babylon.js без vgpu: скилл отсылает к документации пакета vgpu
- Версия vgpu в проекте не установлена: скилл читает документы из пакета, и без него опираться не на что
- Нужен общий курс по WebGPU: скилл знает vgpu и не заменяет учебник по API браузера
Пример запроса к агенту
Собери на vgpu полноэкранный эффект с волновым шейдером и временем в `uniform`, отрисуй его на `canvas` и добавь тест на моке без GPUОграничения
- Скилл версионно-нейтральный и справочника API не содержит. Без установленного пакета `vgpu` и его CLI он мало что даст.
- README помечает vgpu как Labs-продукт Vercel, гарантий стабильности API в нем нет.
- Размещенный MCP-сервер `https://vgpu.sh/api/mcp` читает документацию из сети. Чтобы привязаться к версии пакета, README советует локальный `npx vgpu mcp`.
- Блок про Blender не зависит от версии vgpu, API рантайма берут из локальных документов.
Как отключить. Удалите папку скилла vgpu из каталога навыков агента. Пакет из проекта убирает команда вашего менеджера, например `pnpm remove vgpu`.
Частые вопросы
Как поставить скилл vgpu в Claude Code?
Выполните `npx skills add vercel-labs/vgpu` в каталоге проекта. Саму библиотеку ставят отдельно, например `pnpm add vgpu`, а для типов нужен `pnpm add -D @webgpu/types`.
Откуда скилл берет документацию по API?
Из пакета vgpu, установленного в проекте, через `npx vgpu docs`. Скилл версионно-нейтральный, поэтому подсказки не устаревают при смене версии библиотеки.
Есть ли у vgpu MCP-сервер?
Да, два варианта. Размещенный публичный сервер только для чтения живет по адресу `https://vgpu.sh/api/mcp`, а локальный запускает `npx vgpu mcp`, с `--project-from-cwd` он привязывается к проекту.
Что скилл умеет по Blender?
Он ведет моделирование, варианты с высокой и низкой детализацией, запекание нормалей и «ambient occlusion», уровни детализации и проверку ассета. Загрузку готовой модели в рантайм агент делает уже по документам пакета vgpu.
Какие среды выполнения поддерживает vgpu?
Браузер, «headless» Node через `vgpu/node` на Dawn и детерминированный мок `vgpu/mock` для тестов и CI. Один публичный API работает во всех трех средах.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл разбирает и переносит WebGL, WebGPU и Canvas-эффекты со страницы в отдельный локальный проект на нативном JS
Скилл для разработки WebGPU-приложений на Three.js с шейдерами на TSL: рендерер, node-материалы, compute-шейдеры, пост-обработка
Скилл и MCP-сервер библиотеки Shaders: агент собирает фоны, стекло, градиенты и курсорные эффекты на WebGPU для React, Vue, Svelte, Solid и JS
Скилл помогает писать и отлаживать GLSL-шейдеры из готовых блоков, собирает зависимости в один файл и проверяет код для WebGL2.
Три скилла для веб-3D: шейдеры GLSL, сцены Three.js с React Three Fiber и частицы на видеокарте.
Скилл ведет агента от выбора рендерера до проверки в браузере для небольших GPU-эффектов в интерфейсах на WebGL и WebGPU.
Коротко о README
README представляет vgpu как TypeScript-библиотеку для WebGPU с типизированными импортами WGSL, одним контекстом `Gpu` и малым размером: полноэкранный эффект занимает 25 КБ в «gzip». Дальше идут быстрый старт, раздел о ресурсах для агентов (CLI, навык, MCP, `llms.txt`) и описание пакетов монорепозитория. Лицензия MIT.
Бейдж для README
Исходный SKILL.md
--- name: vgpu description: >- Build, debug, test, and optimize WebGPU projects using vgpu, its CLI, or @vgpu packages. Use for vgpu API questions, WGSL workflows, browser or Node rendering, integrations, testing, performance work, and Blender asset modeling, baking, and runtime integration. --- # vgpu Treat the documentation bundled with the target project's installed `vgpu` package as the authority for that project. This skill is intentionally version-neutral: do not infer API shapes from the skill's Git revision, remembered APIs, the repository default branch, hosted docs, or a hosted MCP server when local package docs are available. The public skill install command has no branch pin: ```sh npx skills add vercel-labs/vgpu ``` ## 3D scenes If you need to work with 3D scenes, read [Scene composition](./scene.md) before implementing scene hierarchies, transforms, instances, cameras, or animation and physics integration. ## Blender assets For Blender modeling, high/low-poly workflows, normal or ambient occlusion baking, LODs, and asset validation, read [Blender assets](blender/index.md). That guide links to focused references for shape and assembly or baking diagnostics; load them when the task needs them. Its authoring guidance is independent of the vgpu version. For runtime API work, use the package docs below. ## Select the package version Run the project-local `vgpu` executable from the workspace that owns the dependency. First check the relevant package manifest and lockfile, then confirm which local CLI you resolved without allowing the package manager to download a missing command: ```sh pnpm exec vgpu --version npm exec --no -- vgpu --version ``` Use a local-only equivalent for other package managers, such as `yarn exec vgpu --version` or an already resolved `node_modules/.bin/vgpu`. Commands such as bare `npx vgpu` or `bunx vgpu` may download a missing package, so do not use them for local version discovery. npm's `--offline` is also insufficient because it can install a missing package from cache. Do not replace an installed version merely to read newer documentation.