← Explore all skills

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.

Upstream setup instructions ↗

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
  1. Install the complete skill directory; the per-metric references must travel with the SKILL.md.
  2. 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.

  1. https://github.com/addyosmani/web-quality-skills/blob/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/core-web-vitals/SKILL.md

    Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access

  2. https://github.com/addyosmani/web-quality-skills/tree/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/core-web-vitals/references

    Supports: review, whySelected

  3. https://github.com/addyosmani/web-quality-skills/tree/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/performance

    Supports: limitations, install

  4. https://github.com/addyosmani/web-quality-skills/blob/afa8da942115f2961fdbfa80807ea0b232ff6c00/LICENSE

    Supports: license

  5. https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md

    Supports: install

  6. https://raw.githubusercontent.com/addyosmani/web-quality-skills/afa8da942115f2961fdbfa80807ea0b232ff6c00/skills/core-web-vitals/SKILL.md

    Supports: limitations, upstreamDescription, review

  7. https://raw.githubusercontent.com/vercel-labs/skills/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md

    Supports: review

Evidence & Ask