Communitygithub.com

xzedm/clipplic-landing

Directives d'optimisation des performances React et Next.js de l'ingénierie Vercel. À utiliser lors de l'écriture, de la révision ou du refactoring de code React/Next.js pour garantir des schémas de performance optimaux.

Qu'est-ce que clipplic-landing ?

Ce skill fournit un guide complet d'optimisation des performances pour les applications React et Next.js, maintenu par l'équipe d'ingénierie de Vercel. Il contient 70 règles réparties en 8 catégories, classées par priorité d'impact pour guider le refactoring automatisé et la génération de code. Les catégories couvrent des aspects critiques comme l'élimination des cascades de requêtes (Critical), l'optimisation de la taille du bundle (Critical), les performances côté serveur (Haute) et côté client (Moyenne-Haute), ainsi que l'optimisation des re-rendus (Moyenne), les performances de rendu (Moyenne), la performance JavaScript (Basse-Moyenne) et les schémas avancés (Basse). Chaque règle est détaillée dans un fichier individuel avec des explications et des exemples de code. Le skill est déclenché lors de 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. Il est compatible avec tous les outils d'IA agent qui traitent du code React/Next.js, comme Claude Code, Cursor, ou Codex.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/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

Bonnes pratiques React de Vercel

Guide complet d'optimisation des performances pour les applications React et Next.js, maintenu par Vercel. Contient 70 règles réparties en 8 catégories, classées par priorité d'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
  • Vous implémentez la récupération de données (côté client ou serveur)
  • Vous révisez du code pour des problèmes de performance
  • Vous refactorez du code React/Next.js existant
  • Vous 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-
3Performance côté serveurHAUTEserver-
4Récupération de données côté clientMOYENNE-HAUTEclient-
5Optimisation des re-rendusMOYENNErerender-
6Performance de renduMOYENNErendering-
7Performance JavaScriptBASSE-MOYENNEjs-
8Schémas avancésBASSEadvanced-

Référence rapide

1. Élimination des cascades (CRITIQUE)

  • async-cheap-condition-before-await - Vérifiez les conditions synchrones peu coûteuses avant d'attendre des flags ou des valeurs distantes
  • async-defer-await - Déplacez await dans les branches où il est réellement utilisé
  • async-parallel - Utilisez Promise.all() pour les opérations indépendantes
  • async-dependencies - Utilisez better-all pour les dépendances partielles
  • async-api-routes - Lancez les promesses tôt, attendez tard dans les routes d'API
  • async-suspense-boundaries - Utilisez Suspense pour diffuser le contenu

2. Optimisation de la taille du bundle (CRITIQUE)

  • bundle-barrel-imports - Importez directement, évitez les fichiers barrel
  • bundle-analyzable-paths - Préférez les chemins d'import et de système de fichiers statiquement analysables pour éviter les bundles et les traces trop larges
  • bundle-dynamic-imports - Utilisez next/dynamic pour les composants lourds
  • bundle-defer-third-party - Chargez l'analyse/le logging après l'hydratation
  • bundle-conditional - Chargez les modules uniquement lorsque la fonctionnalité est activée
  • bundle-preload - Préchargez au survol/au focus pour la vitesse perçue

3. Performance côté serveur (HAUTE)

  • server-auth-actions - Authentifiez les actions serveur comme les routes d'API
  • server-cache-react - Utilisez React.cache() pour la déduplication par requête
  • server-cache-lru - Utilisez un cache LRU pour la mise en cache inter-requêtes
  • server-dedup-props - Évitez la sérialisation en double dans les propriétés RSC
  • server-hoist-static-io - Remontez les E/S statiques (polices, logos) au niveau du module
  • server-no-shared-module-state - Évitez les états de requête mutables au niveau du module dans RSC/SSR
  • server-serialization - Minimisez les données passées aux composants client
  • server-parallel-fetching - Restructurez les composants pour paralléliser les récupérations
  • server-parallel-nested-fetching - Enchaînez les récupérations imbriquées par élément dans Promise.all
  • server-after-nonblocking - Utilisez after() pour les opérations non bloquantes

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

  • client-swr-dedup - Utilisez SWR pour la déduplication automatique des requêtes
  • client-event-listeners - Dédupliquez les écouteurs d'événements globaux
  • client-passive-event-listeners - Utilisez des écouteurs passifs pour le défilement
  • client-localstorage-schema - Versionnez et minimisez les données localStorage

