Communitygithub.com

xzedm/clipplic-landing

Guía de optimización de rendimiento para React y Next.js de Vercel Engineering. Esta habilidad se debe usar al escribir, revisar o refactorizar código React/Next.js para garantizar patrones de rendimiento óptimos. Se activa en tareas que involucran componentes React, páginas Next.js, obtención de datos, optimización de paquetes o mejoras de rendimiento.

¿Qué es clipplic-landing?

Esta habilidad proporciona una guía completa de optimización de rendimiento para aplicaciones React y Next.js, mantenida por Vercel. Contiene 70 reglas organizadas en 8 categorías, priorizadas por impacto para guiar la refactorización automatizada y la generación de código. Es útil para desarrolladores que escriben nuevos componentes, implementan obtención de datos, revisan código en busca de problemas de rendimiento u optimizan el tamaño del paquete. La guía cubre áreas críticas como la eliminación de cascadas (waterfalls) con async/await paralelo, optimización del tamaño del paquete mediante importaciones directas y carga dinámica, rendimiento del lado del servidor con almacenamiento en caché y serialización, y optimización de re-renderizados con React.memo y hooks como useDeferredValue. Compatible con cualquier proyecto React o Next.js, se puede consultar en archivos de reglas individuales o en el documento compilado completo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/vercel-react-best-practices

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Mejores Prácticas de React de Vercel

Guía completa de optimización de rendimiento para aplicaciones React y Next.js, mantenida por Vercel. Contiene 70 reglas en 8 categorías, priorizadas por impacto para guiar la refactorización automatizada y la generación de código.

Cuándo Aplicar

Consulte estas pautas cuando:

  • Escriba nuevos componentes React o páginas Next.js
  • Implemente obtención de datos (del lado del cliente o del servidor)
  • Revise código en busca de problemas de rendimiento
  • Refactorice código React/Next.js existente
  • Optimice el tamaño del paquete o los tiempos de carga

Categorías de Reglas por Prioridad

PrioridadCategoríaImpactoPrefijo
1Eliminación de CascadasCRÍTICOasync-
2Optimización del Tamaño del PaqueteCRÍTICObundle-
3Rendimiento del Lado del ServidorALTOserver-
4Obtención de Datos del Lado del ClienteMEDIO-ALTOclient-
5Optimización de Re-renderizadosMEDIOrerender-
6Rendimiento de RenderizadoMEDIOrendering-
7Rendimiento de JavaScriptBAJO-MEDIOjs-
8Patrones AvanzadosBAJOadvanced-

Referencia Rápida

1. Eliminación de Cascadas (CRÍTICO)

  • async-cheap-condition-before-await - Verifique condiciones sincrónicas baratas antes de esperar banderas o valores remotos
  • async-defer-await - Mueva await a las ramas donde realmente se usa
  • async-parallel - Use Promise.all() para operaciones independientes
  • async-dependencies - Use better-all para dependencias parciales
  • async-api-routes - Inicie las promesas temprano, espere tarde en rutas API
  • async-suspense-boundaries - Use Suspense para transmitir contenido

2. Optimización del Tamaño del Paquete (CRÍTICO)

  • bundle-barrel-imports - Importe directamente, evite archivos barrel
  • bundle-analyzable-paths - Prefiera rutas de importación y archivos estáticamente analizables para evitar paquetes y trazas amplias
  • bundle-dynamic-imports - Use next/dynamic para componentes pesados
  • bundle-defer-third-party - Cargue análisis/registro después de la hidratación
  • bundle-conditional - Cargue módulos solo cuando la característica esté activada
  • bundle-preload - Precargue al pasar el ratón/enfocar para velocidad percibida

3. Rendimiento del Lado del Servidor (ALTO)

  • server-auth-actions - Autentique acciones del servidor como rutas API
  • server-cache-react - Use React.cache() para deduplicación por solicitud
  • server-cache-lru - Use caché LRU para almacenamiento en caché entre solicitudes
  • server-dedup-props - Evite serialización duplicada en props RSC
  • server-hoist-static-io - Eleve E/S estática (fuentes, logotipos) al nivel del módulo
  • server-no-shared-module-state - Evite estado de solicitud mutable a nivel de módulo en RSC/SSR
  • server-serialization - Minimice los datos pasados a componentes del cliente
  • server-parallel-fetching - Reestructure componentes para paralelizar las obtenciones
  • server-parallel-nested-fetching - Encadene obtenciones anidadas por elemento en Promise.all
  • server-after-nonblocking - Use after() para operaciones no bloqueantes

