bench-check

Compare current benchmark results against a saved baseline to detect performance regressions.

86|20|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/optave/ops-codegraph-tool --skill bench-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bench-check
Source: https://github.com/optave/ops-codegraph-tool/tree/main/.claude/skills/bench-check
Command: npx skills add https://github.com/optave/ops-codegraph-tool --skill bench-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Bench-check identifies performance regressions by comparing current benchmark results against a saved baseline, preventing silent slowdowns across releases.

Core Features & Use Cases

  • Automated baseline comparison: runs full benchmark suites and detects regressions beyond a threshold.
  • Baseline management: can save a new baseline or update an existing one.
  • Detailed results and reports: outputs a JSON metrics object and a human-readable report.

Quick Start

Run the bench-check tool to execute the benchmarks and compare results against the saved baseline.

Frequently Asked Questions about bench-check

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

FAQPage Schema
How do I detect performance regressions in my Node.js CI workflows?

You can detect performance regressions by running benchmark suites that compare current metrics against a saved baseline. Bench-check executes build time, incremental rebuild, query depth, and embedding recall benchmarks to identify slowdowns beyond a set threshold.

What is benchmark baseline comparison and when do I need it?

Benchmark baseline comparison is the process of saving initial performance metrics and evaluating subsequent test runs against them. You need it to prevent silent slowdowns across releases by detecting regressions in build time or query performance.

How do I update the benchmark baseline after fixing a performance regression?

You can update the benchmark baseline by running the bench-check tool to save a new baseline or overwrite the existing one. This replaces the saved metrics at generated/bench-check/baseline.json with your current optimized performance results.

Do I need a Node.js environment to run automated benchmark reporting?

Yes, you need a Node.js environment to run the benchmark scripts. Bench-check relies on scripts like benchmark.js, incremental-benchmark.js, query-benchmark.js, and embedding-benchmark.js to execute tests and generate JSON metrics with human-readable reports.

What specific metrics are included in a performance regression report?

A performance regression report includes metrics for build time, incremental rebuilds, query depth, and embedding recall. The tool outputs a JSON metrics object alongside a human-readable report detailing any detected regressions beyond the threshold.

Can I use bench-check for incremental build benchmarks without a saved baseline?

No, bench-check requires a saved baseline at generated/bench-check/baseline.json to compare current benchmark results. Without an existing baseline, you must first run the tool to save initial metrics before detecting future regressions.