Communitygithub.com

ASoudy/AGS

Recommandations d'optimisation des performances React et Next.js issues de Vercel Engineering. À utiliser lors de l'écriture, la revue ou le refactoring de code React/Next.js pour garantir des modèles de performance optimaux. Se déclenche sur les tâches impliquant des composants React, des pages Next.js, la récupération de données, l'optimisation du bundle ou les améliorations de performances.

Qu'est-ce que AGS ?

Ce skill, maintenu par Vercel, fournit un guide complet d'optimisation des performances pour les applications React et Next.js. Il contient 45 règles réparties en 8 catégories, chacune priorisée par impact, afin de guider le refactoring automatisé et la génération de code. Les règles couvrent des domaines critiques tels que l'élimination des cascades de requêtes, l'optimisation de la taille du bundle, les performances côté serveur et client, ainsi que les schémas avancés. Conçu pour être utilisé avec des agents d'IA comme Claude Code ou Cursor, ce skill améliore la qualité et la rapidité des applications React et Next.js en proposant des solutions concrètes et testées.

Compatible avec~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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Meilleures pratiques React de Vercel

Guide complet d'optimisation des performances pour les applications React et Next.js, maintenu par Vercel. Contient 45 règles réparties en 8 catégories, priorisées par impact pour guider le refactoring automatisé et la génération de code.

Quand appliquer

Consultez ces directives lorsque vous :

  • Écrivez de nouveaux composants React ou pages Next.js
  • Implémentez la récupération de données (côté client ou serveur)
  • Revoyez du code pour des problèmes de performance
  • Refactorisez du code React/Next.js existant
  • Optimisez la taille du bundle ou les temps de chargement

Catégories de règles par priorité

PrioritéCatégorieImpactPréfixe
1Élimination des cascadesCRITIQUEasync-
2Optimisation de la taille du bundleCRITIQUEbundle-
3Performances côté serveurHAUTserver-
4Récupération de données côté clientMOYEN-HAUTclient-
5Optimisation des re-rendusMOYENrerender-
6Performances de renduMOYENrendering-
7Performances JavaScriptFAIBLE-MOYENjs-
8Schémas avancésFAIBLEadvanced-

Référence rapide

1. Élimination des cascades (CRITIQUE)

  • async-defer-await - Déplacer await dans les branches où il est réellement utilisé
  • async-parallel - Utiliser Promise.all() pour les opérations indépendantes
  • async-dependencies - Utiliser better-all pour les dépendances partielles
  • async-api-routes - Démarrer les promesses tôt, attendre tard dans les routes API
  • async-suspense-boundaries - Utiliser Suspense pour diffuser le contenu

2. Optimisation de la taille du bundle (CRITIQUE)

  • bundle-barrel-imports - Importer directement, éviter les fichiers baril
  • bundle-dynamic-imports - Utiliser next/dynamic pour les composants lourds
  • bundle-defer-third-party - Charger les analyses/ journaux après l'hydratation
  • bundle-conditional - Charger les modules uniquement lorsque la fonctionnalité est activée
  • bundle-preload - Précharger au survol/focus pour une vitesse perçue

3. Performances côté serveur (HAUT)

  • server-cache-react - Utiliser React.cache() pour la déduplication par requête
  • server-cache-lru - Utiliser un cache LRU pour la mise en cache inter-requêtes
  • server-serialization - Minimiser les données passées aux composants client
  • server-parallel-fetching - Restructurer les composants pour paralléliser les récupérations
  • server-after-nonblocking - Utiliser after() pour les opérations non bloquantes

4. Récupération de données côté client (MOYEN-HAUT)

  • client-swr-dedup - Utiliser SWR pour la déduplication automatique des requêtes
  • client-event-listeners - Dédupliquer les écouteurs d'événements globaux

5. Optimisation des re-rendus (MOYEN)

  • rerender-defer-reads - Ne pas s'abonner à un état utilisé uniquement dans les callbacks
  • rerender-memo - Extraire le travail coûteux dans des composants mémorisés
  • rerender-dependencies - Utiliser des dépendances primitives dans les effets
  • rerender-derived-state - S'abonner aux booléens dérivés, pas aux valeurs brutes
  • rerender-functional-setstate - Utiliser setState fonctionnel pour des callbacks stables
  • rerender-lazy-state-init - Passer une fonction à useState pour les valeurs coûteuses
  • rerender-transitions - Utiliser startTransition pour les mises à jour non urgentes

6. Performances de rendu (MOYEN)

  • rendering-animate-svg-wrapper - Animer le wrapper div, pas l'élément SVG
  • rendering-content-visibility - Utiliser content-visibility pour les longues listes
  • rendering-hoist-jsx - Extraire le JSX statique en dehors des composants
  • rendering-svg-precision - Réduire la précision des coordonnées SVG
  • rendering-hydration-no-flicker - Utiliser un script en ligne pour les données côté client
  • rendering-activity - Utiliser le composant Activity pour afficher/masquer
  • rendering-conditional-render - Utiliser l'opérateur ternaire, pas && pour les conditionnels

7. Performances JavaScript (FAIBLE-MOYEN)

  • js-batch-dom-css - Grouper les modifications CSS via des classes ou cssText
  • js-index-maps - Construire une Map pour les recherches répétées
  • js-cache-property-access - Mettre en cache les propriétés d'objets dans les boucles
  • js-cache-function-results - Mettre en cache les résultats de fonctions dans une Map au niveau module
  • js-cache-storage - Mettre en cache les lectures localStorage/sessionStorage
  • js-combine-iterations - Combiner plusieurs filter/map en une seule boucle
  • js-length-check-first - Vérifier la longueur du tableau avant une comparaison coûteuse
  • js-early-exit - Retourner tôt depuis les fonctions
  • js-hoist-regexp - Placer la création RegExp en dehors des boucles
  • js-min-max-loop - Utiliser une boucle pour min/max au lieu de sort
  • js-set-map-lookups - Utiliser Set/Map pour les recherches en O(1)
  • js-tosorted-immutable - Utiliser toSorted() pour l'immuabilité

8. Schémas avancés (FAIBLE)

  • advanced-event-handler-refs - Stocker les gestionnaires d'événements dans des refs
  • advanced-use-latest - useLatest pour des références de callback stables

Comment utiliser

Lisez les fichiers de règles individuels pour des explications détaillées et des exemples de code :

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

Chaque fichier de règle contient :

  • Une brève explication de pourquoi c'est important
  • Un exemple de code incorrect avec explication
  • Un exemple de code correct avec explication
  • Contexte supplémentaire et références

Document compilé complet

Pour le guide complet avec toutes les règles développées : 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.

Skills associés