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
npx skills add podo/design-agent-skills --skill addyosmani-quality -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/addyosmani-quality/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/addyosmani-quality/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill addyosmani-quality -a codex2Manually: put the files in place
.agents/skills/addyosmani-quality/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill addyosmani-quality -a cursor2Manually: put the files in place
.cursor/skills/addyosmani-quality/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/addyosmani-quality2Manually: put the files in place
.github/skills/addyosmani-quality/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill addyosmani-quality -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/addyosmani-qualityManually: put the files in place
.devin/skills/addyosmani-quality/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill addyosmani-quality -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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