vercel-react-best-practices

Applies 69 Vercel performance rules when writing, reviewing, or refactoring React and Next.js code.

1|Updated Aug 18, 2026
One-click install
npx skills add https://github.com/scsm-unrestrict/dsh-frontend-engineer-agent --skill vercel-react-best-practices-scsm-unrestrict
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-react-best-practices
Source: https://github.com/scsm-unrestrict/dsh-frontend-engineer-agent/tree/main/frontend-engineer/skills/vercel-react-best-practices
Command: npx skills add https://github.com/scsm-unrestrict/dsh-frontend-engineer-agent --skill vercel-react-best-practices-scsm-unrestrict

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? React and Next.js codebases accumulate performance problems—async waterfalls, bloated bundles, unnecessary re-renders—that are hard to spot during everyday development and code review. This Skill provides a prioritized, rule-based checklist from Vercel Engineering so every component, page, and data-fetching path is written or refactored against proven optimization patterns. ## Core Features & Use Cases - 69 rules across 8 impact-ranked categories: from CRITICAL (eliminating waterfalls, bundle size) down to LOW (advanced hook patterns), each with incorrect vs. correct code examples. - On-demand rule lookup: individual rule files under rules/ (e.g., async-parallel.md, bundle-barrel-imports.md) give detailed explanations, plus a compiled AGENTS.md for the full guide. - Use Case: While reviewing a Next.js pull request, you notice sequential await calls in an API route. Apply the async-api-routes rule to start promises early and await them together, cutting response latency by 2-10x. ## Quick Start Review my React component and Next.js API route for performance issues using the Vercel best practices rules and suggest concrete 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 these rules?

Start with the CRITICAL categories: eliminate async waterfalls using Promise.all and Suspense boundaries, then reduce bundle size by avoiding barrel imports and using next/dynamic for heavy components. Each rule file shows incorrect and correct code examples.

How to fix async waterfalls in Next.js API routes?

Start independent operations immediately without awaiting them, then await the promises together with Promise.all. For partial dependencies, use the better-all library or chain promises so each task starts at the earliest possible moment.

Does this work with React Server Components and Server Actions?

Yes, it includes server-side rules for RSC serialization deduplication, React.cache per-request memoization, LRU cross-request caching, and authenticating Server Actions like public API routes. It also warns against shared module state for request data.

Why are barrel file imports slow in React projects?

Barrel files re-export thousands of modules, costing 200-800ms per import and slowing builds. Use Next.js optimizePackageImports for automatic transformation, or import directly from source paths in non-Next.js projects.

When should I not use Suspense boundaries for data fetching?

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