web-quality-audit

Audits websites for performance, accessibility, SEO, and best-practice issues with severity-ranked findings.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill web-quality-audit-trobias
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-quality-audit
Source: https://github.com/trobias/portfolio-nextjs-v2/tree/main/.agents/skills/web-quality-audit
Command: npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill web-quality-audit-trobias

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Web projects often ship with hidden quality problems—slow Core Web Vitals, accessibility barriers, missing meta tags, and insecure configurations—that hurt rankings and user experience. This Skill provides a structured audit framework based on Google Lighthouse criteria so issues are found, categorized by severity, and fixed with concrete recommendations. ## 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) across 150+ checks. - Severity-Ranked Reporting: Classifies findings as Critical, High, Medium, or Low with file locations, impact explanations, and specific code fixes in a standardized output format. - Automated HTML Analysis Script: Includes a bash script that scans HTML files for missing doctype, charset, viewport, lang attributes, alt text, title tags, and non-HTTPS URLs, outputting results as JSON. - Use Case: Before launching a Next.js portfolio site, run the audit to catch a missing viewport meta tag, unoptimized LCP images, and insufficient color contrast, then apply the recommended fixes before deployment. ## Quick Start Ask the assistant to audit your website or project directory 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 fixes for each issue.

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

It covers over 150 checks across four categories: Performance (image compression, code splitting, caching), Accessibility (alt text, contrast, keyboard navigation), SEO (meta tags, sitemaps, canonical URLs), and Best Practices (HTTPS, CSP headers, deprecated APIs).

Can the audit script analyze an entire directory of HTML files?▼

Yes, the included bash script accepts either a single HTML file or a directory path. When given a directory, it recursively finds all .html and .htm files, analyzes each one, and outputs combined issues and warnings as JSON.

What are the Core Web Vitals thresholds a site must pass?▼

Largest Contentful Paint must be under 2.5 seconds, Interaction to Next Paint under 200 milliseconds, and Cumulative Layout Shift under 0.1. Failing any of these is classified as a high-priority issue to fix before launch.

What are the limitations of the automated HTML analysis script?▼

The script performs static grep-based checks on HTML source, so it cannot measure runtime metrics like LCP or INP, execute JavaScript, or test keyboard navigation. Dynamic and rendered-DOM issues require manual review or browser-based tooling.