Perf Lighthouse

This gets you running Lighthouse audits from the CLI or Node API and shows you how to actually parse the results. You'll want this when you need to measure performance scores, set up performance budgets with thresholds for resource sizes and Core Web Vitals, or integrate audits into CI with GitHub Actions. The Node API examples are straightforward for programmatic access, and the budget.json setup lets you enforce hard limits on script sizes, LCP, and CLS. It includes a comparison script for baseline vs PR reports, which is handy for catching regressions. If you're trying to fix specific performance problems rather than just measure them, you'll want perf-web-optimization instead.

skills.sh installs: 332
GitHub stars: 7.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add tech-leads-club/agent-skills --skill perf-lighthouse --agent claude-code

Installs into .claude/skills of the current project.

Files

Lighthouse Audits

CLI Quick Start

# Install
npm install -g lighthouse

# Basic audit
lighthouse https://example.com

# Mobile performance only (faster)
lighthouse https://example.com --preset=perf --form-factor=mobile

# Output JSON for parsing
lighthouse https://example.com --output=json --output-path=./report.json

# Output HTML report
lighthouse https://example.com --output=html --output-path=./report.html

Common Flags

--preset=perf           # Performance only (skip accessibility, SEO, etc.)
--form-factor=mobile    # Mobile device emulation (default)
--form-factor=desktop   # Desktop
--throttling-method=devtools  # More accurate throttling
--only-categories=performance,accessibility  # Specific categories
--chrome-flags="--headless"   # Headless Chrome