lighthouse-runner

Run Lighthouse audits on URLs and local HTML files with JSON output.

3|1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/naporin0624/claude-web-audit-plugins --skill lighthouse-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lighthouse-runner
Source: https://github.com/naporin0624/claude-web-audit-plugins/tree/main/skills/lighthouse-runner
Command: npx skills add https://github.com/naporin0624/claude-web-audit-plugins --skill lighthouse-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, lighthouse, serve, puppeteer, and includes scripts (resource) components.

What problem does it solve?

This Skill runs Lighthouse audits to measure performance, SEO, accessibility, and best practices.

Core Features & Use Cases

  • URL or local file analysis with JSON/text outputs.
  • Core Web Vitals metrics (LCP, FID, CLS) and detailed audits.
  • Local server support for HTML files.

Quick Start

Example: npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/lighthouse-runner/src/index.ts https://example.com

Frequently Asked Questions about lighthouse-runner

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

FAQPage Schema
How do I run Lighthouse audits on a website to measure performance and accessibility?

Lighthouse audits measure performance, accessibility, SEO, and best practices across web pages. This Skill runs Lighthouse analysis on live URLs or local HTML files, generating JSON output with Core Web Vitals metrics like LCP, FID, and CLS, plus detailed audit scores.

Can I audit local HTML files with Lighthouse, or does it only work with live URLs?

Lighthouse audits work on both live URLs and local HTML files. This Skill spins up a temporary local server to analyze local files, letting you test unpublished pages without deployment.

What are Core Web Vitals and why should I measure them?

Core Web Vitals are critical user experience metrics: Largest Contentful Paint (LCP) measures loading speed, First Input Delay (FID) measures interactivity, and Cumulative Layout Shift (CLS) measures visual stability. Lighthouse audits capture these alongside performance and accessibility data.

How do I automate Lighthouse audits with Playwright and Node.js?

This Skill automates Lighthouse audits using Node.js with Playwright and Lighthouse libraries. Run it via command line to analyze pages and output machine-readable JSON, enabling CI/CD integration and automated performance tracking.

What's the difference between running Lighthouse directly versus using Playwright integration?

Playwright integration allows Lighthouse to audit pages after custom interactions—navigation, form fills, or state changes—capturing real-world user scenarios. Direct Lighthouse runs analyze initial page load only, missing post-interaction performance impacts.

Does this Skill support batch auditing or analyzing multiple pages at once?

The Skill performs Lighthouse audits on individual pages. For batch analysis, chain multiple invocations via scripts or orchestration tools to audit multiple URLs or files sequentially and aggregate results.