Performance Agent

Analyze Next.js 14+ apps for performance bottlenecks and misconfigurations affecting Core Web Vitals.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies performance bottlenecks and misconfigurations in Next.js 14+ apps to improve Core Web Vitals.

Core Features & Use Cases

  • Analyze and prune unnecessary 'use client' directives in App Router components to minimize client-side JS.
  • Detect missing lazy loading and improve route-level code splitting to reduce initial payload.
  • Identify oversized dependencies, suboptimal imports, and image/font optimization opportunities.
  • Provide actionable remediation guidance and heuristics to maintain peak performance across routes.

Quick Start

Run the performance agent against your Next.js project to generate a report and recommendations.

Frequently Asked Questions about Performance Agent

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

FAQPage Schema
How do I find performance bottlenecks and reduce bundle size in a Next.js 14 app?

To find performance bottlenecks in Next.js 14, scan your source files for unnecessary 'use client' directives, oversized dependencies, and suboptimal imports that inflate bundle size. This generates a report of actionable remediation steps to prune client-side JS and improve Core Web Vitals.

How does analyzing server versus client components improve Core Web Vitals?

Analyzing server versus client components improves Core Web Vitals by identifying and pruning unnecessary 'use client' directives in App Router components. Minimizing client-side JavaScript reduces initial payload, directly boosting route-level performance metrics.

What's the best way to detect missing lazy loading and unoptimized images in Next.js?

The best way to detect missing lazy loading and unoptimized images is to run a comprehensive source file scan across your Next.js project. This identifies missing route-level code splitting and image optimization opportunities, providing actionable remediation guidance.

Can I use this to analyze third-party scripts and font optimization in Next.js?

Yes, you can use this to analyze third-party scripts and font optimization in Next.js. The scan evaluates routes, components, images, fonts, and third-party scripts to detect misconfigurations and report actionable steps for maintaining peak performance.

Why does my Next.js app have a large initial payload despite using App Router?

Your Next.js App Router app likely has a large initial payload due to unnecessary 'use client' directives, missing lazy loading, and oversized dependencies. Scanning your codebase flags these large dependencies and suboptimal imports, enabling better route-level code splitting.

When should I not use a 'use client' directive in Next.js server components?

You should avoid using a 'use client' directive when a component does not require client-side interactivity, as it forces JavaScript to ship to the browser. Pruning these directives minimizes client-side JS and reduces your overall bundle size.