vercel-react-best-practices

Applies Vercel performance optimization rules when writing or refactoring React and Next.js code.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/ridhijain709/AIPORSCHE --skill vercel-react-best-practices-ridhijain709
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-react-best-practices
Source: https://github.com/ridhijain709/AIPORSCHE/tree/main/.agents/skills/react-best-practices/upstream
Command: npx skills add https://github.com/ridhijain709/AIPORSCHE --skill vercel-react-best-practices-ridhijain709

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? React and Next.js codebases often suffer from slow load times, unnecessary re-renders, oversized bundles, and server-side waterfalls that are hard to spot during manual review. This Skill gives AI agents a structured, prioritized rulebook of 64 performance guidelines from Vercel Engineering so generated and refactored code follows proven optimization patterns. ## Core Features & Use Cases - Prioritized Rule Catalog: 64 rules across 8 categories ranked by impact, from critical waterfall elimination and bundle size reduction to advanced patterns like useEffectEvent. - Incorrect vs. Correct Examples: Each rule file shows a wrong implementation alongside the optimized version with explanations and impact metrics. - Quick-Reference Prefixes: Rules are organized by prefixes like async-, bundle-, server-, and rerender- for fast lookup during code review. - Use Case: When refactoring a Next.js page that fetches user, posts, and comments sequentially, the Skill directs the agent to apply async-parallel and rewrite the code with Promise.all() to cut three round trips down to one. ## Quick Start Ask the agent to review your React component or Next.js page for performance issues using the Vercel best practices rules and apply the recommended fixes.

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 optimize React and Next.js performance with AI code review?

Reference the rule catalog when writing or reviewing React code. The Skill provides 64 prioritized rules covering waterfalls, bundle size, server-side rendering, and re-renders, each with incorrect and correct code examples the agent applies directly.

What are the most critical Next.js performance optimizations?

The highest-impact rules target eliminating async waterfalls with Promise.all() and Suspense boundaries, plus reducing bundle size by avoiding barrel file imports and using next/dynamic for heavy components. These are marked CRITICAL in the rule categories.

Does this work with React Server Components and Server Actions?

Yes, the server-side category covers RSC-specific patterns including minimizing serialization at client boundaries, authenticating Server Actions like API routes, React.cache() deduplication, and parallel data fetching through component composition.

How do I avoid barrel file import performance problems?

Import directly from source files instead of package entry points, such as importing from lucide-react/dist/esm/icons/check rather than the package root. For Next.js 13.5+, the optimizePackageImports config option transforms barrel imports automatically at build time.

When should I not use Suspense boundaries for data fetching?

Avoid Suspense when data drives layout decisions, when content is SEO-critical above the fold, or when queries are small and fast. The trade-off is faster initial paint versus potential layout shift when content loads.