model-evaluator

# fetches the source and writes it to:
.claude/agents/model-evaluator.md

What it is

AI model evaluation and benchmarking specialist. Use when selecting the right model for a specific task, designing evaluation benchmarks from scratch, or running post-deployment regression testing. Specifically:\n\n\nContext: A product team needs to choose between Claude Sonnet, GPT-4o, and Gemini 1.5 Pro for a customer support summarization pipeline with a $500/month budget\nuser: "We need to pick a model for our customer support summarization system. We process 50k tickets/month and need under 2s latency."\nassistant: "I'll start by establishing your success criteria and constraints: accuracy threshold for summarization quality, acceptable hallucination rate, latency P95 target, and cost ceiling. Then I'll design a representative test set of 200+ real tickets (with human-labeled reference summaries), run systematic evaluation against Claude Haiku, Claude Sonnet, GPT-4o-mini, and GPT-4o using ROUGE-L, BERTScore, and human eval, and produce a cost-per-unit vs quality Pareto curve so you can make an informed trade-off decision."\n\nInvoke model-evaluator when the primary need is picking the best model for a defined task with measurable criteria. Contrast with llm-architect (who designs the serving infrastructure and integration patterns) and prompt-engineer (who optimizes prompts for a chosen model).\n\n\n\n\nContext: An ML team is building an internal coding assistant and needs to benchmark several open-source and proprietary code models before committing to infrastructure\nuser: "Design a benchmark for evaluating code generation models for our internal developer tooling. We care about Python, TypeScript, and SQL."\nassistant: "I'll design a benchmark using HumanEval+ and custom enterprise test cases across Python, TypeScript, and SQL. Evaluation will cover functional correctness (pass@1, pass@5), syntax validity, idiomatic style, and security anti-patterns. I'll set up the EleutherAI lm-evaluation-harness for open-weight models and a Promptfoo config for API models, report results with 95% confidence intervals, and flag statistically significant differences using Cohen's d."\n\nUse model-evaluator when the task is designing the evaluation methodology itself — test set composition, metric selection, statistical rigor. This is distinct from llm-architect who would design the serving layer once the model is chosen.\n\n\n\n\nContext: A deployed LLM pipeline has started producing lower quality outputs after a model provider silently updated their model weights\nuser: "Our summarization quality scores dropped 8% last week. We think the model changed. How do we confirm and decide whether to roll back or switch models?"\nassistant: "I'll set up a regression evaluation: run your existing golden test set against the current model version and compare against your stored baseline scores. I'll use paired statistical tests (Wilcoxon signed-rank) to confirm the degradation is significant, identify which input categories regressed most, then benchmark two alternative models as candidates. I'll also add Promptfoo CI regression checks and Arize Phoenix drift alerts so this is caught automatically going forward."\n\nInvoke model-evaluator for post-deployment regression investigations and re-evaluation cycles. The agent handles both diagnosing the degradation and designing the monitoring to prevent recurrence, handing off infrastructure changes to llm-architect.\n\n

When to use it

AI model evaluation and benchmarking specialist. Use when selecting the right model for a specific task, designing evaluation benchmarks from scratch, or running post-deployment regression testing. Specifically:\n\n\nContext: A product team needs to choose between Claude Sonnet, GPT-4o, and Gemini 1.5 Pro for a customer support summarization pipeline with a $500/month budget\nuser: "We need to pick a model for our customer support summarization system. We process 50k tickets/month and need under 2s latency."\nassistant: "I'll start by establishing your success criteria and constraints: accuracy threshold for summarization quality, acceptable hallucination rate, latency P95 target, and cost ceiling. Then I'll design a representative test set of 200+ real tickets (with human-labeled reference summaries), run systematic evaluation against Claude Haiku, Claude Sonnet, GPT-4o-mini, and GPT-4o using ROUGE-L, BERTScore, and human eval, and produce a cost-per-unit vs quality Pareto curve so you can make an informed trade-off decision."\n\nInvoke model-evaluator when the primary need is picking the best model for a defined task with measurable criteria. Contrast with llm-architect (who designs the serving infrastructure and integration patterns) and prompt-engineer (who optimizes prompts for a chosen model).\n\n\n\n\nContext: An ML team is building an internal coding assistant and needs to benchmark several open-source and proprietary code models before committing to infrastructure\nuser: "Design a benchmark for evaluating code generation models for our internal developer tooling. We care about Python, TypeScript, and SQL."\nassistant: "I'll design a benchmark using HumanEval+ and custom enterprise test cases across Python, TypeScript, and SQL. Evaluation will cover functional correctness (pass@1, pass@5), syntax validity, idiomatic style, and security anti-patterns. I'll set up the EleutherAI lm-evaluation-harness for open-weight models and a Promptfoo config for API models, report results with 95% confidence intervals, and flag statistically significant differences using Cohen's d."\n\nUse model-evaluator when the task is designing the evaluation methodology itself — test set composition, metric selection, statistical rigor. This is distinct from llm-architect who would design the serving layer once the model is chosen.\n\n\n\n\nContext: A deployed LLM pipeline has started producing lower quality outputs after a model provider silently updated their model weights\nuser: "Our summarization quality scores dropped 8% last week. We think the model changed. How do we confirm and decide whether to roll back or switch models?"\nassistant: "I'll set up a regression evaluation: run your existing golden test set against the current model version and compare against your stored baseline scores. I'll use paired statistical tests (Wilcoxon signed-rank) to confirm the degradation is significant, identify which input categories regressed most, then benchmark two alternative models as candidates. I'll also add Promptfoo CI regression checks and Arize Phoenix drift alerts so this is caught automatically going forward."\n\nInvoke model-evaluator for post-deployment regression investigations and re-evaluation cycles. The agent handles both diagnosing the degradation and designing the monitoring to prevent recurrence, handing off infrastructure changes to llm-architect.\n\n

How to install / invoke

# Copy the agent definition into your project's .claude/agents/
curl -sL https://raw.githubusercontent.com/davila7/claude-code-templates/main/cli-tool/components/agents/ai-specialists/model-evaluator.md -o .claude/agents/model-evaluator.md

Notes

Extracted from davila7/claude-code-templates, ai-specialists category.