ln-34-benchmark-comparator

Compares tools or implementations through reproducible A/B workloads, correctness oracles, and controlled measurements.

556|83|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-34-benchmark-comparator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ln-34-benchmark-comparator
Source: https://github.com/levnikolaevich/claude-code-skills/tree/main/plugins/optimization-suite/skills/ln-34-benchmark-comparator
Command: npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-34-benchmark-comparator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Choosing between competing tools, libraries, or implementations often relies on anecdote or vendor claims rather than controlled evidence. This Skill enforces a rigorous, reproducible A/B benchmarking process so decisions rest on measured correctness and performance data instead of guesswork.

Core Features & Use Cases

  • Controlled Experiment Design: Freezes scenarios, oracles, metrics, repetition counts, and decision rules before any candidate runs, preventing biased or post-hoc conclusions.
  • Symmetric Harness and Activation Proof: Runs every candidate through identical isolated worktrees, runners, and logging, and verifies each candidate actually executed rather than silently falling back.
  • Validity-First Analysis: Grades correctness before speed, separates setup from steady-state cost, reports spread and failure classes, and produces WIN, TIE, INCONCLUSIVE, or BLOCKED verdicts with cleanup confirmation.
  • Use Case: When deciding between two HTTP client libraries, define representative request workloads and a correctness oracle, run both candidates repeatedly in clean worktrees, and receive a verdict backed by raw per-run evidence.

Quick Start

Use the benchmark comparator skill to design and run a controlled A/B comparison between these two implementations and tell me which one to adopt.

Frequently Asked Questions about ln-34-benchmark-comparator

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

FAQPage Schema
How do I benchmark two tools or implementations fairly?

Define scenarios, correctness oracles, metrics, and a decision rule before running anything, then execute both candidates through the same runner in isolated clean worktrees. Repeat runs a predefined number of times and report median, spread, and failures rather than the best run.

How to choose between two libraries with A/B testing?

Build a symmetric harness that runs both libraries on identical workloads from the same commit, grade correctness against an independent oracle first, then compare performance and cost. Use a predefined decision rule to reach a WIN, TIE, or INCONCLUSIVE verdict.

Why should correctness be graded before performance in benchmarks?

A faster candidate that produces wrong results is not a valid alternative, so correctness failure cannot be offset by better speed or cost. Grading correctness first against an independent oracle prevents invalid candidates from contaminating the performance comparison.

What makes benchmark results unreliable or invalid?

Results become unreliable when candidates run in contaminated environments, activation is not verified, scenarios are tuned after seeing results, or single best runs are reported. Environmental drift, cache leakage, and unequal tuning budgets also invalidate comparisons.

When should I not use A/B benchmark comparison?

Do not use it when candidates do not solve the same task, correctness cannot be independently graded, or external side effects cannot be isolated. It is also the wrong tool for optimizing a single known bottleneck rather than choosing between alternatives.