performance-budget-guard

Enforces performance budgets on routes, queries, and assets during code review and CI checks.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/lgerard314/global-plugin --skill performance-budget-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-budget-guard
Source: https://github.com/lgerard314/global-plugin/tree/main/plugin/skills/performance-budget-guard
Command: npx skills add https://github.com/lgerard314/global-plugin --skill performance-budget-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews and enforces performance budgets on routes, dependencies, heavy computations, DB queries on hot paths, and UI changes to prevent regressions in Core Web Vitals and bundle size.

Core Features & Use Cases

  • Enforces per-route JS bundle budgets in CI to block merges when budgets are exceeded.
  • Evaluates new dependencies for size, tree-shakability, and whether smaller alternatives exist before they are added.
  • Checks hot-path DB queries for p95 latency budgets and requires baseline measurements or caching justification.
  • Recommends targeted memoization after profiling, avoiding blanket memoization.
  • Encourages proper image optimization and caching strategies to minimize layout shifts and load times.
  • Defines a multi-layer cache TTL with explicit invalidation rules and documentation.

Quick Start

Apply this guard to a target project and review all hot-path changes against the seven core budget rules.

Frequently Asked Questions about performance-budget-guard

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

FAQPage Schema
How do I enforce performance budgets in CI to prevent Core Web Vitals regressions?

You enforce performance budgets by applying a guard during code reviews and CI checks that blocks merges when per-route bundle sizes or hot-path query p95 latencies exceed defined limits.

What is the best way to evaluate new dependencies for bundle size impact?

Evaluating new dependencies for bundle size impact involves analyzing their size, tree-shakability, and whether smaller alternatives exist before adding them to a route bundle.

When do I need memoization for hot-path database queries?

Memoization for hot-path database queries is needed when profiling reveals p95 latency budget violations, requiring targeted memoization and caching justification rather than blanket optimization.

Can I use cache TTL and invalidation rules to minimize layout shifts?

Cache TTL and invalidation rules help minimize layout shifts by defining a multi-layer cache topology with explicit invalidation rules, optimizing image loading and caching strategies.

Does this performance budget guard work for code reviews of UI changes?

Yes, the performance budget guard works for code reviews of UI changes by checking new routes, heavy computations, and asset modifications against seven core budget rules to prevent regressions.