Web Performance Optimization
An evidence-led skill that diagnoses and fixes slow web pages using real-user Core Web Vitals plus browser performance traces.
Dev & CodingIntermediate★ 2,714⑂ 246AI score 9/10Last updated: Aug 24, 2026
What it does
- Triggers on requests like "speed up my site", "reduce load time", "fix slow loading", or "performance audit".
- Establishes a field + lab baseline before any edit, then prioritizes poor p75 LCP/INP/CLS.
- Diagnoses with Chrome DevTools MCP (
performance_start_trace,performance_analyze_insight) instead of routing performance throughlighthouse_audit. - Changes only the code/assets tied to a measured bottleneck, then re-measures and reports before/after with conditions and uncertainty.
- Ships concrete guidance: starting performance budgets, critical rendering path (TTFB, Brotli, HTTP/3, Early Hints 103), preconnect/preload discipline, Speculation Rules, responsive AVIF/WebP images, font subsetting and variable fonts, Cache-Control recipes, service worker caching, layout-thrash avoidance, View Transitions, and third-party facade patterns.
Who it's for
- Frontend and fullstack engineers who own page speed.
- Commerce/content teams needing to pass Core Web Vitals for SEO and conversion.
- Anyone wanting to replace guess-based tuning with a measurement-first workflow.
Example uses
- "Our PDP has a 4s LCP — find the cause": record a trace, spot late LCP image discovery, add
fetchpriority="high"+ preload, re-measure and report the delta. - "Our JS bundle is too big": compare against the 300 KB budget, then apply route-level code splitting and tree-shaken imports (
lodash/debounce). - "The YouTube embed is killing the page": swap in a facade (thumbnail + click-to-load) and defer third-party scripts until intersection.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/addyosmani/web-quality-skills/HEAD/skills/performance/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/performance folder from the GitHub repo addyosmani/web-quality-skills into my ~/.claude/skills/performance/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/addyosmani/web-quality-skills.git /tmp/web-quality-skills && mkdir -p ~/.claude/skills && cp -r /tmp/web-quality-skills/skills/* ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal in the folder where you keep tools.
- Clone the repo:
git clone https://github.com/addyosmani/web-quality-skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r web-quality-skills/skills/performance ~/.claude/skills/— copying all ofskills/*is recommended because this skill links to the core-web-vitals skill. - Verify
~/.claude/skills/performance/references/MEASUREMENT.mdandRUM.mdcame along. - For real measurements, register the Chrome DevTools MCP server with Claude Code; without it the skill only produces static hypotheses.
- Restart Claude Code and ask something like "run a performance audit on my site".
View source on GitHub ↗License: MIT