lighthouse-pagespeed-stinger

Configures Lighthouse CI and PageSpeed Insights audits with performance budgets and lab-versus-field reconciliation.

84|37|Updated May 23, 2026
One-click install
npx skills add https://github.com/legioncodeinc/vibe-coding-tools --skill lighthouse-pagespeed-stinger-legioncodeinc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lighthouse-pagespeed-stinger
Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/main/src/skills/lighthouse-pagespeed-stinger
Command: npx skills add https://github.com/legioncodeinc/vibe-coding-tools --skill lighthouse-pagespeed-stinger-legioncodeinc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web performance work fails when teams misconfigure Lighthouse CI, set arbitrary score budgets that block deploys, or misread the gap between lab scores and CrUX field data (especially the TBT vs INP divergence). This Skill encodes the correct Lighthouse 12.6.1 / LHCI 0.15.x patterns so audits are reproducible, budgets are grounded in baselines, and field data is interpreted correctly. ## Core Features & Use Cases - LHCI CI Setup: Production-ready lighthouserc configuration with collect/assert/upload blocks, GitHub Actions workflows, and the critical fetch-depth: 20 gotcha for ancestor detection. - Performance Budgets: Guidance on minScore vs maxNumericValue assertions, median-run vs pessimistic aggregation, and the measure-baseline-first workflow before gating CI. - Lab vs Field Reconciliation: A framework for diagnosing why a Lighthouse score of 90 can coexist with failing CrUX INP, using the PSI API's loadingExperience and lighthouseResult blocks. - Use Case: A developer sees "Lighthouse says 92 but PageSpeed Insights says INP is Poor." The Skill walks through pulling the PSI API response, identifying the TBT/INP gap, and locating heavy interaction handlers in a Performance trace. ## Quick Start Ask the AI to set up Lighthouse CI with a performance budget for your Next.js app using this skill's starter template and configuration guides.

Frequently Asked Questions about lighthouse-pagespeed-stinger

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

FAQPage Schema
How do I set up Lighthouse CI in GitHub Actions?▼

Install @lhci/cli@0.15.x, commit a lighthouserc.json with collect/assert/upload blocks, and run lhci autorun in a workflow. Set fetch-depth: 20 in actions/checkout or LHCI's ancestor detection fails with 'Could not find hash' errors.

Why is my Lighthouse score high but CrUX field data failing?▼

Lab and field data measure different conditions: Lighthouse simulates a slow device (4x CPU, 1.6 Mbps) with cold cache, while CrUX reflects real users at p75. The most common gap is TBT versus INP, since good TBT does not guarantee good INP.

What is the difference between TBT and INP in Lighthouse?▼

TBT measures blocking tasks during page load and is Lighthouse's lab proxy for responsiveness. INP measures the full interaction lifecycle (delay, processing, presentation) and is field-only, so it never appears in the Lighthouse Performance score.

How do I set a performance budget without breaking CI?▼

Run LHCI without an assert block first to measure your production baseline, then set minScore or maxNumericValue at the baseline plus a 10-20% buffer. Use median-run aggregation for Performance scores and pessimistic for binary audits like Accessibility.

Can Lighthouse plugins collect custom data from the page?▼

No. Plugins can only read existing Lighthouse artifacts like ScriptElements, ImageElements, and devtoolsLogs; they cannot use custom Gatherers. Collecting new page data requires a full custom Lighthouse config instead of a plugin.

Does Lighthouse 12 still include the PWA category?▼

No. The PWA category was removed in Lighthouse 12 (May 2024). Current reports have four categories: Performance, Accessibility, Best Practices, and SEO.