bench-compare

Compare Criterion and hyperfine benchmark deltas between two git worktrees.

106|3|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ewhauser/shuck --skill bench-compare-ewhauser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bench-compare
Source: https://github.com/ewhauser/shuck/tree/main/.claude/skills/bench-compare
Command: npx skills add https://github.com/ewhauser/shuck --skill bench-compare-ewhauser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Compare benchmark performance between two git worktrees (or the current worktree vs main). Runs Criterion microbenchmarks and hyperfine macrobenchmarks, extracts deltas, and drills down into regressions. Use this skill whenever you need to verify performance parity or identify regressions across branches.

Core Features & Use Cases

  • Compare Criterion microbenchmarks (lexer, parser, semantic, linter) and hyperfine macrobenchmarks (wall-clock performance) across two worktrees.
  • Extract deltas and highlight regressions to guide optimization and risk assessment.
  • Use case: compare a feature branch against main to ensure no meaningful performance regressions before merging; also useful for CI performance validation and perf regressions triage.

Quick Start

Run the bench-compare workflow to generate a delta report comparing two git worktrees.

Frequently Asked Questions about bench-compare

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

FAQPage Schema
How do I compare benchmark performance between two git worktrees?

To compare benchmark performance between two git worktrees, you run a workflow that executes Criterion microbenchmarks and hyperfine macrobenchmarks on both, extracting performance deltas to generate a comparative report. It contrasts a feature worktree against main.

How can I detect performance regressions before merging a feature branch?

You can detect performance regressions before merging by running benchmark comparisons against the main branch. The generated delta report highlights wall-clock macrobenchmark and microbenchmark regressions to guide optimization and assess risk.

Does bench-compare work with both Criterion microbenchmarks and hyperfine macrobenchmarks?

Yes, bench-compare works with both Criterion microbenchmarks and hyperfine macrobenchmarks. It runs both benchmark types across git worktrees to extract deltas, covering components like lexer, parser, semantic, and linter performance alongside wall-clock times.

What setup do I need to benchmark performance across git worktrees?

Benchmarking performance across git worktrees requires specific setup such as shared target directories. This shared directory configuration is necessary for the tool to correctly execute and compare Criterion and hyperfine benchmarks between the current and main worktrees.

Can I use this for CI performance validation and release testing?

Yes, you can use this for CI performance validation and release testing. It is designed to verify performance parity and identify regressions across branches, making it suitable for continuous integration workflows and triaging performance regressions during releases.