web-quality-audit

Audit websites for performance, accessibility, SEO, and best practices using Lighthouse criteria.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/kaitoartz/dotfiles --skill web-quality-audit-kaitoartz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-quality-audit
Source: https://github.com/kaitoartz/dotfiles/tree/main/dot_agents/skills/web-quality-audit
Command: npx skills add https://github.com/kaitoartz/dotfiles --skill web-quality-audit-kaitoartz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve? Web projects often ship with hidden performance regressions, accessibility barriers, and SEO gaps that hurt user experience and search rankings. This Skill provides a structured audit framework covering 150+ checks so issues are found, categorized by severity, and paired with actionable fixes before launch. ## Core Features & Use Cases - Four-Category Audit: Reviews Performance (Core Web Vitals, resource optimization), Accessibility (WCAG-based checks), SEO (crawlability, on-page, technical), and Best Practices (security, modern standards). - Severity-Ranked Findings: Classifies issues as Critical, High, Medium, or Low with a consistent output format including impact and specific code fixes. - Static HTML Analyzer Script: Includes a read-only bash script that scans HTML files for missing doctype, viewport, lang attributes, alt text, and non-HTTPS URLs, outputting structured JSON. - Use Case: Before deploying a marketing site, run the audit to catch a missing viewport meta tag, oversized LCP images, and low-contrast text, then receive a prioritized fix list. ## Quick Start Ask the assistant to audit your website's HTML files for performance, accessibility, SEO, and best practice issues and return a severity-ranked report.

Frequently Asked Questions about web-quality-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my website for performance and accessibility issues?▼

Run a web quality audit that checks Core Web Vitals (LCP, INP, CLS), WCAG accessibility criteria, SEO fundamentals, and security best practices. Findings are grouped by severity with specific code-level fixes for each issue.

What does a Lighthouse-based web quality audit check?▼

It covers over 150 checks across four categories: Performance (image compression, JavaScript size, caching), Accessibility (alt text, contrast, keyboard support), SEO (titles, meta descriptions, sitemaps), and Best Practices (HTTPS, CSP headers, deprecated APIs).

Does the HTML analyzer script modify my files?▼

No, the analyze.sh script is strictly read-only. It scans .html and .htm files for issues like missing doctype, viewport tags, alt attributes, and non-HTTPS URLs, then outputs structured JSON without any filesystem mutations.

What dependencies are required to run the HTML analysis script?▼

The script requires bash, standard Unix tools (grep, find), and jq for safe JSON output. If jq is missing, the script exits with a structured error suggesting installation via a package manager like brew.

How are audit findings prioritized in the report?▼

Findings are ranked into four severity levels: Critical (security vulnerabilities, complete failures), High (Core Web Vitals failures, major accessibility barriers), Medium (performance and SEO improvements), and Low (minor optimizations), each with a recommended fix order.