check-perf

Audit Next.js bundle sizes, client directives, imports, lazy loading, and images.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/SumitRajpal/nextjs-claude-architecture --skill check-perf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-perf
Source: https://github.com/SumitRajpal/nextjs-claude-architecture/tree/main/.claude/skills/check-perf
Command: npx skills add https://github.com/SumitRajpal/nextjs-claude-architecture --skill check-perf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits Next.js projects to identify performance bottlenecks and opportunities for optimization, by analyzing bundle sizes, client usage, and common anti-patterns.

Core Features & Use Cases

  • Bundle analysis: measures route and chunk sizes from a production build and flags burdensome routes.
  • Client-audit: scans for "use client" directives and highlights unnecessary client-side code patterns.
  • Heavy-imports: detects large or rarely used imports and suggests tree-shaking or alternatives.
  • Lazy loading & Suspense: identifies components loaded too early and recommends dynamic imports and suspense boundaries.
  • Image optimization checks: flags non-optimized images and missing next/image usage.

Quick Start

Run the check-perf skill against your Next.js project to generate a comprehensive performance audit report.

Frequently Asked Questions about check-perf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit Next.js performance and find bundle bottlenecks?

Auditing Next.js performance involves analyzing production builds to measure route and chunk sizes, flagging burdensome routes. This process identifies large bundles and highlights optimization opportunities across your application.

How can I detect unnecessary use client directives in my Next.js app?

Detecting unnecessary use client directives requires scanning your Next.js project for client-side code patterns. A client-audit highlights components that push server-side logic to the client unnecessarily, helping you optimize server and client boundaries.

What is the best way to identify heavy imports and missing lazy loading in Next.js?

Identifying heavy imports and missing lazy loading involves detecting large or rarely used imports to suggest tree-shaking, and identifying components loaded too early to recommend dynamic imports and Suspense boundaries for optimized loading.

Does this Next.js performance audit check image optimization and next/image usage?

Yes, Next.js performance audits include image optimization checks that flag non-optimized images and missing next/image usage. This ensures your application handles media efficiently and follows framework-specific best practices.

Can I use this bundle analysis on a typical Next.js app with routes and pages?

Yes, you can apply this bundle analysis to typical Next.js apps with routes and pages. It is designed to identify routes with large bundles, unnecessary client code, and missed lazy loading across both server and client code.

Why do I need Suspense boundary verification for Next.js performance?

Suspense boundary verification is needed to ensure components are not loaded too early. By verifying these boundaries, you can implement dynamic imports correctly, preventing performance bottlenecks and improving overall page load times.