web-quality-audit
web-quality-audit is a skill in addyosmani/web-quality-skills, last changed 24 Aug 2026. It can run shell commands, reach the network, name web addresses and bundle scripts — read the findings before installing. Our pattern check flagged nothing at commit afa8da9 on 27 Oct 2026.
Pattern check: nothing flagged · commit afa8da9 · 27 Oct 2026
InstallRun an evidence-led web quality audit covering performance, accessibility, SEO, best practices, and agentic browsing. Use when asked to "audit my site", "review web quality", "run lighthouse audit", "check page quality", or "optimize my website".
- Licence
- MIT
- Repo stars
- 3.0k
- Folder last changed
- 24 Aug 2026 (opens in a new tab)
- Publisher
- addyosmani
- Files
- 2 files
- Checked
- afa8da9 (opens in a new tab) · 27 Oct 2026
Install
Each tab says whether it installs commit afa8da9, the one we checked, or the latest version.
No tab for your agent? Use Any agent for OpenCode, Goose, Windsurf (Devin Desktop), Zed, Roo Code, Factory Droid, Junie, Amp and Antigravity, and Claude Code for Cline. Kiro needs the folder copied by hand.
Pinned to commit afa8da9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/addyosmani/web-quality-skills.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
git -C "$tmp" sparse-checkout set -- skills/web-quality-audit &&
git -C "$tmp" checkout -q afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
mkdir -p .claude/skills &&
mkdir .claude/skills/web-quality-audit &&
cp -R "$tmp"/skills/web-quality-audit/. .claude/skills/web-quality-audit/ &&
rm -rf "$tmp"If Claude Code was already running and this created the skills folder, run /reload-skills.
Or install the web-quality-skills plugin it ships in. Installs the latest version, not the one we checked. Installs everything in the plugin, including any hooks, MCP servers and scripts our check doesn't cover.
claude plugin marketplace add addyosmani/web-quality-skills --scope project &&
claude plugin install web-quality-skills@addy-web-quality-skills --scope projectPinned to commit afa8da9, the one we checked.
Skills in the Claude apps belong to your account rather than to a project.
Make web-quality-audit.zip, with the skill folder at the top level:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/addyosmani/web-quality-skills.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
git -C "$tmp" sparse-checkout set -- skills/web-quality-audit &&
git -C "$tmp" checkout -q afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
out="$(mktemp -d)" &&
cp -R "$tmp"/skills/web-quality-audit "$out"/web-quality-audit &&
(cd "$out" && zip -qr - web-quality-audit) > web-quality-audit.zip &&
rm -rf "$tmp" "$out"In Claude, open Customize > Skills, select +, then + Create skill > Upload a skill, and choose web-quality-audit.zip.
On Free, Pro and Max plans, turn on Code execution and file creation (Create and edit files in newer settings) under Settings > Capabilities.
Pinned to commit afa8da9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/addyosmani/web-quality-skills.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
git -C "$tmp" sparse-checkout set -- skills/web-quality-audit &&
git -C "$tmp" checkout -q afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
mkdir -p .agents/skills &&
mkdir .agents/skills/web-quality-audit &&
cp -R "$tmp"/skills/web-quality-audit/. .agents/skills/web-quality-audit/ &&
rm -rf "$tmp"Codex picks up new skills on its own; restart it if this one does not appear.
Pinned to commit afa8da9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/addyosmani/web-quality-skills.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
git -C "$tmp" sparse-checkout set -- skills/web-quality-audit &&
git -C "$tmp" checkout -q afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
mkdir -p .cursor/skills &&
mkdir .cursor/skills/web-quality-audit &&
cp -R "$tmp"/skills/web-quality-audit/. .cursor/skills/web-quality-audit/ &&
rm -rf "$tmp"Pinned to commit afa8da9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/addyosmani/web-quality-skills.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
git -C "$tmp" sparse-checkout set -- skills/web-quality-audit &&
git -C "$tmp" checkout -q afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
mkdir -p .github/skills &&
mkdir .github/skills/web-quality-audit &&
cp -R "$tmp"/skills/web-quality-audit/. .github/skills/web-quality-audit/ &&
rm -rf "$tmp"In a running Copilot CLI session, run /skills reload.
Or install it with gh skill, which also installs the commit we checked. Needs GitHub CLI 2.90 or later.
gh skill install addyosmani/web-quality-skills skills/web-quality-audit/SKILL.md@afa8da942115f2961fdbfa80807ea0b232ff6c00 --agent github-copilot --scope projectPinned to commit afa8da9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/addyosmani/web-quality-skills.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
git -C "$tmp" sparse-checkout set -- skills/web-quality-audit &&
git -C "$tmp" checkout -q afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
mkdir -p .gemini/skills &&
mkdir .gemini/skills/web-quality-audit &&
cp -R "$tmp"/skills/web-quality-audit/. .gemini/skills/web-quality-audit/ &&
rm -rf "$tmp"In a running session, run /skills reload.
Or use Gemini CLI’s own installer. Installs the latest version, not the one we checked.
gemini skills install https://github.com/addyosmani/web-quality-skills.git --path skills/web-quality-audit --scope workspacePinned to commit afa8da9, the one we checked.
Codex, Cursor, Copilot, VS Code, Gemini CLI, OpenCode, Goose, Amp and Zed all read .agents/skills; Claude Code and Kiro list only their own folders.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/addyosmani/web-quality-skills.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
git -C "$tmp" sparse-checkout set -- skills/web-quality-audit &&
git -C "$tmp" checkout -q afa8da942115f2961fdbfa80807ea0b232ff6c00 &&
mkdir -p .agents/skills &&
mkdir .agents/skills/web-quality-audit &&
cp -R "$tmp"/skills/web-quality-audit/. .agents/skills/web-quality-audit/ &&
rm -rf "$tmp"Or use the skills CLI from skills.sh. Installs the latest version, not the one we checked. The skills CLI reports installs to skills.sh unless you set DISABLE_TELEMETRY=1.
npx skills@1.7.4 add addyosmani/web-quality-skills --skill web-quality-auditWhat it can touch
From the files and frontmatter at commit afa8da9. This is how much a skill can do, not whether it is risky.
What it can touch: Shell, network or credentials
Runs shell commands
Its instructions or files give the agent commands to run on your computer.
Reaches the network
It sends or fetches data over the internet, for example with curl, an HTTP library or a package install.
Names web addresses
It mentions outside web addresses the agent may visit. We list them but don't follow them.
Bundles scripts
The folder holds code files the agent may run.
Pattern check
Pattern check: nothing flagged · commit afa8da9 · 27 Oct 2026
We checked every text file in this skill, at commit afa8da9 on 27 Oct 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
How the check worksReport an incorrect finding
Outside links we did not follow
- https://developer.chrome.com/blog/moving-lighthouse-to-insights
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specPasses with warnings
The open format from agentskills.io, held to what the strictest agents enforce, so one folder loads everywhere.
- Warning
Paths that may not work once the skill is installed: line 19: ../performance/references/MEASUREMENT.md (outside the skill folder), line 205: ../performance/SKILL.md (outside the skill folder), line 206: ../core-web-vitals/SKILL.md (outside the skill folder), line 207: ../accessibility/SKILL.md (outside the skill folder), line 208: ../seo/SKILL.md (outside the skill folder) and 1 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Warning
Claude CodePasses with warnings
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Warning
Paths that may not work once the skill is installed: line 19: ../performance/references/MEASUREMENT.md (outside the skill folder), line 205: ../performance/SKILL.md (outside the skill folder), line 206: ../core-web-vitals/SKILL.md (outside the skill folder), line 207: ../accessibility/SKILL.md (outside the skill folder), line 208: ../seo/SKILL.md (outside the skill folder) and 1 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Warning
Claude apps & API uploadPasses with warnings
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Warning
Paths that may not work once the skill is installed: line 19: ../performance/references/MEASUREMENT.md (outside the skill folder), line 205: ../performance/SKILL.md (outside the skill folder), line 206: ../core-web-vitals/SKILL.md (outside the skill folder), line 207: ../accessibility/SKILL.md (outside the skill folder), line 208: ../seo/SKILL.md (outside the skill folder) and 1 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Note
The description is 246 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4
Fix: If the claude.ai upload refuses it, trim the description to 200 characters.
- Warning
OpenAI (Codex & API)Passes with warnings
Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.
- Warning
Paths that may not work once the skill is installed: line 19: ../performance/references/MEASUREMENT.md (outside the skill folder), line 205: ../performance/SKILL.md (outside the skill folder), line 206: ../core-web-vitals/SKILL.md (outside the skill folder), line 207: ../accessibility/SKILL.md (outside the skill folder), line 208: ../seo/SKILL.md (outside the skill folder) and 1 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Warning
VS Code & CopilotPasses with warnings
VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.
- Warning
Paths that may not work once the skill is installed: line 19: ../performance/references/MEASUREMENT.md (outside the skill folder), line 205: ../performance/SKILL.md (outside the skill folder), line 206: ../core-web-vitals/SKILL.md (outside the skill folder), line 207: ../accessibility/SKILL.md (outside the skill folder), line 208: ../seo/SKILL.md (outside the skill folder) and 1 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Warning
SKILL.md
Files
2 files
| Path | Size |
|---|---|
| SKILL.md (opens in a new tab) | 10.2 KB |
| scripts/analyze.sh (opens in a new tab) | 3.8 KB |
More from addyosmani/web-quality-skills
accessibility
addyosmani/web-quality-skills
Audit and improve web accessibility following WCAG 2.2 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible".
- Runs shell commands
- Reaches the network
- +1 more
Pattern check: Nothing flaggedMIT · 3.0k repo stars · Updated 24 Aug 2026
best-practices
addyosmani/web-quality-skills
Apply modern web development best practices for security, compatibility, and code quality. Use when asked to "apply best practices", "security audit", "modernize code", "code quality review", or "check for vulnerabilities".
- Runs shell commands
- Reaches the network
- +1 more
Pattern check: Nothing flaggedMIT · 3.0k repo stars · Updated 24 Aug 2026
core-web-vitals
addyosmani/web-quality-skills
Optimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".
- Names web addresses
Pattern check: Nothing flaggedMIT · 3.0k repo stars · Updated 24 Aug 2026
performance
addyosmani/web-quality-skills
Optimize web performance for faster loading and better user experience. Use when asked to "speed up my site", "optimize performance", "reduce load time", "fix slow loading", "improve page speed", or "performance audit".
- Reaches the network
- Names web addresses
Pattern check: Nothing flaggedMIT · 3.0k repo stars · Updated 24 Aug 2026
seo
addyosmani/web-quality-skills
Optimize for search engine visibility and ranking. Use when asked to "improve SEO", "optimize for search", "fix meta tags", "add structured data", "sitemap optimization", or "search engine optimization".
- Names web addresses
Pattern check: Nothing flaggedMIT · 3.0k repo stars · Updated 24 Aug 2026