AGENTS.md@skills/vercel-react-best-practicesB

AGENTS.md@skills/vercel-react-best-practices from marcellocurto/skills is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add marcellocurto/skills/skills/vercel-react-best-practices/AGENTS.md@git:20261002.427fecc

Pins git:20261002.427fecc in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
marcellocurto/skills
Path
skills/vercel-react-best-practices/AGENTS.md
Versions recorded
5
Latest version
git:20261002.427fecc, committed Oct 2, 2026
First version recorded
Aug 20, 2026
Size
120,965 bytes
Repository stars
3
License
none declared

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# React Best Practices

<!-- Generated by scripts/compile-react-guidance.ts. Edit rules/ or metadata.json instead. -->

**Version 1.0.0**  
Vercel Engineering  
January 2026

Use [SKILL.md](SKILL.md) and only the rules relevant to the task. This compiled reference is for deliberate full-guide reading. Apply optimizations only for a supported performance mechanism; ratings and example gains are not measurements of the current application.

Repository-maintained React and Next.js guidance adapted from Vercel's rules. Select rules by a concrete performance mechanism and workload. Dependencies and caches are conditional options, and impact ratings prioritize investigation rather than establish application performance gains.

## Contents

1. **Eliminating Waterfalls**
   - 1.1 [Check Cheap Conditions Before Async Flags](#async-cheap-condition-before-await)
   - 1.2 [Defer Await Until Needed](#async-defer-await)
   - 1.3 [Dependency-Based Parallelization](#async-dependencies)
   - 1.4 [Prevent Waterfall Chains in API Routes](#async-api-routes)
   - 1.5 [Promise.all() for Independent Operations](#async-parallel)
   - 1.6 [Strategic Suspense Boundaries](#async-suspense-boundaries)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add marcellocurto/skills/skills/vercel-react-best-practices/AGENTS.md@sha256:d98648d77bbad1b0

The line at the top of this page pins the label git:20261002.427fecc, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_x7mflpbfnz7yzcl2.svg)](https://markdownregistry.com/a/art_x7mflpbfnz7yzcl2)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 20, 2026 and Oct 2, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261002.427fecc latest2026-10-02 427fecc 120,965 BB view · diff
git:20261002.e962f2b2026-10-02 e962f2b 120,485 BB view · diff
git:20261002.a2929d42026-10-02 a2929d4 118,323 BB view · diff
git:20260906.ccd7ead2026-09-06 ccd7ead 117,070 BB view · diff
git:20260820.83fdfde2026-08-20 83fdfde 108,261 BB view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Size between 200 bytes and 200 KB (120965 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Starting a new one? Use a template for AGENTS.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

marcellocurto/skills · 3 stars · license none declared · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x7mflpbfnz7yzcl2
GET https://markdownregistry.com/api/v1/resolve?ref=marcellocurto/skills/skills/vercel-react-best-practices/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/d98648d77bbad1b01f48b04546095447e2a792b349f2a488737d98e8c51c6b37

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from marcellocurto/skills

AGENTS.md AGENTS.md file
marcellocurto/skills · AGENTS.md
git:20261029.444423a · audit A · 3 stars
audit-code-complexity SKILL.md skill
marcellocurto/skills · skills/audit-code-complexity/SKILL.md · Find needless code complexity and suggest simpler designs that preserve behavior. Use when the user asks to simplify…
git:20261029.444423a · audit A · 3 stars
babysit-pr SKILL.md skill
marcellocurto/skills · skills/babysit-pr/SKILL.md · Review a pull request with independent agents when it has no review yet, settle its open review comments from reviewers…
git:20261029.513f5ce · audit A · 3 stars
blast-radius-audit SKILL.md skill
marcellocurto/skills · skills/blast-radius-audit/SKILL.md · Find downstream breakage a code change could cause beyond the files it directly touches. Use when the user asks what a…
git:20261029.444423a · audit A · 3 stars
code-review SKILL.md skill
marcellocurto/skills · skills/code-review/SKILL.md · Review a specific diff, pull request, or commit range for correctness, maintainability, and repository standards. Use…
git:20261029.444423a · audit A · 3 stars
codebase-design SKILL.md skill
marcellocurto/skills · skills/codebase-design/SKILL.md · Design small, type-safe interfaces that hide complexity and give domain logic a clear home. Use when designing or…
git:20261029.444423a · audit A · 3 stars
create-pull-request SKILL.md skill
marcellocurto/skills · skills/create-pull-request/SKILL.md · Open a ready-for-review GitHub pull request for completed local changes, including any needed commit and push. Use when…
git:20261029.444423a · audit A · 3 stars
diagnosing-bugs SKILL.md skill
marcellocurto/skills · skills/diagnosing-bugs/SKILL.md · Reproduce, isolate, and fix difficult bugs or performance regressions. Use when a bug, failure, or slowdown has no…
git:20261029.444423a · audit A · 3 stars
domain-modeling SKILL.md skill
marcellocurto/skills · skills/domain-modeling/SKILL.md · Define and maintain the codebase's shared domain terms and architectural decisions. Use when a domain term is unclear…
git:20261029.444423a · audit A · 3 stars
explain-codebase SKILL.md skill
marcellocurto/skills · skills/explain-codebase/SKILL.md · Trace and explain how an existing code path or subsystem works. Use when the user asks how some code, feature, or flow…
git:20261029.444423a · audit A · 3 stars
frontend-design SKILL.md skill
marcellocurto/skills · skills/frontend-design/SKILL.md · Choose the visual direction, typography, layout, and interface copy for UI work. Use when building new UI or reshaping…
git:20261029.444423a · audit A · 3 stars
grill-with-docs SKILL.md skill
marcellocurto/skills · skills/grill-with-docs/SKILL.md · Stress-test a plan through questions while recording the resulting domain terms and lasting architectural decisions…
git:20261029.444423a · audit A · 3 stars

Every file in marcellocurto/skills

Other files named AGENTS.md@skills/vercel-react-best-practices

AGENTS.md@skills/vercel-react-best-practices AGENTS.md file
coco-research/coco · skills/vercel-react-best-practices/AGENTS.md
git:20260426.d53cc6c · audit B · 629 stars
AGENTS.md@skills/vercel-react-best-practices AGENTS.md file
miladjoodi/skills · skills/vercel-react-best-practices/AGENTS.md
git:20261011.ac45e0b · audit B · 24 stars
AGENTS.md@skills/vercel-react-best-practices AGENTS.md file
dannykkh/skill-olympus · skills/vercel-react-best-practices/AGENTS.md
git:20260131.1b9fc84 · audit B · 7 stars
AGENTS.md@skills/vercel-react-best-practices AGENTS.md file
transitive-bullshit/skills · skills/vercel-react-best-practices/AGENTS.md
git:20261011.ef64499 · audit B · 4 stars

Browse by kind, by grade B, or by owner.