vite

Vite performance optimization guidelines. This skill should be used when writing, reviewing, or refactoring Vite configuration and projects to ensure optimal performance patterns. Triggers on tasks involving Vite config, build optimization, dependency pre-bundling, plugin development, bundle analysis, or HMR issues.

Jump to install

Repository: pproenca/dot-skills
Last source activity: May 27, 2026 at 09:50
Detected SKILL.md language: English
Stars: 194
Forks: 17

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/pproenca/dot-skills --skill vite

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

48 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

drizzle-nextjs-postgres

Drizzle ORM against PostgreSQL inside a Next.js App Router app. Covers client construction (globalThis singleton across HMR, serverless pool sizing, `prepare:false` behind PgBouncer/Supavisor, driver choice when you need interactive transactions, `server-only`), reads in Server Components under Next.js 16 Cache Components (`use cache` superseding `unstable_cache` and the `revalidate`/`dynamic` segment configs, Suspense boundaries, React `cache()` dedupe), Server Actions (authorization inside the action, `updateTag` vs `revalidateTag`, `after()`), Postgres schema types (timestamptz, identity vs serial, jsonb, numeric-as-string, bigint modes), drizzle-kit migrations (generate vs push, CONCURRENTLY outside the migrator, NOT VALID constraints, rename prompts), transactions and pooled connections, and Postgres query traps (keyset pagination, count cost, driver-dependent `db.execute()` shape, NOT IN nulls, prepared statements). Use when writing or reviewing Drizzle + Postgres code in Next.js.

2026-07-24

relational-data-modeling

Corrects the wrong defaults a model has when designing a relational schema — the DDL decisions an experienced engineer makes differently. Use when creating or reviewing tables, migrations, ER models, or ORM schema definitions. Covers identity and keys (surrogate vs natural, identity vs serial, uuidv7, composite keys that make cross-tenant references impossible), relationships (polymorphic foreign keys the database cannot enforce, referential actions, unindexed FK columns, disjoint subtypes), invariants the engine can prove instead of application code (EXCLUDE, partial unique indexes, CHECK limits, deferrable cycles, NOT VALID), types (timestamptz, exact money, range types, enum vs lookup table), derived and encoded data (generated columns, JSONB as an escape hatch), and time (events vs in-place updates, soft-delete flags that silently disable constraints, temporal keys). NOT for query tuning, index selection for read paths, or connection pooling.

2026-07-23

relational-database-design

Distills a logical relational-database design methodology into rules an agent applies while designing or reviewing a schema. Covers the design sequence (mission → tables → fields → keys → relationships → business rules → views → integrity review), one-subject-per-table decomposition, atomic single-valued fields, candidate/primary/foreign keys, relationship types with deletion rules and participation, the four levels of data integrity, database-vs-application business rules, validation tables, views for derived data, and the flat-file / spreadsheet / RDBMS-driven antipatterns to avoid. The structure is logical and RDBMS-agnostic, and normalized by construction. Use when designing a new relational schema, reviewing or refactoring an existing one, resolving redundant or repeating data, choosing keys, modeling relationships, or deciding where a constraint belongs.

2026-07-23

View all from this repository

name	vite
description	Vite performance optimization guidelines. This skill should be used when writing, reviewing, or refactoring Vite configuration and projects to ensure optimal performance patterns. Triggers on tasks involving Vite config, build optimization, dependency pre-bundling, plugin development, bundle analysis, or HMR issues.

Vite Best Practices

Comprehensive performance optimization guide for Vite applications. Contains 42 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

When to Apply

Reference these guidelines when:

Configuring Vite for a new project
Troubleshooting slow dev server startup
Optimizing production bundle size
Debugging HMR issues
Writing or evaluating Vite plugins
Migrating from Webpack or other bundlers

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Dependency Pre-bundling	CRITICAL	`deps-`
2	Plugin Performance	CRITICAL	`plugin-`
3	Bundle Optimization	CRITICAL	`bundle-`
4	Import Resolution	HIGH	`import-`
5	Build Configuration	HIGH	`build-`
6	Development Server	MEDIUM-HIGH	`dev-`
7	CSS Optimization	MEDIUM	`css-`
8	Advanced Patterns	LOW-MEDIUM	`advanced-`

