perf-agent

Profile UI performance changes in Chrome and measure Core Web Vitals.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/NeuveAI/perfagent-cli --skill perf-agent-neuveai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-agent
Source: https://github.com/NeuveAI/perfagent-cli/tree/main/packages/perf-agent-skill
Command: npx skills add https://github.com/NeuveAI/perfagent-cli --skill perf-agent-neuveai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Profiling UI performance of code changes in a real Chrome browser to detect regressions and quantify Core Web Vitals before delivering features.

Core Features & Use Cases

  • Profiles code changes across modified routes, components, and data fetches to surface regressions and bottlenecks.
  • Generates deterministic traces using Chrome DevTools MCP tools, stores reports, and surfaces actionable insights.
  • Works with the Perf Agent MCP workflow to compare against baselines and verify performance under desktop and throttled mobile conditions.

Quick Start

Configure the perf-agent MCP server and run a trace against the changed routes.

Frequently Asked Questions about perf-agent

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

FAQPage Schema
How do I profile UI performance changes in a real Chrome browser?

To profile code changes in real Chrome, configure the perf-agent MCP server and run a trace against modified routes. The Skill uses Chrome DevTools MCP tools to execute traces and surface actionable performance insights.

What is Core Web Vitals regression detection and how does it work?

Core Web Vitals regression detection quantifies metrics like LCP and INP against baselines using real Chrome traces. The Skill applies profiling to modified data-fetch paths and components to surface render-blocking bottlenecks under throttled conditions.

Do I need a configured MCP server to run Chrome DevTools traces?

Yes, you need the perf-agent MCP tools and a configured MCP server to run traces. This environment allows the Skill to execute Chrome DevTools traces, analyze insights like INPBreakdown and RenderBlocking, and generate durable reports.

Can I measure web performance under throttled mobile conditions?

Yes, the Skill verifies performance under both desktop and throttled mobile network conditions. It profiles code edits across modified routes and data-fetch paths to surface regressions and bottlenecks in real Chrome.

What's the best way to detect render-blocking bottlenecks in web applications?

The best way to detect render-blocking bottlenecks is running real Chrome traces on modified components and data-fetch paths. The Skill analyzes insights like RenderBlocking and LCPBreakdown to surface actionable bottlenecks under throttled conditions.

Why does my web application have Core Web Vitals regressions after code edits?

Regressions often happen when code edits modify routes or data-fetch paths without profiling. This Skill detects regressions by running deterministic Chrome traces and comparing metrics like INP and LCP against established baselines.