К основному содержанию
скилл CX Codex

vite · oakoss — скилл для Claude Code: конфиг, сборка и SSR

Скилл для Claude Code описывает конфиг Vite, плагины, dev-сервер, сборку, SSR и переменные окружения. Задачи: правка vite.config.ts и сборка библиотек.

MIT 138 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill vite -a claude-code
Открыть на GitHub

Что делает vite

Скилл описывает, как устроен Vite: defineConfig с функцией от command и mode, алиасы через resolve.alias, прокси и HMR в server, целевой стандарт в build.target, ручное разбиение через manualChunks. Отдельно разобраны build.lib для публикации пакета, build.ssr, переменные import.meta.env.VITE_* и loadEnv, CSS-модули с препроцессорами и статические ассеты.

Скилл собран из одного SKILL.md и папки references/ — файлы разбиты по темам: конфигурация, плагины, dev-сервер, оптимизация сборки, library mode, SSR, переменные окружения, CSS и ассеты. В шапке лежат таблица шаблонов и таблица ошибок. Настройку тестов скилл передаёт vitest-testing, работу с Tailwind — скиллу tailwind, если они установлены.

Практический момент из списка ошибок: в library mode peer-зависимости нужно вносить в rollupOptions.external. Иначе React или Vue попадут внутрь опубликованного пакета. Вторая частая оплошность — секреты с префиксом VITE_: всё, что так названо, уезжает в клиентский бандл, серверные значения читают через loadEnv в конфиге.

Какие задачи решает

  • Настроить прокси dev-сервера, чтобы запросы к API уходили на бэкенд
  • Разбить бандл на чанки через manualChunks и rollupOptions
  • Собрать библиотеку в ES и CJS, не затащив в неё React
  • Разобраться, почему переменная из .env не доходит до браузера
  • Поднять SSR-сборку и не потерять состояние между запросами

Примеры запросов агенту

  • Пропиши в vite.config.ts алиас @/ на src/ и прокси /api на бэкенд
  • Собери библиотеку через build.lib, React вынеси в rollupOptions.external
  • Добавь manualChunks, чтобы вендоры ушли в отдельный чанк

Как установить vite

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill vite -a claude-code

2Вручную: положить файлы

~/.claude/skills/vite/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/vite/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о vite

Как установить скилл vite в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill vite -a claude-code. Файл скилла окажется по пути ~/.claude/skills/vite/SKILL.md.

Что делает скилл vite?

Даёт агенту справочник по vite.config.ts: плагины, dev-сервер, сборка, library mode, SSR, переменные окружения, CSS и ассеты. Плюс таблицу ошибок, которые чаще всего ломают конфиг.

В каких проектах Vite не подойдёт?

Там, где нужен ES5 для старых браузеров без транспиляции, где проект держится на webpack-лоадерах без аналогов в Vite или сборка вообще не про JavaScript.

Исходный текст

SKILL.md · MIT
---
name: vite
description: |
  Vite build tool configuration and ecosystem. Covers vite.config.ts setup, plugin authoring and popular plugins, dev server configuration (proxy, HMR, HTTPS), build optimization (chunking, tree-shaking, manual chunks, rollupOptions), library mode for publishing packages, SSR configuration, environment variables (.env handling), multi-page apps, CSS handling (PostCSS, CSS modules, preprocessors), and asset handling.

  Use when configuring Vite projects, authoring Vite plugins, optimizing builds, setting up dev server proxies, configuring SSR, handling environment variables, or troubleshooting Vite issues.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://vite.dev/guide/'
user-invocable: false
---

# Vite

## Overview

Vite is a next-generation frontend build tool that provides instant dev server start via native ES modules and optimized production builds via Rollup. It supports TypeScript, JSX, CSS preprocessors, and static assets out of the box with zero configuration.

**When to use:** Single-page apps, multi-page apps, library publishing, SSR applications, monorepo packages, any modern frontend project needing fast dev feedback and optimized builds.

**When NOT to use:** Legacy browsers requiring ES5 output without transpilation, projects locked to Webpack-specific loaders with no Vite equivalents, non-JavaScript build pipelines.

