Skip to content
Research
Skill

/design-ai-benchmarking

Use when designing a study that benchmarks AI systems against a human-expert panel, before data collection. Plans the arms, decoupled rubrics with anchors, planted calibration probes, reviewer panel, inter-rater reliability targets and LLM-as-judge versus human adjudication.

BOOST
From plugin
medsci-skills
34462 skills
Install
$ npx -y skills add Aperivue/medsci-skills --skill design-ai-benchmarking --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/design-ai-benchmarking

Context preview

The summary Claude sees to decide when to auto-load this skill.

Use when designing a study that benchmarks AI systems against a human-expert panel, before data collection. Plans the arms, decoupled rubrics with anchors, planted calibration probes, reviewer panel, inter-rater reliability targets and LLM-as-judge versus human adjudication.

SKILL.md

design-ai-benchmarking.SKILL.md
name: design-ai-benchmarking
description: Use when designing a study that benchmarks AI systems against a human-expert panel, before data collection. Plans the arms, decoupled rubrics with anchors, planted calibration probes, reviewer panel, inter-rater reliability targets and LLM-as-judge versus human adjudication.
metadata:
  triggers: "AI benchmarking, AI vs human expert, reader study design, expert panel evaluation, LLM-as-judge, AI evaluation rubric, model benchmark design, human baseline comparison, AI-output rating, evaluation rubric design"

Design-AI-Benchmarking Skill

Standard Output

## AI-Benchmark Design Review
Evaluation question: ...
Arms / systems compared: ...
Reference (human-expert panel): ...
Unit of rating: (item / case / output)

### Rubric (decoupled dimensions)
- dimension -> construct -> anchors (1..k)

### Calibration probes (blinded, randomized)
- positive-control / known-bad / instability / mechanism-contradiction

### Reviewer panel
- n reviewers, metadata captured, per-reviewer randomized order

### Reliability plan
- IRR target on the anchor set of real items (ICC form + 95% CI) + control-item hit rate (a competence check, reported separately)

### Judge strategy
- human-as-judge / LLM-as-judge / both + adjudication rule

### Validity risks
1. ...

### Minimal fixes
- ...

### Decision
- Ready to collect / Needs rubric revision / Needs arm or judge redesign

Reviewer ratings, reference labels, probe outcomes and agreement statistics come only from collected rating records. Never invent them: a reported ICC, kappa or score with no underlying rating record is the failure this skill exists to prevent. Cite a reference only with a `/search-lit`-confirmed DOI or PMID; mark any other `[UNVERIFIED - NEEDS MANUAL CHECK]`. Flag an unconfirmed clinical definition, diagnostic criterion or guideline recommendation `[VERIFY]` and ask the user.

---

Workflow

Phase 1: Define the evaluation question and arms

Pin down, in writing:

  • the exact claim the benchmark must support (e.g., "system A's outputs are perceptually

indistinguishable from expert outputs", not "system A is deployment-ready")

  • every arm/system and what each receives as input (same items, same information access, same output

format), so no arm has a hidden advantage

  • the human-expert reference: who they are, and whether they set ground truth, form a comparison arm,

or both

  • the unit of rating (item, case, output) and how many units each reviewer sees

**Gate:** Present the reconstructed evaluation question, arms, and reference to the user and confirm before designing the rubric. A wrong reconstruction misdirects the entire benchmark.

Phase 2: Design a decoupled multi-dimensional rubric

  • **Decouple the axes.** Each rated dimension measures one construct. Keep "is the output

valid/correct" separate from "is it novel", "is it feasible/measurable", "does it add value over current tools", and "would it change action". A candidate can be high-validity yet low-added-value ("real but redundant"); a single blended score hides this.

  • **Anchor every scale point** with a short verbal descriptor; pilot the anchors with at least one

reviewer before locking.

  • **Pre-specify discriminant validity**: hypothesize which dimensions should correlate vs be

orthogonal, then report the full inter-dimension correlation matrix.

  • Start from `${CLAUDE_SKILL_DIR}/references/elicitation_rubric_template.md` (dimensions, anchors,

probe flavors).

Phase 3: Insert and randomize calibration probes

Plant a few deliberate control items, blinded and randomized across raters (record who received which via a `probe_arm` flag), to anchor the scale, measure rater drift/fatigue, and audit the rubric and pipeline. Four flavors:

  • **Positive control / "too-good" item** — near-tautological; tests whether raters equate "largest

effect" with "best", and whether the construct-independence gate (Phase 7) works.

  • **Known-bad negative control** — an engineered defect (fabricated reference, missing key statistic).
  • **Instability item** — an estimate that reverses or fails to replicate on a holdout.
  • **Mechanism-contradiction item** — an empirical direction that opposes the proposed mechanism.

Probes are *planted or adjudicated*, never fabricated to fit a hypothesis.

Phase 4: Construct the reviewer panel

  • Recruit reviewers spanning the intended expertise gradient; pre-specify any stratification.
  • Capture reviewer metadata (years of experience, prior AI-evaluation experience, subspecialty).
  • Randomize item order **per reviewer** (not one global seed), record the order, and plan to analyze

order and fatigue effects.

  • Require each item to be judged standalone; cross-item references in free text signal

non-independent rating.

**Gate:** Present the panel composition, stratification, and randomization plan for user review before recruitment is finalized.

Phase 5: Set inter-rater reliability targets

  • Pre-specify the reliability statistic **and its form** — for several raters, an ICC with the

model stated (e.g. ICC(2,1): two-way random, absolute agreement, single rater) or Krippendorff's α (ordinal); weighted (Cohen's) kappa is a two-rater statistic — and a justified target. Size the number of **items** for the CI width you need: ICC precision is driven mainly by the item count (Koo & Li, *J Chiropr Med* 2016).

  • **Planted control items are a rater-competence check, not reliability evidence.** Report the hit

rate on known-good vs known-bad controls. Do not present an ICC computed on the controls as evidence of rubric or scale validity: ICC scales with the spread between items, controls are extreme by construction, so their ICC is high whatever the raters' reliability on real items (same five raters, same noise: ICC(2,1) 0.89 on four planted controls, 0.16 on 40 real items), and it rests on a handful of items.

  • **Report reliability on the representative
Read more
Ships withmedsci-skills

Created & maintained by Yoojin Nam, MD Department of Radiology and Research Institute of Radiology, University of Ulsan College of Medicine, Asan Medical Center, Seoul, Republic of Korea MedSci Skills is a set of Agent Skills for clinical research: literature

Get the whole plugin

Other skills on medsci-skills.