WEB PERFORMANCE / Addy Osmani
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.
“Optimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. …”
01 / THE REASONING
Why this made the selection.
- Measurement discipline is the spine: CrUX p75 first with a labelled fallback when page-level data is missing, trace analysis of only the failing metric's insights, and re-measurement after the fix with field verification explicitly deferred until new user data exists.
- The Speculation Rules section is the careful version — eagerness triggers per Chrome version, bandwidth cost, side effects firing at prerender time and gated on document.prerendering — instead of a copy-paste snippet.
- Per-metric references (LCP.md, INP.md, CLS.md) exist in the skill directory, and the skill forbids comparing a single lab value with a field p75 as if they were equivalent samples.
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/core-web-vitals/SKILL.md (complete, 228 lines)
- skills/core-web-vitals/references directory (LCP.md, INP.md, CLS.md)
- cross-link targets in the sibling performance skill
- repository LICENSE (MIT)
- README.md (installation command audit at the existing pin)
Our findings
- The metric table states the good, needs-work and poor thresholds and that Google measures at the 75th percentile, and the workflow refuses to claim a metric is failing without runtime evidence.
- The LCP section prefers a discoverable img with fetchpriority over speculative preloads and says preload only when the trace shows late discovery — the ordering most guides get wrong.
- The measurement-sources table separates trace, CrUX, Lighthouse and RUM uses and forbids routing performance through the DevTools lighthouse_audit capability.
Not established by this review
- No trace was recorded and no metric was measured; the workflow was read, not run.
- Speculation Rules behaviour claims were checked against the linked Chrome documentation, not reproduced in a browser.
- 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.
DOCUMENTED COMMAND
npx skills add addyosmani/web-quality-skills/skills/core-web-vitals --skill core-web-vitals 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.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/addyosmani/web-quality-skills/tree/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/core-web-vitals --skill core-web-vitals - Install the complete skill directory; the per-metric references must travel with the SKILL.md.
- For the full measurement workflow, install the sibling performance skill too — two cross-links point into its references.
Before you start
- Node.js/npm for the installer
- An agent that supports the Agent Skills format
- A runnable page or CrUX data; a browser tool that records performance traces when available
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/addyosmani/web-quality-skills/blob/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/core-web-vitals/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/addyosmani/web-quality-skills/tree/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/core-web-vitals/references
Supports: review, whySelected
https://github.com/addyosmani/web-quality-skills/tree/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/performance
Supports: limitations, install
- Repository licence (MIT) ↗Checked
https://github.com/addyosmani/web-quality-skills/blob/afa8da942115f2961fdbfa80807ea0b232ff6c00/LICENSE
Supports: license
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install
https://raw.githubusercontent.com/addyosmani/web-quality-skills/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/core-web-vitals/SKILL.md
Supports: limitations, upstreamDescription, review
https://raw.githubusercontent.com/vercel-labs/skills/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: review