aperivue/design-ai-benchmarking
> Design and validity review for studies that benchmark one or more AI systems against a human-expert panel as the reference. Covers the evaluation question and arm definition, decoupled multi-dimensional rubrics with anchors, planted calibration probes, reviewer-panel construction, inter-rater reliability targets, LLM-as-judge versus human-as-judge adjudication, construct-independence guards, and a structured rating-export schema. Use before data collection on an AI-vs-expert evaluation.
npx skills add https://github.com/Aperivue/medsci-skills --skill design-ai-benchmarking
This skill pressure-tests an AI-vs-human-expert benchmark before any ratings are collected, so that
the comparison is fair, the rubric measures distinct constructs, the scale is calibrated, and the
reported reliability is interpretable. It is the AI-evaluation specialization of /design-study: where
/design-study reviews a study in general, this skill owns the specific machinery of comparing AI
system(s) to a panel of human experts (or to each other) on rated outputs.
Use it when:
panel, AI-output evaluation, model-vs-model bench)
"low agreement, but we cannot tell why" criticism
Do not use it for: general study/validity review (use /design-study); statistical execution such
as ICC or DeLong (use /analyze-stats); reporting-guideline item audits (use /check-reporting);
or reviewing an already-written manuscript (use /peer-review or /self-review).
data only.
## 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
- overall IRR target + control-item IRR (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
Pin down, in writing:
indistinguishable from expert outputs", not "system A is deployment-ready")
access, same output format) so no arm has a hidden advantage
arm, or both
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.
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 divergence.
reviewer before locking.
then report the full inter-dimension correlation matrix to confirm the rubric measures distinct
constructs.
${CLAUDE_SKILL_DIR}/references/elicitation_rubric_template.md.Plant a small number of deliberate control items, blinded and randomized across raters (record who
received which via a probe_arm flag), to (i) anchor the scale, (ii) measure rater drift/fatigue, and
(iii) audit the rubric and pipeline itself. Four useful flavors:
raters equate "largest effect" with "best", and whether the construct-independence gate (Phase 7) works.
expected to score low.
caveat-handling.
Probes are *planted or adjudicated*, never fabricated to fit a hypothesis.
descriptive reporting and stratified analysis.
order and fatigue effects.
non-independent rating.
Gate: Present the panel composition, stratification, and randomization plan for user review before
recruitment is finalized.
and a target with justification.
scale validity. A low overall ICC is interpretable only if raters at least converge on the controls;
surfacing both numbers prevents "low agreement => bad rubric" or "bad raters" misreads.
/analyze-stats).
When the item pool is larger than one reader can rate in a session, do not force every reader
to rate every item (that caps the total pool at the per-reader limit and discards coverage). Use an
anchor-and-rotate (balanced-incomplete-block) layout: all readers rate a shared anchor set
(which carries the inter-rater ICC/kappa, alongside the planted controls), and each reader
additionally rates a rotating unique block, so total coverage grows independently of the
per-reader cap. The usually-binding constraint is the number of available expert readers, not the
item count — solve the reverse problem (max_pool = anchor + R*(cap-anchor)//m) to size the must-rate
set to a realistic panel. Pre-specify anchor membership, raters-per-item, and the rotation seed before
rating. Formulas, trade-offs, and a stdlib reference implementation are in
${CLAUDE_SKILL_DIR}/references/anchor_rotate_reader_allocation.md.
whose ratings must themselves be validated against the human panel on the control items.
consensus discussion) and who adjudicates.
definition), and flag near-tautological composites built from the outcome's defining components — they
produce an inflated, near-circular result and belong as labeled probes, not discoveries.
Define the machine-readable rating record up front: per-item ratings across every rubric dimension,
free-text justifications, follow-up flags, the probe_arm flag, reviewer id and metadata, item order,
and timing. A synthetic schema lives in ${CLAUDE_SKILL_DIR}/references/benchmark_export_schema.json.
Gate: Present the final rubric, probe set, panel plan, judge strategy, and export schema together;
collect explicit user approval before any rating begins. Locking these before data collection is the
whole point — changes afterward compromise the comparison.
/analyze-stats for ICC / weighted kappa / DeLong, agreement sample size, and effect-sizereal-world translation of the benchmark results
/check-reporting for STARD-AI, CLAIM, or TRIPOD+AI item-level reporting once the design is locked/design-study when the broader study around the benchmark (cohort logic, analysis unit,comparator) also needs review
/peer-review or /self-review only after ratings exist and a manuscript is being assessed/analyze-stats)./search-lit with a confirmed DOIor PMID. Mark unverified references as [UNVERIFIED - NEEDS MANUAL CHECK].
come from collected data only. A reported ICC, kappa, or score with no underlying rating record is the
failure mode this skill exists to prevent.
flag with [VERIFY] and ask the user.
uncertainty rather than guessing.
${CLAUDE_SKILL_DIR}/references/elicitation_rubric_template.md -- a synthetic, decoupledmulti-dimension rating rubric with anchors and a planted-probe column.
${CLAUDE_SKILL_DIR}/references/benchmark_export_schema.json -- a synthetic JSON schema for theper-item rating export (ratings, justifications, probe_arm, reviewer metadata, order, timing).
${CLAUDE_SKILL_DIR}/references/anchor_rotate_reader_allocation.md -- anchor-and-rotate(balanced-incomplete-block) reader allocation: formulas, the reverse "max pool for R readers"
ceiling, trade-offs, and a stdlib reference implementation (Phase 5b).
Take aperivue/design-ai-benchmarking from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.