← Explore all skills

WEB DEVELOPMENT / Vercel

Vercel React Best Practices

Organizes React and Next.js performance reviews around request waterfalls, bundles, server work and rendering costs.

“React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance”

01 / THE REASONING

Why this made the selection.

  • Pairs rules with incorrect and corrected code, making recommendations easier to inspect.
  • Prioritizes serial data fetching and unnecessary imports before smaller JavaScript changes.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/react-best-practices/SKILL.md
  • skills/react-best-practices/rules/async-parallel.md
  • skills/react-best-practices/rules/bundle-barrel-imports.md
  • README.md

Our findings

  • The parallel-fetch example applies only to operations without data dependencies.
  • The barrel-import reference prefers framework import optimization where available and warns that deep paths may lack TypeScript declarations.
  • The definition indexes focused rules and points to an expanded guide; it does not run a profiler.
  • The rule index distinguishes per-request deduplication from cross-request caches and explicitly warns against mutable module request state in SSR.

Not established by this review

  • Source inspection only; no skill installation or workflow execution was performed.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/vercel-labs/agent-skills/tree/063bee94c3f4df8453406c830b0a7df0f2860278/skills/react-best-practices
  1. Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
  2. Choose your AI tools and project or global scope in the installer, then review its permissions before using the skill.

Before you start

  • Node.js/npm for this installer
  • An agent that supports the Agent Skills format
  • Project source, installed dependency versions and a way to measure the affected behavior

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/skills/react-best-practices/SKILL.md

    Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access

  2. https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/skills/react-best-practices/rules/async-parallel.md

    Supports: review, limitations, access

  3. https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/skills/react-best-practices/rules/bundle-barrel-imports.md

    Supports: review, limitations, access

  4. https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/README.md

    Supports: license

  5. https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/README.md

    Supports: install, compatibility, access

  6. https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md

    Supports: install

  7. https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts

    Supports: install

Evidence & Ask