vercel-react-best-practices
70 prioritised React and Next.js performance rules from Vercel, markdown only. One rule suggests adding an npm package — check it first.
Verified · Repo on GitHub
What it does
A prioritised performance guide for React and Next.js that the agent consults while writing or reviewing code: 70 rules in 8 categories, from "eliminating waterfalls" and bundle size (critical) down to advanced patterns (low). Each rule has its own file in rules/, and a compiled AGENTS.md holds them all.
Who made it / license / last checked
Vercel (vercel-labs/agent-skills) · License: MIT per the SKILL.md frontmatter; we found no LICENSE file at the repo root in our clone · Skill version 1.0.0 · Repo last commit checked: 2026-10-27
Install
npx skills add vercel-labs/agent-skillsFrom the repo README, which installs the whole pack; the folder is skills/react-best-practices while the skill's name is vercel-react-best-practices. We did not run the installer.
What files / scripts it runs
SKILL.md (7,251 bytes), a 108 KB AGENTS.md, 72 markdown files in rules/ and a metadata.json. No scripts. The model invokes it on its own whenever it touches React or Next.js code.
Pros
- Concrete, prioritised rules instead of generic "write fast code"
- Markdown only: nothing executes
- Maintained by the team that builds Next.js
Cons
- The 108 KB AGENTS.md is a lot of context if the agent loads it whole
- Rule
async-dependenciesrecommends thebetter-allnpm package: vet any new dependency before adding it - Some rules are Next.js-specific; on plain React or another framework, skip those
- No LICENSE file at the repo root; only the frontmatter says MIT
Alternatives
The React and Next.js official docs on performance; Vercel's web-design-guidelines skill from the same repo for UI rather than speed (not reviewed here).
Notes
Skills.sh listed it at 853.0K installs (#30) on 30 Oct 2026. The find-skills skill uses npx skills add vercel-labs/agent-skills@react-best-practices as its own example.
Sources
- https://github.com/vercel-labs/agent-skills/tree/main/skills/react-best-practices
- https://github.com/vercel-labs/agent-skills (README install line)
- https://www.skills.sh/ (vercel-react-best-practices listed at 853.0K, #30, when fetched 2026-10-30)
- SKILL.md, rules/ listing and metadata.json read in a local clone