hamelsmu avatar

Validate Evaluator

This walks you through calibrating an LLM judge against human labels using proper train/dev/test splits and TPR/TNR metrics. You'd use it after writing a judge prompt when you need to verify it actually agrees with human judgment before trusting it in production. The workflow is methodical: split your labeled data, iterate on the dev set until you hit 90% TPR and TNR, then measure once on the held-out test set. It includes the Rogan-Gladen bias correction formula for estimating true success rates from biased judge scores, plus bootstrap confidence intervals. The anti-pattern section is worth reading since most people skip validation entirely and just assume judges work.

skills.sh installs
739
GitHub stars
1.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add hamelsmu/evals-skills --skill validate-evaluator --agent claude-code

Installs into .claude/skills of the current project.

Files

Validate Evaluator

Calibrate an LLM judge against human judgment.

Overview

  1. Split human-labeled data into train (10-20%), dev (40-45%), test (40-45%)
  2. Run judge on dev set and measure TPR/TNR
  3. Iterate on the judge until TPR and TNR > 90% on dev set
  4. Run once on held-out test set for final TPR/TNR
  5. Apply bias correction formula to production data

Prerequisites

  • A built LLM judge prompt (from write-judge-prompt)
  • Human-labeled data: ~100 traces with binary Pass/Fail labels per failure mode
    • Aim for ~50 Pass and ~50 Fail (balanced, even if real distribution is skewed)
    • Labels must come from a domain expert, not outsourced annotators
  • Candidate few-shot examples from your labeled data

Core Instructions

Step 1: Create Data Splits

Split human-labeled data into three disjoint sets:

Sponsors

Details

Repository
github.com/hamelsmu/evals-skills
Categories
Testing & QA, Documentation, AI & Agent Building
First seen
Jun 3, 2026

More from hamelsmu/evals-skills

All 7
1alirezarezvani avatardemo-videoalirezarezvani/claude-skillsUse when the user asks to create a demo video, product walkthrough, feature showcase, animated presentation, marketing video, or GIF from screenshots or scene d736skills.sh installs
2alirezarezvani avatarrevenue-operationsalirezarezvani/claude-skillsAnalyzes sales pipeline health, revenue forecasting accuracy, and go-to-market efficiency metrics for SaaS revenue optimization. Use when analyzing sales pipeli733skills.sh installs
3joellewis avatarforward-riskjoellewis/finance_skillsEstimate potential future losses using VaR, Expected Shortfall, Monte Carlo simulation, and stress testing. Use when the user asks about Value-at-Risk, CVaR, Ex733skills.sh installs
4mblode avatarui-auditmblode/agent-skillsAudits built React and Next.js frontends for user-facing defects in code and rendered UI: state gaps, data loss, double submits, focus and keyboard failures, ro733skills.sh installs
5syncfusion avatarsyncfusion-react-blockeditorsyncfusion/react-ui-components-skillsImplement the Syncfusion React BlockEditor component for block-based content editing. Use this skill for block-based rich content editing, document creation, CM731skills.sh installs
6alirezarezvani avatarproduct-discoveryalirezarezvani/claude-skillsUse when validating product opportunities, mapping assumptions, planning discovery sprints, or testing problem-solution fit before committing delivery resources729skills.sh installs