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-auditruns the whole check and calls the others.performanceandcore-web-vitalslook at loading speed, LCP, INP and CLS.accessibilitychecks against WCAG 2.2 (labels, contrast, keyboard use, screen readers).seocovers crawling, meta tags and structured data.best-practicescovers 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-skillsHow 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
- A skill does not start — use words from its description, such as "audit my site" or "fix LCP", or call it directly, for example
/web-quality-skills:accessibility— https://github.com/addyosmani/web-quality-skills - No live Lighthouse numbers, only code review — install Chrome DevTools MCP so the skills can run a real audit — https://github.com/ChromeDevTools/chrome-devtools-mcp
- Plugin installed but not visible in an open session — run
/reload-pluginsor restart Claude Code — https://code.claude.com/docs/en/discover-plugins - Updates do not appear — the README says the plugin updates with
/plugin update— https://github.com/addyosmani/web-quality-skills - No field data for your page — CrUX has no record for localhost, staging, new or low-traffic pages; the skills report this as "unavailable", not as a pass — https://github.com/addyosmani/web-quality-skills/blob/main/skills/performance/references/MEASUREMENT.md
Other assistants
- Codex (CLI v0.122 or later, per README):
codex plugin marketplace add addyosmani/web-quality-skills, then restart Codex and use skills with@, for example@performance. On older Codex the setup notes givecodex marketplace add. Setup notes: https://github.com/addyosmani/web-quality-skills/blob/main/docs/codex-setup.md - Gemini CLI:
gemini extensions install https://github.com/addyosmani/web-quality-skills, then restart Gemini CLI. Skills start when your prompt matches. Setup notes: https://github.com/addyosmani/web-quality-skills/blob/main/docs/gemini-setup.md - Any agent that reads Agent Skills:
npx skills add addyosmani/web-quality-skills(README).
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.
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