Benchmark Card

A benchmark card records what a benchmark actually tests before using it to support a paper claim. It is the paper-reading counterpart of a dataset card.

A benchmark can be summarized as:

is data, is task, is split policy, is metric, and is preprocessing or protocol.

Use Benchmark intake before writing the card. The intake pass decides whether the reported score is testing the paper’s stated claim or only a narrower interpolation setting.

Fields

  • Task: what input-output mapping is evaluated.
  • Data source: public dataset or benchmark origin.
  • Unit of prediction: molecule, protein, complex, sequence, image, document, or run.
  • Split: random, scaffold, protein-family, temporal, source, or held-out target.
  • Metric: what number decides success.
  • Baseline: what comparison makes the metric meaningful.
  • Leakage risks: entity overlap, template leakage, duplicate records, or label leakage.
  • Contamination risks: pretraining, retrieval, prompt, feature, model-selection, or leaderboard feedback overlap.
  • Saturation status: whether score differences still exceed metric noise.
  • Scope: what deployment or scientific claim the benchmark can and cannot support.

Claim Fit

Benchmark cards should explicitly map score to claim:

Paper claimBenchmark must show
better generalizationsplit blocks the claimed shortcut
better rankingcandidate set and ranking metric match use case
better calibrationprobability metric and calibration check
better generationvalidity, novelty, diversity, and task utility
better efficiencylatency, throughput, memory, or cost under comparable hardware
better scientific fidelitydomain-specific validity checks, not only generic ML metrics

If the benchmark does not test the claim, route the result to a narrower note instead of repeating the broad claim.

Benchmark Identity

The same benchmark name can hide protocol differences:

Record enough detail to distinguish dataset version, split files, preprocessing, metric implementation, and excluded examples.

Checks

  • Does the split match the generalization claim?
  • Does the metric match the task objective?
  • Are preprocessing and filtering choices stated?
  • Is the final test set protected from contamination?
  • Is the benchmark saturated or still discriminative?
  • Can a simple baseline expose shortcut learning?
  • Are benchmark version and split files identifiable?
  • Does the benchmark measure the decision the system will actually make?