## Quick Reference

| Pattern            | API                                         | Key Points                        |
| ------------------ | ------------------------------------------- | --------------------------------- |
| Config file        | `defineConfig({})`                          | Type-safe config with IDE support |
| Conditional config | `defineConfig(({ command, mode }) => ({}))` | Different config per command/mode |
| Path alias         | `resolve.alias`                             | Map `@/` to `src/`                |
| Dev proxy          | `server.proxy`                              | Forward API requests to backend   |
| HMR config         | `server.hmr`                                | WebSocket host/port/protocol      |
| HTTPS dev          | `server.https`                              | Pass TLS cert/key options         |
| Build target       | `build.target`                              | ES module target for output       |
| Manual chunks      | `build.rollupOptions.output.manualChunks`   | Control code splitting            |
| Library mode       | `build.lib`                                 | Publish ES/CJS/UMD packages       |
| SSR build          | `build.ssr` + `ssr` options                 | Server-side rendering config      |
| Env variables      | `import.meta.env.VITE_*`                    | Client-exposed env vars           |
| loadEnv            | `loadEnv(mode, root, prefix)`               | Load env vars in config           |
| CSS modules        | `css.modules`                               | Scoped CSS class names            |
| Preprocessors      | `css.preprocessorOptions`                   | Sass/Less/Stylus options          |
| PostCSS            | `css.postcss`                               | Inline or external PostCSS config |
| Static assets      | `import url from './img.png'`               | Returns resolved public URL       |
| Plugin             | `{ name, transform, load }`                 | Hook-based plugin system          |
| Virtual module     | `resolveId` + `load` hooks                  | Generate modules at build time    |
| Multi-page         | `build.rollupOptions.input`                 | Multiple HTML entry points        |

## Common Mistakes

| Mistake                                             | Correct Pattern                                                                            |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Exposing secrets via `VITE_` prefix                 | Only prefix client-safe vars with `VITE_`; use `loadEnv` in config for server-only secrets |
| Using `process.env` in client code                  | Use `import.meta.env.VITE_*` (Vite replaces at build time)                                 |
| Modifying `rollupOptions.input` without `resolve()` | Always use `path.resolve()` or `import.meta.dirname` for absolute paths                    |
| Not externalizing peer deps in library mode         | Add React/Vue to `rollupOptions.external` to avoid bundling                                |
| Creating QueryClient-style singletons in SSR        | Ensure per-request state in SSR to avoid cross-request leaks                               |
| Inline PostCSS config alongside `postcss.config.js` | Use one or the other; inline config disables config file search                            |
| Setting `base` without trailing slash               | `base` should be `/path/` with trailing slash or full URL                                  |
| Using `__dirname` in ESM config                     | Use `import.meta.dirname` (Node 21+) or `fileURLToPath`                                    |

## Delegation

- **Plugin discovery**: Use `Explore` agent
- **Build analysis**: Use `Task` agent
- **Config review**: Delegate to `code-reviewer` agent

> If the `vitest-testing` skill is available, delegate test configuration and Vitest setup to it.
> If the `tailwind` skill is available, delegate Tailwind CSS configuration and utility patterns to it.
> If the `react-patterns` skill is available, delegate React component patterns and hooks to it.
> If the `typescript-patterns` skill is available, delegate TypeScript configuration and type patterns to it.
> If the `pnpm-workspace` skill is available, delegate monorepo workspace configuration to it.

## References