5. Optimisation des re-rendus (MOYENNE)

  • rerender-defer-reads - Ne vous abonnez pas à un état utilisé uniquement dans les callbacks
  • rerender-memo - Extrayez le travail coûteux dans des composants mémorisés
  • rerender-memo-with-default-value - Remontez les propriétés non primitives par défaut
  • rerender-dependencies - Utilisez des dépendances primitives dans les effets
  • rerender-derived-state - Abonnez-vous aux booléens dérivés, pas aux valeurs brutes
  • rerender-derived-state-no-effect - Dérivez l'état pendant le rendu, pas dans les effets
  • rerender-functional-setstate - Utilisez setState fonctionnel pour des callbacks stables
  • rerender-lazy-state-init - Passez une fonction à useState pour les valeurs coûteuses
  • rerender-simple-expression-in-memo - Évitez memo pour les primitives simples
  • rerender-split-combined-hooks - Séparez les hooks avec des dépendances indépendantes
  • rerender-move-effect-to-event - Placez la logique d'interaction dans les gestionnaires d'événements
  • rerender-transitions - Utilisez startTransition pour les mises à jour non urgentes
  • rerender-use-deferred-value - Différez les rendus coûteux pour garder l'entrée réactive
  • rerender-use-ref-transient-values - Utilisez des refs pour les valeurs transitoires fréquentes
  • rerender-no-inline-components - Ne définissez pas de composants à l'intérieur d'autres composants

6. Performance de rendu (MOYENNE)

  • rendering-animate-svg-wrapper - Animez un wrapper div, pas l'élément SVG
  • rendering-content-visibility - Utilisez content-visibility pour les longues listes
  • rendering-hoist-jsx - Extrayez le JSX statique à l'extérieur des composants
  • rendering-svg-precision - Réduisez la précision des coordonnées SVG
  • rendering-hydration-no-flicker - Utilisez un script en ligne pour les données côté client uniquement
  • rendering-hydration-suppress-warning - Supprimez les avertissements de discordance attendus
  • rendering-activity - Utilisez le composant Activity pour afficher/masquer
  • rendering-conditional-render - Utilisez l'opérateur ternaire, pas &&, pour les conditionnelles
  • rendering-usetransition-loading - Préférez useTransition pour l'état de chargement
  • rendering-resource-hints - Utilisez les indications de ressources React DOM pour le préchargement
  • rendering-script-defer-async - Utilisez defer ou async sur les balises script

7. Performance JavaScript (BASSE-MOYENNE)

  • js-batch-dom-css - Regroupez les modifications CSS via des classes ou cssText
  • js-index-maps - Construisez une Map pour les recherches répétées
  • js-cache-property-access - Mettez en cache les propriétés d'objet dans les boucles
  • js-cache-function-results - Mettez en cache les résultats de fonction dans une Map au niveau du module
  • js-cache-storage - Mettez en cache les lectures de localStorage/sessionStorage
  • js-combine-iterations - Combinez plusieurs filter/map en une seule boucle
  • js-length-check-first - Vérifiez la longueur d'un tableau avant une comparaison coûteuse
  • js-early-exit - Retournez tôt des fonctions
  • js-hoist-regexp - Remontez la création de RegExp en dehors des boucles
  • js-min-max-loop - Utilisez une boucle pour min/max au lieu de sort
  • js-set-map-lookups - Utilisez Set/Map pour les recherches en O(1)
  • js-tosorted-immutable - Utilisez toSorted() pour l'immuabilité
  • js-flatmap-filter - Utilisez flatMap pour mapper et filtrer en un seul passage
  • js-request-idle-callback - Différez le travail non critique au temps d'inactivité du navigateur

8. Schémas avancés (BASSE)

  • advanced-effect-event-deps - Ne mettez pas les résultats de useEffectEvent dans les dépendances de l'effet
  • advanced-event-handler-refs - Stockez les gestionnaires d'événements dans des refs
  • advanced-init-once - Initialisez l'application une fois par chargement
  • advanced-use-latest - useLatest pour des refs de callback stables

Comment utiliser

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

rules/async-parallel.md
rules/bundle-barrel-imports.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 complet compilé

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.

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 associés