vercel-labs/agent-skills

vercel-react-best-practices

Las pautas de Vercel para revisar patrones de rendimiento en React y Next.js según su impacto.

Ver código fuente

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

  1. Identifica la página o el componente, la versión del framework y el problema de comportamiento o carga que quieres investigar.
  2. Empieza por las solicitudes en cascada y el tamaño del bundle; después selecciona las otras categorías pertinentes.
  3. Lee el archivo de la regla o su explicación en AGENTS.md, no solo la línea del índice.
  4. Contrasta la propuesta con las dependencias reales, el alcance de las solicitudes, la autorización y las API disponibles.
  5. 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-practices

Información de la fuente

Documento original del Skill

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

PriorityCategoryImpactPrefix
1Eliminating WaterfallsCRITICALasync-
2Bundle Size OptimizationCRITICALbundle-
3Server-Side PerformanceHIGHserver-
4Client-Side Data FetchingMEDIUM-HIGHclient-
5Re-render OptimizationMEDIUMrerender-
6Rendering PerformanceMEDIUMrendering-
7JavaScript PerformanceLOW-MEDIUMjs-
8Advanced PatternsLOWadvanced-

Quick Reference

1. Eliminating Waterfalls (CRITICAL)

  • async-cheap-condition-before-await - Check cheap sync conditions before awaiting flags or remote values
  • async-defer-await - Move await into branches where actually used
  • async-parallel - Use Promise.all() for independent operations
  • async-dependencies - Use better-all for partial dependencies
  • async-api-routes - Start promises early, await late in API routes
  • async-suspense-boundaries - Use Suspense to stream content

2. Bundle Size Optimization (CRITICAL)

  • bundle-barrel-imports - Import directly, avoid barrel files
  • bundle-analyzable-paths - Prefer statically analyzable import and file-system paths to avoid broad bundles and traces
  • bundle-dynamic-imports - Use next/dynamic for heavy components
  • bundle-defer-third-party - Load analytics/logging after hydration
  • bundle-conditional - Load modules only when feature is activated
  • bundle-preload - Preload on hover/focus for perceived speed

3. Server-Side Performance (HIGH)

  • server-auth-actions - Authenticate server actions like API routes
  • server-cache-react - Use React.cache() for per-request deduplication
  • server-cache-lru - Use LRU cache for cross-request caching
  • server-dedup-props - Avoid duplicate serialization in RSC props
  • server-hoist-static-io - Hoist static I/O (fonts, logos) to module level
  • server-no-shared-module-state - Avoid module-level mutable request state in RSC/SSR
  • server-serialization - Minimize data passed to client components
  • server-parallel-fetching - Restructure components to parallelize fetches
  • server-parallel-nested-fetching - Chain nested fetches per item in Promise.all
  • server-after-nonblocking - Use after() for non-blocking operations

4. Client-Side Data Fetching (MEDIUM-HIGH)

  • client-swr-dedup - Use SWR for automatic request deduplication
  • client-event-listeners - Deduplicate global event listeners
  • client-passive-event-listeners - Use passive listeners for scroll
  • client-localstorage-schema - Version and minimize localStorage data

5. Re-render Optimization (MEDIUM)

  • rerender-defer-reads - Don't subscribe to state only used in callbacks
  • rerender-memo - Extract expensive work into memoized components
  • rerender-memo-with-default-value - Hoist default non-primitive props
  • rerender-dependencies - Use primitive dependencies in effects
  • rerender-derived-state - Subscribe to derived booleans, not raw values
  • rerender-derived-state-no-effect - Derive state during render, not effects
  • rerender-functional-setstate - Use functional setState for stable callbacks
  • rerender-lazy-state-init - Pass function to useState for expensive values
  • rerender-simple-expression-in-memo - Avoid memo for simple primitives
  • rerender-split-combined-hooks - Split hooks with independent dependencies
  • rerender-move-effect-to-event - Put interaction logic in event handlers
  • rerender-transitions - Use startTransition for non-urgent updates
  • rerender-use-deferred-value - Defer expensive renders to keep input responsive
  • rerender-use-ref-transient-values - Use refs for transient frequent values
  • rerender-no-inline-components - Don't define components inside components

6. Rendering Performance (MEDIUM)

  • rendering-animate-svg-wrapper - Animate div wrapper, not SVG element
  • rendering-content-visibility - Use content-visibility for long lists
  • rendering-hoist-jsx - Extract static JSX outside components
  • rendering-svg-precision - Reduce SVG coordinate precision
  • rendering-hydration-no-flicker - Use inline script for client-only data
  • rendering-hydration-suppress-warning - Suppress expected mismatches
  • rendering-activity - Use Activity component for show/hide
  • rendering-conditional-render - Use ternary, not && for conditionals
  • rendering-usetransition-loading - Prefer useTransition for loading state
  • rendering-resource-hints - Use React DOM resource hints for preloading
  • rendering-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 cssText
  • js-index-maps - Build Map for repeated lookups
  • js-cache-property-access - Cache object properties in loops
  • js-cache-function-results - Cache function results in module-level Map
  • js-cache-storage - Cache localStorage/sessionStorage reads
  • js-combine-iterations - Combine multiple filter/map into one loop
  • js-length-check-first - Check array length before expensive comparison
  • js-early-exit - Return early from functions
  • js-hoist-regexp - Hoist RegExp creation outside loops
  • js-min-max-loop - Use loop for min/max instead of sort
  • js-set-map-lookups - Use Set/Map for O(1) lookups
  • js-tosorted-immutable - Use toSorted() for immutability
  • js-flatmap-filter - Use flatMap to map and filter in one pass
  • js-request-idle-callback - Defer non-critical work to browser idle time

8. Advanced Patterns (LOW)

  • advanced-effect-event-deps - Don't put useEffectEvent results in effect deps
  • advanced-event-handler-refs - Store event handlers in refs
  • advanced-init-once - Initialize app once per app load
  • advanced-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.md

Each 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

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
vercel-labs
Oficial

web-design-guidelines

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

Instalaciones totales
889,3 mil
GitHub Stars
34,7 mil
Actualizado
20 nov
vercel-labs
Oficial

vercel-composition-patterns

React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.

Instalaciones totales
466,4 mil
GitHub Stars
34,7 mil
Actualizado
20 nov
vercel-labs
Oficial

vercel-react-native-skills

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

Instalaciones totales
285,4 mil
GitHub Stars
34,7 mil
Actualizado
20 nov
vercel-labs
Oficial

vercel-react-view-transitions

Guide for implementing smooth, native-feeling animations using React's View Transition API ( component, addTransitionType, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, startV

Instalaciones totales
199 mil
GitHub Stars
34,7 mil
Actualizado
20 nov