Quick Reference

1. Dependency Pre-bundling (CRITICAL)

deps-include-large-cjs - Include large dependencies with many modules
deps-exclude-esm - Exclude small ESM dependencies
deps-force-rebundle - Use --force flag for dependency changes
deps-hold-until-crawl - Configure holdUntilCrawlEnd for startup behavior
deps-entries - Configure custom entry points for discovery
deps-linked-packages - Handle linked dependencies in monorepos

2. Plugin Performance (CRITICAL)

plugin-lazy-imports - Use dynamic imports in plugin code
plugin-avoid-long-hooks - Avoid long operations in startup hooks
plugin-transform-early-return - Early return in transform hooks
plugin-audit-community - Audit community plugins for performance
plugin-swc-over-babel - Use SWC instead of Babel for React

3. Bundle Optimization (CRITICAL)

bundle-manual-chunks - Use manualChunks for vendor splitting
bundle-dynamic-imports - Use dynamic imports for route-level splitting
bundle-analyze - Analyze bundle composition
bundle-tree-shaking - Enable effective tree-shaking
bundle-chunk-warning - Address large chunk warnings
bundle-compression - Disable compressed size reporting for large projects
bundle-asset-inlining - Configure asset inlining threshold

4. Import Resolution (HIGH)

import-avoid-barrel - Avoid barrel file imports
import-explicit-extensions - Use explicit file extensions
import-path-aliases - Configure path aliases for clean imports
import-svg-strings - Import SVGs as strings instead of components
import-glob-patterns - Use glob imports carefully

5. Build Configuration (HIGH)

build-modern-target - Target modern browsers
build-minification - Use esbuild for minification
build-sourcemaps - Disable source maps in production
build-css-code-split - Enable CSS code splitting
build-rolldown - Consider Rolldown for faster builds
build-output-dir - Configure output directory and caching

6. Development Server (MEDIUM-HIGH)

dev-server-warmup - Warm up frequently used files
dev-browser-cache - Keep browser cache enabled in DevTools
dev-fs-limits - Increase file descriptor limits on Linux
dev-wsl-polling - Use polling for WSL file watching
dev-https-proxy - Configure HTTPS and proxy for development

7. CSS Optimization (MEDIUM)

css-lightning - Use Lightning CSS instead of PostCSS
css-avoid-preprocessors - Prefer CSS over preprocessors when possible
css-modules - Use CSS Modules for component styles
css-inline-critical - Extract critical CSS for initial paint

8. Advanced Patterns (LOW-MEDIUM)

advanced-ssr-externalize - Externalize dependencies for SSR
advanced-env-static - Use static environment variables
advanced-profiling - Profile build performance
advanced-lib-mode - Configure library mode for package development

How to Use

Read individual reference files for detailed explanations and code examples:

Section definitions - Category structure and impact levels
Rule template - Template for adding new rules

Reference Files

File	Description
AGENTS.md	Complete compiled guide with all rules
references/_sections.md	Category definitions and ordering
assets/templates/_template.md	Template for new rules
metadata.json	Version and reference information

vite

Source facts

Install options

Review the source files

More from this repository

More from this repository

Vite Best Practices

When to Apply

Rule Categories by Priority

Quick Reference

1. Dependency Pre-bundling (CRITICAL)

2. Plugin Performance (CRITICAL)

3. Bundle Optimization (CRITICAL)

4. Import Resolution (HIGH)

5. Build Configuration (HIGH)

6. Development Server (MEDIUM-HIGH)

7. CSS Optimization (MEDIUM)

8. Advanced Patterns (LOW-MEDIUM)

How to Use

Reference Files

Vite Best Practices

When to Apply

Rule Categories by Priority

Quick Reference

1. Dependency Pre-bundling (CRITICAL)

2. Plugin Performance (CRITICAL)

3. Bundle Optimization (CRITICAL)

4. Import Resolution (HIGH)

5. Build Configuration (HIGH)

6. Development Server (MEDIUM-HIGH)

7. CSS Optimization (MEDIUM)

8. Advanced Patterns (LOW-MEDIUM)

How to Use

Reference Files