---
title: "Performance optimization: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/addyosmani-performance-optimization/
description: "Starts from a measurement workflow and names Core Web Vitals targets instead of guessing a speedup."
---

# Performance optimization: review, setup & limitations · Undominated.ai

> Starts from a measurement workflow and names Core Web Vitals targets instead of guessing a speedup.

[← Explore all skills](/skills/)

WEB PERFORMANCE / Addy Osmani

# Performance optimization

Starts from a measurement workflow and names Core Web Vitals targets instead of guessing a speedup.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/addyosmani/agent-skills/tree/7d65f5e781e819895d0603912290edca6d2cf2f7/skills/performance-optimization)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 5 linked sources
 Publisher Addy Osmani
 Licence [MIT ↗](https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/LICENSE)
 Revision 7d65f5e781e8
 [Read what was—and wasn’t—checked ↓](#review)

“Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.”

 [Addy Osmani · upstream description ↗](https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/skills/performance-optimization/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Its five steps (measure, identify, fix, verify, guard) keep a change only when the re-measurement beats run-to-run variance with tests still green.
- It pairs synthetic measurement (Lighthouse, DevTools traces) with field data (web-vitals, CrUX) and maps each symptom to the first thing to measure.

### A good fit for

 - Investigating a measured regression
- Deciding whether an optimization should be kept or reverted
- Setting up a performance budget check in CI

### Weigh up before choosing

 - Its See Also section points to ../../references/performance-checklist.md. The README says a per-skill npx install does not copy that repository-level directory.
- The budgets in Step 5 are generic examples, not a measured budget for your product. No page was profiled in this review.
- Before-and-after measurements require the same command, conditions and measurement budget; bundled changes require individual measurements before their effects can be attributed.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/performance-optimization/SKILL.md at 7d65f5e7 (unchanged from 1401c8b8 by git blob SHA)
- README.md Quick Start and per-skill install note
- LICENSE (MIT)
- README.md (installation command audit at the existing pin)

### Our findings

 - Step 4 is a decision table: keep a change past the threshold with tests green; revert a change within noise, a worse one, or one that turned a test red. Reverted attempts go in a ledger so they are not retried.
- Step 3 names the usual suspects (N+1 queries, unbounded fetching, ignored indexes checked with EXPLAIN ANALYZE, connection-pool exhaustion, caching, images, re-renders, bundle size) and links each to references/optimization-patterns.md.
- Step 5 enforces budgets in CI with npx bundlesize and npx lhci autorun, and asks for field alerts on p75 RUM movement.

### Not established by this review

 - The skill was not executed inside a host agent.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/README.md)

DOCUMENTED COMMAND

 npx skills add addyosmani/agent-skills --skill performance-optimization Copy command ↗

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

 - Install the named skill.
- Measure before changing. Do not cite the skill's targets as this site's.

### Before you start

 - A measurement of the thing you intend to change

### Compatibility

Agent Skills-compatible hosts

### Local Markdown instructions

 - Read the installed skill files

### Cost model

Source is free to read under the stated licence. A host agent may charge for use.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Skill definition ↗](https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/skills/performance-optimization/SKILL.md) Checked 2026-10-13 https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/skills/performance-optimization/SKILL.md Supports: Workflow and stated scope
- [Repository licence ↗](https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/LICENSE) Checked 2026-10-13 https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/LICENSE Supports: Redistribution terms
- [Install commands and per-skill install note ↗](https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/README.md) Checked 2026-10-13 https://github.com/addyosmani/agent-skills/blob/7d65f5e781e819895d0603912290edca6d2cf2f7/README.md Supports: install, limitations
- [Definition excerpt rechecked at the existing revision ↗](https://raw.githubusercontent.com/addyosmani/agent-skills/7d65f5e781e819895d0603912290edca6d2cf2f7/skills/performance-optimization/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/addyosmani/agent-skills/7d65f5e781e819895d0603912290edca6d2cf2f7/skills/performance-optimization/SKILL.md Supports: limitations, review
- [Installation-source command audit at the existing revision ↗](https://raw.githubusercontent.com/addyosmani/agent-skills/7d65f5e781e819895d0603912290edca6d2cf2f7/README.md) Checked 2026-10-15 https://raw.githubusercontent.com/addyosmani/agent-skills/7d65f5e781e819895d0603912290edca6d2cf2f7/README.md Supports: review

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Cloudflare Web Performance Audit ↗ Builds a performance review from browser traces, request details and relevant source instead of generic optimization advice.](/skills/cloudflare-web-perf/)[### Core Web Vitals ↗ Diagnoses LCP, INP and CLS from field evidence first — CrUX p75 with a labelled origin fallback, then a browser trace — and routes to per-metric references, with explicit rules against claiming field improvement from a lab run.](/skills/addyosmani-core-web-vitals/)[### CPU Profile Analysis ↗ Walks an agent through analyzing V8 CPU profiles (.cpuprofile) and Chrome DevTools trace files: parsing large files safely, reconstructing call trees from sampling data, measuring self versus total time, and comparing code paths.](/skills/microsoft-cpu-profile-analysis/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
