performance-budget-enforcer

Enforce performance budgets on bundle sizes, Lighthouse scores, and Web Vitals in CI/CD pipelines.

6|Updated Nov 11, 2025
One-click install
npx skills add https://github.com/hopeoverture/worldbuilding-app-skills --skill performance-budget-enforcer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-budget-enforcer
Source: https://github.com/hopeoverture/worldbuilding-app-skills/tree/main/skills/development/performance-budget-enforcer
Command: npx skills add https://github.com/hopeoverture/worldbuilding-app-skills --skill performance-budget-enforcer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps teams enforce performance budgets across deployments by monitoring JavaScript bundle sizes, Lighthouse scores, and Web Vitals, and by surfacing alerts when budgets are exceeded.

Core Features & Use Cases

  • Budget definitions: bundles, Lighthouse scores, and Web Vitals are defined and tracked.
  • CI integration: integrates with CI/CD to run checks during builds and PRs.
  • Automated enforcement: blocks deployments or marks builds failing when budgets are breached.
  • Reporting: generates trend reports and actionable insights over time.

Quick Start

Configure budgets in performance-budget.json (and use scripts/generate_budget.py to initialize). Integrate the checks into your CI workflow (e.g., GitHub Actions) and start monitoring from the next deploy.

Frequently Asked Questions about performance-budget-enforcer

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

FAQPage Schema
How do I prevent performance regressions in my CI/CD pipeline?

Performance regressions are prevented by enforcing budgets on bundle sizes, Lighthouse scores, and Web Vitals metrics during CI/CD workflows. Define thresholds in a performance-budget.json configuration file, integrate checks into your build pipeline, and deployments are blocked automatically when budgets are exceeded.

Can I monitor JavaScript bundle size and Lighthouse scores together?

Yes, bundle size and Lighthouse scores are monitored simultaneously across initial, route, and total bundles plus Lighthouse categories. The Skill tracks both metrics in a single configuration, generates unified reports, and gates deployments when either metric breaches its budget.

What's the best way to set up performance budgets for Web Vitals?

Configure Web Vitals thresholds in performance-budget.json alongside bundle and Lighthouse budgets. Use the included generation script to initialize baselines, integrate checks into your CI workflow such as GitHub Actions, and start monitoring from your next deployment automatically.

Do I need special tooling to track bundle size across deployments?

The Skill includes Python scripts—check_budgets.py and track_bundle_size.py—that compute bundle overruns and compare metrics across deployments. No external tooling is required; configuration and the provided scripts handle tracking, reporting, and deployment blocking end-to-end.

How do I generate alerts when performance budgets are exceeded?

Integrate the budget checks into your CI/CD pipeline; when metrics exceed thresholds, the Skill generates alerts, marks builds as failing, and blocks deployments. CI platforms like GitHub Actions surface these alerts automatically as part of build status and PR checks.