vercel-react-best-practices

Applies React and Next.js performance optimization rules during code writing, review, and refactoring.

1|Updated Jun 30, 2026
One-click install
npx skills add https://github.com/trutoman/Conjuros --skill vercel-react-best-practices-trutoman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-react-best-practices
Source: https://github.com/trutoman/Conjuros/tree/main/.agents/skills/react-best-practices
Command: npx skills add https://github.com/trutoman/Conjuros --skill vercel-react-best-practices-trutoman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? React and Next.js codebases often suffer from performance issues like async waterfalls, bloated bundles, unnecessary re-renders, and inefficient data fetching. This Skill provides a structured, prioritized rule set from Vercel Engineering so AI agents and developers consistently apply proven optimization patterns instead of rediscovering them. ## Core Features & Use Cases - 70 Prioritized Rules Across 8 Categories: Covers eliminating waterfalls, bundle size optimization, server-side performance, client-side data fetching, re-render optimization, rendering performance, JavaScript performance, and advanced patterns, each tagged by impact level from CRITICAL to LOW. - Incorrect vs. Correct Code Examples: Every rule includes concrete TypeScript/TSX examples showing the wrong pattern, the right pattern, and the reasoning behind it. - Use Case: When refactoring a Next.js page that fetches user, posts, and comments sequentially, the Skill directs you to wrap independent calls in Promise.all(), add Suspense boundaries for streaming, and avoid barrel file imports to cut bundle size. ## Quick Start Ask the AI to review your React component or Next.js page for performance issues using the Vercel React best practices rules.

Frequently Asked Questions about vercel-react-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I eliminate async waterfalls in React and Next.js?

Use Promise.all() for independent async operations so they run concurrently instead of sequentially. For partial dependencies, start promises early and await late, or use the better-all library to maximize parallelism automatically.

How to reduce bundle size in a Next.js application?

Avoid barrel file imports from libraries like lucide-react or @mui/material, use next/dynamic to lazy-load heavy components, and defer non-critical third-party scripts like analytics until after hydration. Next.js 13.5+ can optimize package imports automatically.

Does this guide cover React Server Components performance?

Yes, it includes server-side rules for RSC such as minimizing serialization at client boundaries, avoiding duplicate serialization of props, per-request deduplication with React.cache(), and avoiding shared module state for request data.

When should I not use Suspense boundaries for data fetching?

Avoid Suspense when data is critical for layout decisions, when content is SEO-critical above the fold, when queries are small and fast, or when you want to prevent layout shift between loading and loaded states.

What is the difference between useTransition and useDeferredValue?

useTransition marks state updates as non-urgent so urgent updates like typing stay responsive, while useDeferredValue defers re-rendering of an expensive derived value. Both keep the UI responsive during heavy renders.