review-react-best-practices

The review-react-best-practices skill provides a systematic, performance-first audit process for modern web development. Designed for React and Next.js (App Router) projects, it functions as a highly granular rule library that helps AI agents identify and resolve complex bottlenecks like network waterfalls, unnecessary re-renders, excessive bundle sizes, and inefficient data serialization. By applying a prioritized methodology—focusing on critical infrastructure wins before micro-optimizations—the skill enables developers to maintain high-performance standards throughout the software development lifecycle.

• Prioritized rule library: Evaluates issues ranging from CRITICAL (waterfalls, bundle bloat) to LOW (JS execution hot paths).
• Deep Next.js integration: Specifically tuned for App Router patterns, RSC (React Server Components) boundaries, Server Actions, and data fetching optimization.
• Actionable diagnostic output: Generates structured reports including file paths, specific rule references, impact assessments, and minimal code fix suggestions.
• Resumable workflow: Integrates with the Ship Faster execution context, ensuring audit logs and evidence are persisted for replayability and team review.
• Extensible architecture: Uses a markdown-based rule system where each check is defined in an isolated, taggable file, making it easy for teams to customize, sort, and evolve their performance standards over time.

To use this skill effectively, initiate it when refactoring components, addressing PR performance regressions, or debugging UI jank and hydration issues. Ensure your environment allows the agent to search local directories for rules using rg (ripgrep) or similar tools, and always review the generated performance reports against your project's specific constraints. The skill is best applied during CI/CD review stages or before feature deployment to ensure that code quality remains consistent and that performance degradation is caught early in the development flow.