benchmark

Measure page load metrics and resource sizes to detect performance regressions across branches and PRs.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/ibalasite/gstack --skill benchmark-ibalasite
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: benchmark
Source: https://github.com/ibalasite/gstack/tree/main/benchmark
Command: npx skills add https://github.com/ibalasite/gstack --skill benchmark-ibalasite

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect silent performance regressions that accumulate across commits by measuring real page load metrics, Core Web Vitals, and resource sizes so you can find when and why a site got slower.

Core Features & Use Cases

  • Baseline capture and comparison: save baseline snapshots and compare current runs to detect regressions per page and per PR.
  • Comprehensive metrics: collects TTFB, FCP, LCP, DOM timings, full load, resource sizes, request counts, and bundle breakdowns via JavaScript evaluation.
  • CI and trend analysis: used in pull request workflows to alert on regressions and to display historical trends and performance budget compliance.
  • Use Case: run before and after a large dependency upgrade to ensure LCP and JS bundle size did not regress.

Quick Start

Run /benchmark https://your-site.example --baseline to capture a baseline, then run /benchmark https://your-site.example to compare the current branch against that baseline and generate a report.

Frequently Asked Questions about benchmark

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

FAQPage Schema
How do I detect web performance regressions in a pull request?

You detect performance regressions in pull requests by comparing current Core Web Vitals and bundle sizes against a saved baseline. This Skill measures page load metrics across branches to alert you on regressions.

What metrics do I need to track for frontend performance regression detection?

Frontend performance regression detection requires tracking TTFB, FCP, LCP, DOM timings, full load times, resource sizes, request counts, and bundle breakdowns to identify when and why a site gets slower.

How do I set up a performance baseline for my web application?

You set up a performance baseline by running the benchmark command against your site URL with the baseline flag. This captures a snapshot of current Core Web Vitals and bundle sizes for future comparison.

Does performance benchmarking require a browser daemon to evaluate JavaScript?

Yes, performance benchmarking requires a browse daemon capable of navigating pages and evaluating JavaScript. This daemon collects real page load metrics and writes baseline and report files to the benchmark-reports directory.

Can I audit bundle size and request counts in my CI workflow?

Yes, you can audit bundle sizes and request counts in your CI workflow. This Skill integrates into pull request workflows to measure resource sizes, display historical trends, and check performance budget compliance.

Why should I measure Core Web Vitals before and after a dependency upgrade?

You should measure Core Web Vitals before and after a dependency upgrade to ensure LCP and JS bundle size did not regress. This prevents silent performance regressions from accumulating across commits.