web-perf

Audit website performance using Chrome DevTools traces, Core Web Vitals, and network analysis.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/julianckt/adoptarun --skill web-perf-julianckt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-perf
Source: https://github.com/julianckt/adoptarun/tree/main/.agents/skills/web-perf
Command: npx skills add https://github.com/julianckt/adoptarun --skill web-perf-julianckt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chrome-devtools-mcp.

What problem does it solve? Diagnosing slow page loads and poor Lighthouse scores requires correlating traces, network requests, and codebase configuration, which is time-consuming to do manually. ## Core Features & Use Cases - Performance Trace Analysis: Capture cold-load traces and analyze Core Web Vitals insights like LCP breakdowns and CLS culprits via Chrome DevTools MCP tools. - Network & Accessibility Audits: Identify render-blocking resources, missing preloads, caching issues, and accessibility gaps such as poor contrast or missing ARIA labels. - Codebase Analysis: Detect the framework and bundler (Webpack, Vite, Next.js, Astro, etc.) and flag tree-shaking, polyfill, and minification problems. - Use Case: Point the skill at a staging URL to get a prioritized report of Core Web Vitals ratings, top issues with estimated impact, and specific fixes like compressing an oversized hero image. ## Quick Start Audit the performance of https://example.com and give me a prioritized list of Core Web Vitals issues and fixes.

Frequently Asked Questions about web-perf

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

FAQPage Schema
How do I audit Core Web Vitals for my website?

Run a performance trace with page reload to capture cold-load metrics, then analyze insights like LCPBreakdown and CLSCulprits. Compare results against thresholds such as LCP under 2.5s and CLS under 0.1 to determine ratings.

How to find render-blocking resources on a page?

List network requests filtered by Script and Stylesheet types, then check for JS or CSS in the document head without async, defer, or media attributes. The RenderBlocking insight from a trace also flags these directly.

What tools does this audit use for performance tracing?

It uses Chrome DevTools MCP tools such as navigate_page, performance_start_trace, performance_analyze_insight, and list_network_requests. If trace tools are unavailable, it falls back to source and network analysis and notes what could not be measured.

Can it analyze my codebase for bundle optimization?

Yes, when codebase access exists it detects the bundler from config files like vite.config.ts or next.config.js, then checks tree-shaking settings, barrel files, polyfills, minification, and compression. This phase is skipped for third-party sites.

Why did my performance trace return empty results?

Empty traces usually mean the page did not load correctly before recording started. Verify the page loads with navigate_page first, and check the trace response for the correct insightSetId and available insight names, which vary across Chrome DevTools versions.