4. Obtención de Datos del Lado del Cliente (MEDIO-ALTO)

  • client-swr-dedup - Use SWR para deduplicación automática de solicitudes
  • client-event-listeners - Deduplicar listeners de eventos globales
  • client-passive-event-listeners - Use listeners pasivos para scroll
  • client-localstorage-schema - Versione y minimice los datos de localStorage

5. Optimización de Re-renderizados (MEDIO)

  • rerender-defer-reads - No se suscriba a estado usado solo en callbacks
  • rerender-memo - Extraiga trabajo costoso en componentes memoizados
  • rerender-memo-with-default-value - Eleve props no primitivas por defecto
  • rerender-dependencies - Use dependencias primitivas en efectos
  • rerender-derived-state - Suscríbase a booleanos derivados, no a valores brutos
  • rerender-derived-state-no-effect - Derive estado durante el renderizado, no en efectos
  • rerender-functional-setstate - Use setState funcional para callbacks estables
  • rerender-lazy-state-init - Pase función a useState para valores costosos
  • rerender-simple-expression-in-memo - Evite memo para primitivos simples
  • rerender-split-combined-hooks - Divida hooks con dependencias independientes
  • rerender-move-effect-to-event - Ponga la lógica de interacción en manejadores de eventos
  • rerender-transitions - Use startTransition para actualizaciones no urgentes
  • rerender-use-deferred-value - Difiera renderizados costosos para mantener la entrada receptiva
  • rerender-use-ref-transient-values - Use refs para valores transitorios frecuentes
  • rerender-no-inline-components - No defina componentes dentro de componentes

6. Rendimiento de Renderizado (MEDIO)

  • rendering-animate-svg-wrapper - Anime el contenedor div, no el elemento SVG
  • rendering-content-visibility - Use content-visibility para listas largas
  • rendering-hoist-jsx - Extraiga JSX estático fuera de los componentes
  • rendering-svg-precision - Reduzca la precisión de coordenadas SVG
  • rendering-hydration-no-flicker - Use script en línea para datos solo del cliente
  • rendering-hydration-suppress-warning - Suprima diferencias esperadas
  • rendering-activity - Use el componente Activity para mostrar/ocultar
  • rendering-conditional-render - Use operador ternario, no && para condicionales
  • rendering-usetransition-loading - Prefiera useTransition para estado de carga
  • rendering-resource-hints - Use sugerencias de recursos de React DOM para precarga
  • rendering-script-defer-async - Use defer o async en etiquetas script

7. Rendimiento de JavaScript (BAJO-MEDIO)

  • js-batch-dom-css - Agrupe cambios de CSS mediante clases o cssText
  • js-index-maps - Construya Map para búsquedas repetidas
  • js-cache-property-access - Almacene en caché propiedades de objetos en bucles
  • js-cache-function-results - Almacene en caché resultados de funciones en Map a nivel de módulo
  • js-cache-storage - Almacene en caché lecturas de localStorage/sessionStorage
  • js-combine-iterations - Combine múltiples filter/map en un solo bucle
  • js-length-check-first - Verifique la longitud del array antes de una comparación costosa
  • js-early-exit - Retorne temprano de funciones
  • js-hoist-regexp - Eleve la creación de RegExp fuera de bucles
  • js-min-max-loop - Use bucle para min/max en lugar de sort
  • js-set-map-lookups - Use Set/Map para búsquedas O(1)
  • js-tosorted-immutable - Use toSorted() para inmutabilidad
  • js-flatmap-filter - Use flatMap para mapear y filtrar en un solo paso
  • js-request-idle-callback - Difiera trabajo no crítico al tiempo de inactividad del navegador

8. Patrones Avanzados (BAJO)

  • advanced-effect-event-deps - No ponga resultados de useEffectEvent en dependencias de efecto
  • advanced-event-handler-refs - Almacene manejadores de eventos en refs
  • advanced-init-once - Inicialice la aplicación una vez por carga
  • advanced-use-latest - useLatest para referencias de callback estables

Cómo Usar

Lea archivos de reglas individuales para explicaciones detalladas y ejemplos de código:

reglas/async-parallel.md
reglas/bundle-barrel-imports.md

Cada archivo de regla contiene:

  • Breve explicación de por qué es importante
  • Ejemplo de código incorrecto con explicación
  • Ejemplo de código correcto con explicación
  • Contexto adicional y referencias

Documento Compilado Completo

Para la guía completa con todas las reglas expandidas: AGENTS.md

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

Skills relacionados