benchmark

Detects web performance regressions by comparing page metrics against captured baselines.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/VertaKhan/cs_gstack --skill benchmark-vertakhan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: benchmark
Source: https://github.com/VertaKhan/cs_gstack/tree/main/.claude/skills/gstack/benchmark
Command: npx skills add https://github.com/VertaKhan/cs_gstack --skill benchmark-vertakhan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web performance degrades gradually across pull requests, and teams often cannot pinpoint when load times or bundle sizes regressed. This Skill measures real page performance, captures baselines, and flags regressions before they ship. ## Core Features & Use Cases - Baseline Capture & Comparison: Record TTFB, FCP, LCP, DOM timings, transfer sizes, and request counts per page, then compare current metrics against the saved baseline with regression thresholds. - Resource & Bundle Analysis: Identify the slowest resources, track JS/CSS bundle sizes, and check results against industry performance budgets with a letter grade. - Trend Tracking: Load historical benchmark files to visualize performance trends over time and detect gradual degradation. - Use Case: Before merging a PR, run a benchmark against your staging URL to confirm the new feature did not double LCP or add 300KB to the JavaScript bundle. ## Quick Start Ask the AI to run /benchmark on your app's URL to audit page performance and compare it against the saved baseline.

Frequently Asked Questions about benchmark

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

FAQPage Schema
How do I detect performance regressions before merging a pull request?▼

Capture a baseline with /benchmark <url> --baseline before making changes, then run /benchmark <url> on your branch. The skill compares TTFB, FCP, LCP, bundle sizes, and request counts against the baseline and flags regressions using relative thresholds.

What metrics does a web performance benchmark measure?▼

It measures TTFB, First Contentful Paint, Largest Contentful Paint, DOM Interactive, DOM Complete, full load time, total requests, transfer size, and JS/CSS bundle sizes. Data comes from the browser's performance.getEntries() API, not estimates.

How to benchmark only pages affected by my current branch?▼

Use /benchmark --diff mode. It runs git diff against the base branch to identify changed files and benchmarks only the pages impacted by those changes, rather than auditing every page.

Can I track website performance trends over time?▼

Yes, use /benchmark --trend to load historical baseline files and display a table of FCP, LCP, bundle size, request count, and grade across past benchmarks. This reveals gradual degradation that single runs miss.

What are the regression thresholds for page speed benchmarks?▼

Timing metrics regress at over 50% increase or 500ms absolute increase, with warnings at 20%. Bundle sizes regress at 25% increase with warnings at 10%, and request counts warn at 30% increase.

Why does the benchmark require a baseline to detect regressions?▼

Without a baseline, the skill can only report absolute numbers, which are meaningless without context since acceptable load times vary by page type. Relative comparison against your own baseline is what identifies actual regressions.