Communitygithub.com

ASoudy/AGS

Diretrizes de otimização de desempenho para React e Next.js da Vercel Engineering. Use esta skill ao escrever, revisar ou refatorar código React/Next.js para garantir padrões ideais de desempenho. Ativa em tarefas envolvendo componentes React, páginas Next.js, busca de dados, otimização de bundle ou melhorias de desempenho.

O que é AGS?

Esta skill, mantida pela Vercel, fornece um guia abrangente de otimização de desempenho para aplicações React e Next.js, contendo 45 regras distribuídas em 8 categorias priorizadas por impacto. Ela é acionada automaticamente em tarefas de escrita, revisão ou refatoração de código que envolvam componentes React, páginas Next.js, busca de dados (tanto no cliente quanto no servidor), otimização de bundle e melhorias de desempenho em geral. As categorias vão desde eliminação de waterfalls críticos e otimização de bundle até padrões avançados de baixa prioridade, cada uma com regras específicas e exemplos de código. O guia é útil para desenvolvedores que desejam seguir as melhores práticas recomendadas pelo time de engenharia da Vercel, garantindo aplicações mais rápidas e eficientes. Para detalhes completos, consulte o arquivo `AGENTS.md`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/vercel-react-best-practices

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Melhores Práticas React da Vercel

Guia abrangente de otimização de desempenho para aplicações React e Next.js, mantido pela Vercel. Contém 45 regras em 8 categorias, priorizadas por impacto para orientar refatoração automatizada e geração de código.

Quando Aplicar

Consulte estas diretrizes quando:

  • Escrevendo novos componentes React ou páginas Next.js
  • Implementando busca de dados (no cliente ou no servidor)
  • Revisando código em busca de problemas de desempenho
  • Refatorando código React/Next.js existente
  • Otimizando tamanho do bundle ou tempos de carregamento

Categorias de Regras por Prioridade

PrioridadeCategoriaImpactoPrefixo
1Eliminando WaterfallsCRÍTICOasync-
2Otimização de Tamanho do BundleCRÍTICObundle-
3Desempenho no ServidorALTOserver-
4Busca de Dados no ClienteMÉDIO-ALTOclient-
5Otimização de Re-renderizaçãoMÉDIOrerender-
6Desempenho de RenderizaçãoMÉDIOrendering-
7Desempenho JavaScriptBAIXO-MÉDIOjs-
8Padrões AvançadosBAIXOadvanced-

Referência Rápida

1. Eliminando Waterfalls (CRÍTICO)

  • async-defer-await - Mova await para branches onde é realmente usado
  • async-parallel - Use Promise.all() para operações independentes
  • async-dependencies - Use better-all para dependências parciais
  • async-api-routes - Inicie promises cedo, espere tarde em rotas de API
  • async-suspense-boundaries - Use Suspense para fazer streaming de conteúdo

2. Otimização de Tamanho do Bundle (CRÍTICO)

  • bundle-barrel-imports - Importe diretamente, evite arquivos barrel
  • bundle-dynamic-imports - Use next/dynamic para componentes pesados
  • bundle-defer-third-party - Carregue analytics/logging após a hidratação
  • bundle-conditional - Carregue módulos apenas quando a funcionalidade estiver ativada
  • bundle-preload - Pré-carregue ao passar o mouse/foco para velocidade percebida

3. Desempenho no Servidor (ALTO)

  • server-cache-react - Use React.cache() para desduplicação por requisição
  • server-cache-lru - Use cache LRU para cache entre requisições
  • server-serialization - Minimize dados passados para componentes cliente
  • server-parallel-fetching - Reestruture componentes para paralelizar buscas
  • server-after-nonblocking - Use after() para operações não bloqueantes

4. Busca de Dados no Cliente (MÉDIO-ALTO)

  • client-swr-dedup - Use SWR para desduplicação automática de requisições
  • client-event-listeners - Desduplique listeners de eventos globais

5. Otimização de Re-renderização (MÉDIO)

  • rerender-defer-reads - Não se inscreva em estado usado apenas em callbacks
  • rerender-memo - Extraia trabalho caro em componentes memoizados
  • rerender-dependencies - Use dependências primitivas em effects
  • rerender-derived-state - Inscreva-se em booleanos derivados, não em valores brutos
  • rerender-functional-setstate - Use setState funcional para callbacks estáveis
  • rerender-lazy-state-init - Passe função para useState para valores caros
  • rerender-transitions - Use startTransition para atualizações não urgentes

6. Desempenho de Renderização (MÉDIO)

  • rendering-animate-svg-wrapper - Anime o wrapper div, não o elemento SVG
  • rendering-content-visibility - Use content-visibility para listas longas
  • rendering-hoist-jsx - Extraia JSX estático para fora dos componentes
  • rendering-svg-precision - Reduza a precisão das coordenadas SVG
  • rendering-hydration-no-flicker - Use script inline para dados apenas do cliente
  • rendering-activity - Use o componente Activity para mostrar/esconder
  • rendering-conditional-render - Use ternário, não && para condicionais

7. Desempenho JavaScript (BAIXO-MÉDIO)

  • js-batch-dom-css - Agrupe mudanças de CSS via classes ou cssText
  • js-index-maps - Construa Map para buscas repetidas
  • js-cache-property-access - Armazene em cache propriedades de objetos em loops
  • js-cache-function-results - Armazene em cache resultados de funções em Map no nível do módulo
  • js-cache-storage - Armazene em cache leituras de localStorage/sessionStorage
  • js-combine-iterations - Combine múltiplos filter/map em um único loop
  • js-length-check-first - Verifique o comprimento do array antes de comparação cara
  • js-early-exit - Retorne cedo de funções
  • js-hoist-regexp - Eleve a criação de RegExp para fora dos loops
  • js-min-max-loop - Use loop para min/max em vez de sort
  • js-set-map-lookups - Use Set/Map para buscas O(1)
  • js-tosorted-immutable - Use toSorted() para imutabilidade

8. Padrões Avançados (BAIXO)

  • advanced-event-handler-refs - Armazene handlers de eventos em refs
  • advanced-use-latest - useLatest para refs de callback estáveis

Como Usar

Leia os arquivos de regras individuais para explicações detalhadas e exemplos de código:

rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md

Cada arquivo de regra contém:

  • Breve explicação de por que é importante
  • Exemplo de código incorreto com explicação
  • Exemplo de código correto com explicação
  • Contexto adicional e referências

Documento Compilado Completo

Para o guia completo com todas as regras expandidas: AGENTS.md

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Habilidades Relacionadas