Web Quality Skills
An (unofficial) comprehensive collection of Agent Skills for optimizing web projects based on Google Lighthouse guidelines and Core Web Vitals best practices.
Stack-agnostic. Works with any framework: React, Vue, Angular, Svelte, Next.js, Nuxt, Astro, plain HTML, and more.
Why web quality skills?
While interface guidelines tell you what to build, Web Quality Skills tell you how to build it performantly, accessibly, and optimally for search engines. These skills encode the collective wisdom from:
- 150+ Lighthouse audits across Performance, Accessibility, SEO, and Best Practices
- Core Web Vitals optimization patterns (LCP, INP, CLS)
- Real-world performance engineering experience
- WCAG 2.2 accessibility standards
- Modern SEO requirements
Available skills
| Skill | Description | Use when |
|---|
| web-quality-audit | Comprehensive quality review across all categories | "Audit my site", "Review this for quality", "Check web quality" |
| performance | Loading speed, runtime efficiency, resource optimization | "Optimize performance", "Speed up my site", "Fix slow loading" |
| core-web-vitals | LCP, INP, CLS specific optimizations | "Improve Core Web Vitals", "Fix LCP", "Reduce CLS" |
| accessibility | WCAG compliance, screen reader support, keyboard navigation | "Improve accessibility", "WCAG audit", "a11y review" |
| seo | Search engine optimization, crawlability, structured data | "Optimize for SEO", "Improve search ranking", "Fix meta tags" |
| best-practices | Security, modern APIs, code quality patterns | "Apply best practices", "Security audit", "Code quality review" |
Quick start
Installation
add-skill is a powerful CLI tool that lets you install agent skills onto your coding agents from git repositories. Whether you're using OpenCode, Claude Code, Codex, or Cursor, the add-skill tool makes it simple to extend your agent's capabilities with specialized instruction sets. Use add-skill to automate release notes, create pull requests, integrate with external tools, and more. Simply run npx add-skill to get started.
npx skills add addyosmani/web-quality-skills
or
npx add-skill addyosmani/web-quality-skills
Or manually:
cp -r skills/* ~/.claude/skills/
Claude Code (plugin)
Install as a versioned, namespaced plugin from inside Claude Code:
/plugin marketplace add addyosmani/web-quality-skills
/plugin install web-quality-skills@addy-web-quality-skills
Skills are then namespaced (e.g. /web-quality-skills:performance) and update with /plugin update. The plugin reads the same skills/ directory as the manual copy above — no duplication.
Codex
Install directly via the Codex plugin marketplace (Codex CLI v0.122+):
codex plugin marketplace add addyosmani/web-quality-skills
Once installed, invoke skills in chat using @ (e.g. @performance, @accessibility). See docs/codex-setup.md for local installation and troubleshooting.
Gemini CLI
Install directly via Gemini CLI extensions:
gemini extensions install https://github.com/addyosmani/web-quality-skills
Skills are auto-discovered by Gemini and activate when prompts match their description. See docs/gemini-setup.md for workspace mode and troubleshooting.
claude.ai
Add skills to your project knowledge or paste the SKILL.md contents into your conversation.
Usage
Skills activate automatically when your request matches their description. Examples:
Audit this page for web quality issues
Optimize performance and fix Core Web Vitals
Review accessibility and suggest improvements
Make this SEO-ready
Skill details
web-quality-audit
The comprehensive skill that orchestrates all other skills. Use this for full-site audits or when you're unsure which specific area needs attention.
Trigger phrases: "audit my site", "quality review", "lighthouse audit", "check web quality"
What it checks:
- All Core Web Vitals metrics
- 50+ performance patterns
- 40+ accessibility rules
- 30+ SEO requirements
- 20+ security/best practice patterns
performance
Deep-dive into loading and runtime performance optimization.
Trigger phrases: "speed up", "optimize performance", "reduce load time", "fix slow"
Key optimizations:
- Critical rendering path
- JavaScript bundling and code splitting
- Image optimization (formats, sizing, lazy loading)
- Font loading strategies
- Caching and preloading
- Server response optimization
core-web-vitals
Specialized skill for the three Core Web Vitals that affect Google Search ranking.
