Descripción detallada
Este Skill ayuda a decidir por dónde empezar una revisión del rendimiento de React o Next.js. La versión fijada organiza 70 reglas en ocho categorías. Las solicitudes que esperan unas a otras y el tamaño del bundle tienen la máxima prioridad. Después aparecen el trabajo del servidor, la obtención de datos en el cliente, los nuevos renderizados, el renderizado, JavaScript y los patrones avanzados. Ese orden permite investigar dependencias y carga antes de dedicar tiempo a pequeñas reescrituras locales.
SKILL.md es el índice de entrada. Los archivos de rules/ explican cada patrón con ejemplos de código inadecuado y corregido; AGENTS.md reúne las pautas desarrolladas. Por ejemplo, async-parallel trata las operaciones independientes y bundle-barrel-imports la estructura de las importaciones. Conviene abrir la explicación correspondiente antes de aplicarla a un componente y considerar las dependencias de datos, los límites de autorización y la versión del framework.
Qué preparar
- La versión de React o Next.js, los archivos de las páginas y componentes pertinentes y la tarea concreta que se revisará.
- El código de solicitudes de datos e importaciones relacionado con la tarea; los análisis de bundle o diagnósticos existentes pueden ayudar.
- El comportamiento que debe conservarse: dependencias, límites entre servidor y cliente y requisitos de autorización.
Resultados esperados
- Sugerencias de revisión vinculadas a reglas concretas y sus categorías de impacto.
- Patrones y ejemplos de los archivos de reglas para evaluar un cambio.
- Posibles mejoras que deben comprobarse con el build, las pruebas de comportamiento y las mediciones del proyecto.
Cómo utilizarlo
- Identifica la página o el componente, la versión del framework y el problema de comportamiento o carga que quieres investigar.
- Empieza por las solicitudes en cascada y el tamaño del bundle; después selecciona las otras categorías pertinentes.
- Lee el archivo de la regla o su explicación en AGENTS.md, no solo la línea del índice.
- Contrasta la propuesta con las dependencias reales, el alcance de las solicitudes, la autorización y las API disponibles.
- Si modificas tu proyecto, limita el cambio y compara el comportamiento y los diagnósticos en las mismas condiciones.
Límites y comprobaciones
- Las operaciones paralelizadas son independientes y mantienen el orden necesario para los datos y la autorización.
- Las importaciones y la carga diferida encajan con los límites entre servidor y cliente.
- La caché no introduce estado mutable compartido entre solicitudes ni mezcla datos de usuarios distintos.
- El proyecto admite las API de React o Next.js que utiliza la regla elegida.
- Las pruebas y mediciones respaldan la propuesta; una etiqueta de impacto no es una mejora ya medida.
Preguntas frecuentes
¿Solo sirve para proyectos Next.js?
La fuente cubre React y Next.js. Las reglas de estado de componentes, nuevos renderizados y JavaScript pueden ser pertinentes para código React. Las acciones del servidor y otros patrones específicos necesitan su entorno correspondiente. Hay que elegir las reglas aplicables.
¿Basta con copiar SKILL.md?
El documento inicial remite a reglas individuales y a AGENTS.md. El asistente debe poder acceder al paquete completo para consultar las explicaciones y los ejemplos que hay detrás del índice.
¿Proporciona una puntuación de rendimiento de mi aplicación?
El paquete ofrece pautas y ejemplos, no una medición de tu aplicación. Usa tus propias herramientas de build y diagnóstico para comparar una propuesta con la versión original bajo condiciones coherentes.
Instalar este Skill
Añade este Skill desde su fuente verificada en GitHub con la Skills CLI.
npx skills add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practicesInformación de la fuente
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
Vercel React Best Practices
Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains 70 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
When to Apply
Reference these guidelines when:
- Writing new React components or Next.js pages
- Implementing data fetching (client or server-side)
- Reviewing code for performance issues
- Refactoring existing React/Next.js code
- Optimizing bundle size or load times
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Eliminating Waterfalls | CRITICAL | async- |
| 2 | Bundle Size Optimization | CRITICAL | bundle- |
| 3 | Server-Side Performance | HIGH | server- |
| 4 | Client-Side Data Fetching | MEDIUM-HIGH | client- |
| 5 | Re-render Optimization | MEDIUM | rerender- |
| 6 | Rendering Performance | MEDIUM | rendering- |
| 7 | JavaScript Performance | LOW-MEDIUM | js- |
| 8 | Advanced Patterns | LOW | advanced- |
Quick Reference
1. Eliminating Waterfalls (CRITICAL)
async-cheap-condition-before-await- Check cheap sync conditions before awaiting flags or remote valuesasync-defer-await- Move await into branches where actually usedasync-parallel- Use Promise.all() for independent operationsasync-dependencies- Use better-all for partial dependenciesasync-api-routes- Start promises early, await late in API routesasync-suspense-boundaries- Use Suspense to stream content
2. Bundle Size Optimization (CRITICAL)
bundle-barrel-imports- Import directly, avoid barrel filesbundle-analyzable-paths- Prefer statically analyzable import and file-system paths to avoid broad bundles and tracesbundle-dynamic-imports- Use next/dynamic for heavy componentsbundle-defer-third-party- Load analytics/logging after hydrationbundle-conditional- Load modules only when feature is activatedbundle-preload- Preload on hover/focus for perceived speed
3. Server-Side Performance (HIGH)
server-auth-actions- Authenticate server actions like API routesserver-cache-react- Use React.cache() for per-request deduplicationserver-cache-lru- Use LRU cache for cross-request cachingserver-dedup-props- Avoid duplicate serialization in RSC propsserver-hoist-static-io- Hoist static I/O (fonts, logos) to module levelserver-no-shared-module-state- Avoid module-level mutable request state in RSC/SSRserver-serialization- Minimize data passed to client componentsserver-parallel-fetching- Restructure components to parallelize fetchesserver-parallel-nested-fetching- Chain nested fetches per item in Promise.allserver-after-nonblocking- Use after() for non-blocking operations
4. Client-Side Data Fetching (MEDIUM-HIGH)
client-swr-dedup- Use SWR for automatic request deduplicationclient-event-listeners- Deduplicate global event listenersclient-passive-event-listeners- Use passive listeners for scrollclient-localstorage-schema- Version and minimize localStorage data
5. Re-render Optimization (MEDIUM)
rerender-defer-reads- Don't subscribe to state only used in callbacksrerender-memo- Extract expensive work into memoized componentsrerender-memo-with-default-value- Hoist default non-primitive propsrerender-dependencies- Use primitive dependencies in effectsrerender-derived-state- Subscribe to derived booleans, not raw valuesrerender-derived-state-no-effect- Derive state during render, not effectsrerender-functional-setstate- Use functional setState for stable callbacksrerender-lazy-state-init- Pass function to useState for expensive valuesrerender-simple-expression-in-memo- Avoid memo for simple primitivesrerender-split-combined-hooks- Split hooks with independent dependenciesrerender-move-effect-to-event- Put interaction logic in event handlersrerender-transitions- Use startTransition for non-urgent updatesrerender-use-deferred-value- Defer expensive renders to keep input responsivererender-use-ref-transient-values- Use refs for transient frequent valuesrerender-no-inline-components- Don't define components inside components
6. Rendering Performance (MEDIUM)
rendering-animate-svg-wrapper- Animate div wrapper, not SVG elementrendering-content-visibility- Use content-visibility for long listsrendering-hoist-jsx- Extract static JSX outside componentsrendering-svg-precision- Reduce SVG coordinate precisionrendering-hydration-no-flicker- Use inline script for client-only datarendering-hydration-suppress-warning- Suppress expected mismatchesrendering-activity- Use Activity component for show/hiderendering-conditional-render- Use ternary, not && for conditionalsrendering-usetransition-loading- Prefer useTransition for loading staterendering-resource-hints- Use React DOM resource hints for preloadingrendering-script-defer-async- Use defer or async on script tags
7. JavaScript Performance (LOW-MEDIUM)
js-batch-dom-css- Group CSS changes via classes or cssTextjs-index-maps- Build Map for repeated lookupsjs-cache-property-access- Cache object properties in loopsjs-cache-function-results- Cache function results in module-level Mapjs-cache-storage- Cache localStorage/sessionStorage readsjs-combine-iterations- Combine multiple filter/map into one loopjs-length-check-first- Check array length before expensive comparisonjs-early-exit- Return early from functionsjs-hoist-regexp- Hoist RegExp creation outside loopsjs-min-max-loop- Use loop for min/max instead of sortjs-set-map-lookups- Use Set/Map for O(1) lookupsjs-tosorted-immutable- Use toSorted() for immutabilityjs-flatmap-filter- Use flatMap to map and filter in one passjs-request-idle-callback- Defer non-critical work to browser idle time
8. Advanced Patterns (LOW)
advanced-effect-event-deps- Don't putuseEffectEventresults in effect depsadvanced-event-handler-refs- Store event handlers in refsadvanced-init-once- Initialize app once per app loadadvanced-use-latest- useLatest for stable callback refs
How to Use
Read individual rule files for detailed explanations and code examples:
rules/async-parallel.md
rules/bundle-barrel-imports.mdEach rule file contains:
- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md

