SkillInstalls cleanly

Audit site speed, a11y and SEO

Web Quality Skills

Six skills by Addy Osmani that audit page speed, Core Web Vitals, accessibility, SEO and best practices, using Lighthouse or Chrome DevTools when present.

Works with
Claude Code, Codex CLI, Gemini CLI
Good for
Web developers

What it does

A set of six skills that teach your assistant how to check and improve a website the way Lighthouse does:

  • web-quality-audit runs the whole check and calls the others.
  • performance and core-web-vitals look at loading speed, LCP, INP and CLS.
  • accessibility checks against WCAG 2.2 (labels, contrast, keyboard use, screen readers).
  • seo covers crawling, meta tags and structured data.
  • best-practices covers HTTPS, security headers, modern APIs and console errors.

The skills work with any framework. If Chrome DevTools MCP is installed, they use its live Lighthouse and performance-trace tools. If not, they fall back to Lighthouse CLI, PageSpeed Insights and reading the code, and they keep "measured" and "guessed from code" findings apart.

Example prompts

  • "Audit this page for web quality issues."
  • "Speed up the home page and fix Core Web Vitals."
  • "Review accessibility on the sign-up form and suggest fixes."
  • "Make this site SEO-ready: titles, meta descriptions and structured data."

How to install

/plugin marketplace add addyosmani/web-quality-skills
/plugin install web-quality-skills@addy-web-quality-skills

How to use it

Ask: Audit this page for web quality issues. For live measurements, also install Chrome DevTools MCP; without it the skills fall back to Lighthouse CLI, PageSpeed Insights and reading your code.

Check it works

After installing, run /help or type /web-quality-skills: and look for the six skills (for example /web-quality-skills:performance). Then ask "Audit this page for web quality issues" in a web project and check that Claude names the skill it is using.

Common problems

Other assistants

What to watch out for

  • The README calls the collection unofficial: it is Addy Osmani's own project, not a Google or Chrome product
  • Instructions only: no hooks, no MCP server and no allowed-tools in the six SKILL.md files, so every command Claude runs goes through your normal approvals
  • Without Chrome DevTools MCP the skills point Claude to other tools: the accessibility skill shows npx lighthouse and npm install @axe-core/cli -g (a global install), and the audit skill has a read-only scripts/analyze.sh that needs jq. Say no if you do not want new packages
  • A live Lighthouse audit in navigation mode reloads the page. The skills say to use snapshot mode on a signed-in page or an unsaved form, and never to run it on a destructive workflow
  • The CrUX API needs a Google Cloud API key; the skills say to use it only when a key is already there or you ask for automation
  • Scores and lab runs are not real-user data; the README says field data from CrUX or your own monitoring decides user impact
  • Version 2.0.0 (merged 2026-08-24 21:07 UTC, GitHub clock) is the latest change on main. There are no tags or releases, and the CHANGELOG has no dates; the plugin follows main

Licence and author

Licence
MIT
Author
Addy Osmani
Source code
github.com/addyosmani/web-quality-skills

How we tested it

We installed it on an empty test computer on 29 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
29 Oct 2026
Method
Intake sandbox run on 2026-10-29 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed web-quality-skills@addy-web-quality-skills with the Claude Code command line.

Checked again on 29 Oct 2026

Alternatives

  • Chrome DevTools MCP — the live browser tools these skills prefer; use it alone if you only want raw audits
  • Modern Web Guidance — broader guidance for building modern web pages

FAQ

  • Q: Does it cost money? A: No. The skills are free under the MIT licence. Lighthouse and Chrome DevTools MCP are free too.
  • Q: Is this from Google? A: No. The README calls it an unofficial collection by Addy Osmani.
  • Q: Will a perfect Lighthouse score improve my Google ranking? A: Not on its own. The README says Google uses Core Web Vitals, "but a passing score does not promise a ranking change". The 2.0.0 changelog adds that "ranking or field improvements are not claimed without the corresponding evidence".
  • Q: Is this the same as Addy Osmani Agent Skills? A: No. That is a different repo (addyosmani/agent-skills) with a different plugin, agent-skills@addy-agent-skills, for the whole coding workflow. This one, web-quality-skills@addy-web-quality-skills, only checks web pages. You can install both.
  • Q: Does it need Chrome DevTools MCP? A: No. The setup notes call it "an enhancement, not an installation requirement".

Sources

  • github.com/addyosmani/web-quality-skills
  • github.com/addyosmani/web-quality-skills/blob/main/CHANGELOG.md
  • github.com/addyosmani/web-quality-skills/blob/main/skills/performance/references/MEASUREMENT.md
  • github.com/addyosmani/web-quality-skills/blob/main/docs/codex-setup.md
  • github.com/addyosmani/web-quality-skills/blob/main/docs/gemini-setup.md
  • developer.chrome.com/docs/devtools/agents/use-cases/lighthouse-audit