web-quality-audit

Audits websites for performance, accessibility, SEO, and best-practice issues using Lighthouse criteria.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/RavitejaKarra24/dotfiles --skill web-quality-audit-ravitejakarra24
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-quality-audit
Source: https://github.com/RavitejaKarra24/dotfiles/tree/main/agents/.agents/skills/web-quality-audit
Command: npx skills add https://github.com/RavitejaKarra24/dotfiles --skill web-quality-audit-ravitejakarra24

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, SEO gaps, and security misconfigurations 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 concrete fixes before launch. ## Core Features & Use Cases - Four-category audit coverage: Reviews Performance (Core Web Vitals, resource optimization), Accessibility (WCAG perceivable/operable/understandable/robust), SEO (crawlability, on-page, technical), and Best Practices (security, modern standards, UX patterns). - Severity-ranked findings: Classifies issues as Critical, High, Medium, or Low with a structured Markdown report format including impact and fix guidance per finding. - Static HTML analyzer script: Ships a read-only Bash script that scans HTML files for missing doctype, charset, viewport, lang attributes, title tags, images without alt text, and non-HTTPS URLs, emitting structured JSON. - Use Case: Before deploying a marketing site, ask for a full audit; receive a prioritized report listing a missing viewport meta tag as Critical, unoptimized LCP images as High, and non-descriptive link text as Medium, each with a specific code fix. ## 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 structured audit covering four categories: Performance (Core Web Vitals like LCP, INP, CLS), Accessibility (WCAG criteria), SEO, and Best Practices. Findings are grouped by severity from Critical to Low, each with impact explanation and a specific code fix.

What are Core Web Vitals thresholds for a good page experience?

Core Web Vitals require LCP (Largest Contentful Paint) under 2.5 seconds, INP (Interaction to Next Paint) under 200 milliseconds, and CLS (Cumulative Layout Shift) under 0.1. Failing any of these counts as a High severity issue to fix before launch.

How to check HTML files for missing alt text and meta tags?

Use the included analyze.sh script with a file or directory path. It scans .html and .htm files for missing doctype, charset, viewport, lang, and title tags, plus images without alt attributes and non-HTTPS URLs, outputting structured JSON.

Does the HTML analyzer script modify my files?

No, the analyze.sh script is read-only and performs no filesystem mutations. It requires jq for JSON output, writes human logs to stderr, and emits the structured findings JSON to stdout.

Why do Lighthouse audit names differ between report versions?

Lighthouse v13 (October 2025) migrated Performance audits to Performance Insight Audits, merging checks like layout shifts and unsized images into cls-culprits-insight and image audits into image-delivery-insight. The underlying optimization advice remains unchanged.

What are the limitations of static HTML quality analysis?

Static grep-based analysis only detects markup-level issues like missing tags and non-HTTPS URLs. It cannot measure runtime metrics such as LCP, INP, or CLS, which require browser-based tools like Lighthouse against a live page.