Skip to content
Skills Library
DevOps & cloud · Automation

performance-budgets

/performance-budgets

Set numeric performance budgets and enforce them in CI so regressions fail the build instead of reaching users. Use when performance keeps sliding release over release or a team wants to hold a latency or bundle target.

Repository
AI-SKILLS ↗
Licence
MIT
Last repository change
05.09.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 05.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Set numeric performance budgets and enforce them in CI so regressions fail the build instead of reaching users. Use when performance keeps sliding release over release or a team wants to hold a latency or bundle target.

Original author description

Set numeric performance budgets and enforce them in CI so regressions fail the build instead of reaching users. Use when performance keeps sliding release over release or a team wants to hold a latency or bundle target.

How it works

  1. Method
  2. Checks
  3. Boundaries
Original SKILL.md headings · 47 lines, 379 words
SKILL.md preview
---
name: performance-budgets
description: Set numeric performance budgets and enforce them in CI so regressions fail the build instead of reaching users. Use when performance keeps sliding release over release or a team wants to hold a latency or bundle target.
---

# Performance budgets

A budget turns "feels slow" into a number a build can check. Without one,
performance decays by a few milliseconds per merge until someone notices in
production, and by then no single commit is to blame. The budget names the
number, the metric, and the gate that trips before the regression ships.

## Method

1. **Pick metrics tied to user pain, not vanity counters.** For web, use
   Largest Contentful Paint, Interaction to Next Paint, and total transfer
   size per route. For services, use p95 and p99 latency and requests per
   second at a fixed error rate. "Average response time" hides the tail
   where users actually suffer.
2. **Set thresholds from current p75, not aspiration.** Measure the field or
   lab baseline, then set the budget slightly tighter: if LCP p75 is 2.4s,
   budget 2.5s to stop drift, and open a separate goal to reach 2.0s. A
   budget you already fail on merge one is noise.
3. **Enforce in CI as a failing check.** Run Lighthouse CI with
   `assert.assertions` on `largest-contentful-paint` and `total-byte-weight`,
   or `size-limit` for bundles, or `k6` thresholds like
   `http_req_duration: ['p(95)<300']`. Exit nonzero so the pull request goes
   red, not yellow.
4. **Measure on stable hardware.** Lab numbers swing with runner load. Pin a
   dedicated runner or median three runs, and compare against the base branch
   in the same job so machine noise cancels.
5. **Budget the things that grow silently:** JavaScript bytes, image weight,
   database query count per request, and third-party script count. These
   creep without any one author feeling responsible.
6. **Make the failure message actionable.** Print the metric, the budget, the
   measured value, and the delta from base: "bundle 512KB over 480KB budget,
   +34KB since main". A red X with no number gets bypassed.

## Checks

- Does a synthetic commit that adds a 100KB dependency turn the build red?
- Can any engineer read the budget file and name every threshold in units?
- Do the CI numbers track field data, or has lab drifted from real users?

## Boundaries

Budgets catch regressions against a baseline; they do not tell you the right
target. Deriving the target from user research or revenue impact is a product
decision. For diagnosing why a specific number regressed, defer to profiling
and the relevant optimization skill.

Versions

RepositoryScoreLicence
This page · Amey-Thakur/AI-SKILLS90MIT
zakariaf/reactnative-skills100MIT
jacob-balslev/skill-graph100Apache-2.0

Database snapshot: 13.11.2026 · package version 90e335997e43 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100performance-engineer-role
    Operate as a performance engineer who sets budgets, gates regressions in CI, and runs profiling as a service other teams rely on. Use when latency, throughput, memory, or GPU utilization matters and you want measured wins, not folklore optimizations.
  • 100detecting-performance-regressions
    Automatically detect performance regressions in CI/CD pipelines by comparing metrics against baselines. Use when validating builds or analyzing performance trends. Trigger with phrases like "detect performance regression", "compare performance metrics", or "analyze performance degradation".
  • 100detecting-performance-regressions
    Automatically detect performance regressions in CI/CD pipelines by comparing metrics against baselines. Use when validating builds or analyzing performance trends. Trigger with phrases like "detect performance regression", "compare performance metrics", or "analyze performance degradation".
  • 100performance-capacity
    Plan, diagnose, and verify performance budgets, latency targets, load tests, capacity estimates, bottleneck analysis, caching strategy, query efficiency, queue throughput, and regression gates. Use when a feature may be slow, a system must scale, a performance regression is…
  • 90planning-performance-budgets
    Use when planning performance budgets is required during architecture work, especially when the result must be traceable, independently reviewable, and safe to hand to another agent.
  • 100validating-performance-budgets
    Validate application performance against defined budgets to identify regressions early. Use when checking page load times, bundle sizes, or API response times against thresholds. Trigger with phrases like "validate performance budget", "check performance metrics", or "detect performance regression".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.