- [Configuration fundamentals and defineConfig patterns](references/configuration.md)
- [Plugin authoring and popular plugins](references/plugins.md)
- [Dev server setup: proxy, HMR, HTTPS, and middleware](references/dev-server.md)
- [Build optimization: chunking, tree-shaking, and output control](references/build-optimization.md)
- [Library mode for publishing packages](references/library-mode.md)
- [SSR configuration and Express integration](references/ssr-configuration.md)
- [Environment variables and .env file handling](references/environment-variables.md)
- [CSS handling: PostCSS, CSS modules, preprocessors, and asset management](references/css-and-assets.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — vite от других авторов.

vite Anthony Fu Разбирает конфигурацию Vite, плагины, SSR и сборку библиотек. Помогает настроить vite.config.ts и миграцию на Vite 8. CX Codex +1 42 400установок vite Mindrally Даёт агенту шаблоны конфигурации Vite: HMR, алиасы путей, сборку бандлов, интеграцию React, Vue и Vitest. CX Codex +1 875установок vite pproenca Набор из 42 правил оптимизации сборки и dev-сервера Vite. Помогает настроить конфигурацию, ускорить HMR и уменьшить размер бандла. CX Codex +1 376установок vite itechmeat Скилл помогает агенту настраивать и использовать Vite: от dev-сервера и сборки до плагинов, HMR и переменных окружения. CX Codex +1 111установок vite-bundle-optimization patterns.dev Скилл vite-bundle-optimization для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI обучает агента паттернам оптимизации бандла Vite + React. Активируется при настройке сборки, разбивке кода на чанки или диагностике медленных билдов. CX Codex +1 692установок vinext-vite-nextjs reason-machines Скилл vinext-vite-nextjs помогает перевести проект с Next.js на Vite и подготовить сборку для Cloudflare Workers. Поддерживает Pages Router и App Router. CX Codex +1 1 400установок vite-advanced OrchestKit Скилл vite-advanced для Claude Code и Codex настраивает сборку Vite 8 на Rolldown, разделение чанков и Environment API. Включается при правке vite.config.* или файлов в каталогах **/vite/**. CX Codex +1 265установок vite-patterns affaan-m Скилл vite-patterns подсказывает, как настраивать Vite, плагины, HMR, переменные окружения и сборку. Нужен при работе с vite.config.ts и Vite-проектами. CX Codex +1 6 500установок vite-react-best-practices ant-gravity Скилл vite-react-best-practices задаёт агенту правила архитектуры, кэширования и деплоя для SPA на React 19 и Vite 8. Включается при сборке проекта, настройке роутинга или рефакторинге компонентов. CX Codex +1 670установок react-vite-best-practices agent-skills Скилл react-vite-best-practices для Claude Code с 23 правилами оптимизации React-приложений на Vite: сборка, code splitting, HMR, ассеты, окружение и анализ бандла. Проверяет компоненты при написании и ревью. CX Codex +1 3 000установок

Из того же набора106

Весь набор →
hydration-guardian Скилл hydration-guardian ловит расхождение серверной разметки и клиентского React-дерева: по тексту ошибки находит причину и подсказывает, какой приём гидратации применить. CX Codex +1 144установок e2e-testing Скилл e2e-testing помогает ИИ-агенту проектировать архитектуру E2E-тестов на Playwright: от Page Object Model и шардинга в CI до моков сети и проверок доступности. CX Codex +1 142установок valkey Скилл помогает настраивать Valkey и Redis-совместимое хранилище: от кэша и лимитов запросов до очередей и миграции с Redis. Пригодится при проектировании схемы данных и Docker Compose. CX Codex +1 142установок remotion Скилл для Remotion: агент собирает видео из React-компонентов и держит анимацию в таймлайне, а не в CSS. CX Codex +1 141установок postgres-tuning Скилл postgres-tuning для Claude Code, Codex, Cursor и других агентов, который даёт инструкции по настройке производительности PostgreSQL 17/18+. Охватывает async I/O, анализ планов запросов, индексы, autovacuum, pgvector и PgBouncer. CX Codex +1 136установок tanstack-db Помогает проектировать реактивное клиентское хранилище на TanStack DB: живые запросы, связи коллекций и оптимистичные изменения. Описывает локальные данные и синхронизацию. CX Codex +1 136установок prompt-engineering Скилл prompt-engineering для Claude Code собирает приёмы проектирования промптов: цепочки рассуждений, ReAct-циклы, шаблоны системных промптов, extended thinking и сжатие контекста. CX Codex +1 135установок react-error-handling Скилл react-error-handling помогает проектировать предохранители и запасные интерфейсы в React, чтобы сбой в дочернем компоненте не ломал всё приложение. CX Codex +1 134установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой