Skip to main content
skill CX Codex

addyosmani-quality — Claude Code skill: what it does, how to install

addyosmani-quality runs measurement-first web quality audits across Core Web Vitals, WCAG 2.2 accessibility, SEO, and runtime performance.

MIT 224 installs ★ 35 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill addyosmani-quality -a claude-code
Open on GitHub

What addyosmani-quality does

This package installs six focused playbooks created around Addy Osmani's tooling: web-quality-audit, accessibility, core-web-vitals, performance, seo, and best-practices. The workflow inspects web apps using lab and field data to pinpoint layout shifts, input delays, and indexing bottlenecks.

Targeted contrast fixes or animation jank do not need this entire suite. For isolated rendering thrash or color issues, use dedicated skills like fixing-motion-performance or fixing-accessibility instead.

What it helps with

  • Run a Lighthouse-style web quality audit on a target page
  • Detect accessibility blockers under WCAG 2.2 criteria
  • Diagnose Core Web Vitals regressions for LCP, INP, and CLS
  • Review structured data and crawler discoverability for SEO

Example prompts for the agent

  • Run a Lighthouse audit on our landing page
  • Check our navigation and forms for WCAG 2.2 compliance
  • Analyze why LCP and CLS are degrading on mobile viewports

How to install addyosmani-quality

1Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill addyosmani-quality -a claude-code

2Manually: put the files in place

~/.claude/skills/addyosmani-quality/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/addyosmani-quality/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about addyosmani-quality

How do I install addyosmani-quality in Claude Code?

Run npx skills add podo/design-agent-skills --skill addyosmani-quality -a claude-code in your terminal. This writes the configuration to ~/.claude/skills/addyosmani-quality/SKILL.md.

What sub-skills are included in addyosmani-quality?

It bundles six playbooks: web-quality-audit, accessibility, core-web-vitals, performance, seo, and best-practices.

When should you skip addyosmani-quality?

Skip it for single-purpose accessibility workflows, specific contrast corrections, or animation jank, where tools like fixing-accessibility and fixing-motion-performance fit better.

Source text

SKILL.md · MIT
---
name: addyosmani-quality
description: |
  Web quality skills from Google Chrome's Addy Osmani: a measurement-first
  web quality audit (Lighthouse-style), accessibility (WCAG 2.2), Core Web
  Vitals (LCP/INP/CLS), performance, SEO, and security/modern-web best practices.
triggers:
  - "Addy Osmani"
  - "web quality"
  - "performance audit"
  - "web accessibility"
  - "Lighthouse audit"
  - "SEO audit"
  - "web best practices"
das:
  category: accessibility-quality
  upstream: "https://github.com/addyosmani/web-quality-skills"
  version: latest
  install: false
---

# addyosmani-quality

> Catalogue stub — full package: [addyosmani/web-quality-skills](https://github.com/addyosmani/web-quality-skills)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   This package installs 6 skills (`web-quality-audit`, `accessibility`, `core-web-vitals`, `performance`, `seo`, `best-practices`); checking the first.
   - Global: `f=~/.agents/skills/web-quality-audit/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/web-quality-audit/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `web-quality-audit`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/addyosmani-quality ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add addyosmani/web-quality-skills --skill web-quality-audit accessibility core-web-vitals performance seo best-practices -g -y
   ```

   **Project:**
   ```bash
   npx skills add addyosmani/web-quality-skills --skill web-quality-audit accessibility core-web-vitals performance seo best-practices -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Claude Code plugin route:**

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

**Heads-up**

- **License:** MIT
<!-- das:install:end -->

## Invoke after install

- `web-quality-audit` — "Lighthouse audit", "web quality", "audit my site"
- `accessibility` — "WCAG compliance", "screen reader", "keyboard nav"
- `core-web-vitals` — "LCP", "INP", "CLS", "Core Web Vitals"
- `performance` — "page speed", "loading performance"
- `seo` — "SEO", "structured data", "crawlability"
- `best-practices` — "web security", "modern APIs", "code quality"

## What it does

Addy Osmani's (Google Chrome) web quality suite. Each skill is a focused, evidence-led playbook: a holistic Lighthouse-style audit (performance, accessibility, SEO, best practices, agentic browsing), WCAG 2.2 accessibility, Core Web Vitals optimization using field and lab data, loading and runtime performance, search visibility and structured data, and security and modern-web best practices. Start with `web-quality-audit` and drop into a focused skill for the fixes.

## When NOT to use

- A single-purpose WCAG 2.2 guidance workflow (design through conformance docs) → use `wcag-ai-skill`
- Targeted color-contrast and accessibility fixes in code → use `fixing-accessibility`
- Motion-specific jank (layout thrashing, compositor properties) → use `fixing-motion-performance`

© podo · MIT · podo/design-agent-skills

Similar skills

All skills for Frontend and UI →

From the same set108

The whole set →
design-auditor design-auditor scores a UI across 19 categories, from typography to dark mode, and returns a 0-100 rating with issues ranked by severity. CX Codex +1 227installs copywriting-skill A copywriting skill for landing pages, product pages, pricing, emails, and CTAs. Use it when marketing copy needs clearer persuasion without common AI writing habits. CX Codex +1 227installs motion-catalogue motion-catalogue — a router skill for animation, 3D and generative media work: it picks the matching skill from the catalogue and sends you there. CX Codex +1 225installs brand-design-md brand-design-md pulls design specs for brands like Stripe, Linear, and Notion from getdesign.md and applies their styling to UI code. CX Codex +1 224installs information-architecture-and-navigation Guides your agent through information architecture and navigation systems using the polar bear model. Useful when organizing taxonomies, site structures, and findability tests. CX Codex +1 222installs cloudflare-web-perf cloudflare-web-perf audits Core Web Vitals, render-blocking assets, and Lighthouse performance scores. It diagnoses and fixes LCP, INP, and CLS bottlenecks using Chrome DevTools traces. CX Codex +1 221installs design-catalogue design-catalogue finds the right design skill from a catalogue, maps it to the user’s goal, and points to installation and invocation steps. CX Codex +1 221installs design-review-garrytan design-review-garrytan runs a visual audit of your UI, then lands each fix as its own atomic commit. Useful when design debt has piled up and you want it cleared in reviewable pieces. CX Codex +1 221installs

Project sponsors

Companies that keep this analytics open