perf-lighthouse

Run Lighthouse audits via CLI or Node API and enforce performance budgets.

5.0k|454|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/tech-leads-club/agent-skills --skill perf-lighthouse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-lighthouse
Source: https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/%28performance%29/perf-lighthouse
Command: npx skills add https://github.com/tech-leads-club/agent-skills --skill perf-lighthouse

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? This Skill helps developers run Lighthouse audits locally via CLI or Node API, interpret the results, and enforce performance budgets to improve site speed.

## Core Features & Use Cases

  • Lighthouse CLI audits: run audits from the command line against any URL.
  • Node API integration: run audits programmatically and extract key metrics.
  • Performance budgets: define budgets and fail CI when budgets are exceeded.

### Quick Start Use the perf-lighthouse skill to run a basic audit on https://example.com and parse scores.

Frequently Asked Questions about perf-lighthouse

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

FAQPage Schema
How do I run Lighthouse audits locally using the CLI?

Run Lighthouse audits locally via the CLI by executing the command against any URL to measure performance and generate reports. The Skill invokes the Lighthouse CLI with specific flags to parse scores and extract key metrics.

Can I run Lighthouse audits programmatically using a Node API?

Yes, you can integrate the Node API to run Lighthouse audits programmatically. This approach allows you to execute audits within scripts, automatically extracting key performance metrics and parsing JSON reports for further analysis.

How do I enforce performance budgets in CI workflows?

Define performance budgets and enforce them within local or CI workflows to fail builds when limits are exceeded. The Skill applies budget enforcement by parsing JSON results and guiding optimizations based on the defined thresholds.

What is the best way to parse Lighthouse JSON reports for performance metrics?

Parsing Lighthouse JSON reports involves invoking the audit via CLI or Node API and extracting the performance metrics from the generated output. The Skill implements JSON parsing to interpret results and apply budget enforcement.

Does Lighthouse budget enforcement work in local development environments?

Yes, Lighthouse budget enforcement works in both local and CI workflows. You can define budgets locally and parse the JSON results to measure performance, ensuring your site speed meets the specified thresholds before deployment.