# Performance

Optimize web performance for faster loading and better user experience.

- Repository: https://github.com/addyosmani/web-quality-skills (3022 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-08-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add addyosmani/web-quality-skills --skill performance -g -a claude-code -y`
Codex: `npx skills add addyosmani/web-quality-skills --skill performance -g -a codex -y`
Cursor: `npx skills add addyosmani/web-quality-skills --skill performance -g -a cursor -y`
Gemini CLI: `npx skills add addyosmani/web-quality-skills --skill performance -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add addyosmani/web-quality-skills`

## Description

Optimize web performance for faster loading and better user experience. Use when asked to "speed up my site", "optimize performance", "reduce load time", "fix slow loading", "improve page speed", or "performance audit".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Performance optimization

Evidence-led performance optimization using real-user signals for prioritization and browser traces for diagnosis. Focuses on loading speed, runtime responsiveness, and resource delivery.

## How it works

1. If a page can run, read [the measurement workflow](references/MEASUREMENT.md) and establish a field-plus-lab baseline before editing.
2. Prioritize poor real-user Core Web Vitals. Use a DevTools performance trace and its focused insights to find the cause.
3. Inspect and change only the code or assets connected to measured bottlenecks.
4. Re-run equivalent lab measurements and report before/after values, conditions, and uncertainty. Field verification remains pending until enough new user data arrives.

When no runnable page exists, perform static inspection but call findings **hypotheses**, not measured regressions. Include the command or browser workflow that can verify each high-impact hypothesis.

Prefer a browser tool that records a performance trace and exposes focused insights. With Chrome DevTools MCP, use `performance_start_trace` and `performance_analyze_insight`; do not route performance through `lighthouse_audit`, which covers non-performance Lighthouse categories.

## Starting performance budget

Budgets must reflect the product's target devices, networks, page types, and user journeys. The values below are initial guardrails for a typical content or commerce page, not universal pass/fail criteria. Preserve an existing project budget when one is already defined.

The rest: https://github.com/addyosmani/web-quality-skills/blob/HEAD/skills/performance/SKILL.md