performance-budgets

Define enforceable performance budgets with metric, threshold, percentile, and consequence.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/jacob-balslev/skill-graph --skill performance-budgets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-budgets
Source: https://github.com/jacob-balslev/skill-graph/tree/main/marketplace/skills/performance-budgets
Command: npx skills add https://github.com/jacob-balslev/skill-graph --skill performance-budgets

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you replace subjective “it feels fast” goals with measurable performance thresholds that protect real user experience and prevent regressions.

Core Features & Use Cases

  • Defines a complete performance budget using metric, threshold, percentile, and consequence so it is a contract—not a vanity dashboard.
  • Covers the three budget axes (time, size, count) to catch different classes of performance regressions early.
  • Applies widely used standards like Core Web Vitals (LCP, INP, CLS), the RAIL model, and Lighthouse budgets.json with clear guidance for lab vs field vs synthetic measurement.
  • Operationalizes enforcement by treating budget breach as a build/deploy failure with calibration and per-route budget discipline.

Quick Start

Use performance-budgets to define a p75 Core Web Vitals budget for each meaningful route and make CI fail automatically when the budget is breached.

Frequently Asked Questions about performance-budgets

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

FAQPage Schema
What is a performance budget and how does it prevent regressions?

A performance budget establishes measurable thresholds across time, size, and count dimensions to catch regressions early. It replaces subjective goals with enforceable contracts specifying metric, threshold, percentile, and consequence for each route.

How do I enforce Core Web Vitals thresholds in CI?

To enforce Core Web Vitals in CI, define a p75 budget for metrics like LCP, INP, and CLS per route, then configure your deploy gate to automatically fail the build when those thresholds are breached.

How do I set up Lighthouse budgets.json for automated deploy gates?

Lighthouse budgets.json defines size and count thresholds for your application. You operationalize enforcement by treating budget breaches as build failures, ensuring automated deploy gates block regressions before they reach production.

What is the difference between lab and field measurement for Core Web Vitals?

Lab measurement provides controlled synthetic testing for consistent debugging, while field measurement captures real user experience at specific percentiles like p75. A complete budget defines measurement expectations for both environments.

Can I apply different performance thresholds for individual routes?

Yes, per-route budget discipline requires specifying distinct metric thresholds for each meaningful route. This calibration ensures performance contracts accurately reflect the specific loading and interaction demands of different application views.

When should I use RAIL model limits versus Core Web Vitals for budgets?

Use Core Web Vitals like LCP, INP, and CLS for user-facing loading and interaction metrics, and apply RAIL model limits for specific interaction classifications. Both standards define time thresholds that can trigger CI enforcement.