eval-harness

Automate formal evaluation workflows for Claude Code sessions with pass@k metrics.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/thmspi/claude-setup --skill eval-harness-thmspi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-harness
Source: https://github.com/thmspi/claude-setup/tree/main/.claude/skills/eval-harness
Command: npx skills add https://github.com/thmspi/claude-setup --skill eval-harness-thmspi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Formal evaluation frameworks for Claude Code sessions enabling eval-driven development (EDD) principles to guide AI-assisted software development and reliability testing.

Core Features & Use Cases

  • Defines capability and regression evals with structured criteria, baselines, and pass/fail reporting.
  • Supports multi-grader workflows (code-based, model-based, and human review) and a centralized eval storage.
  • Enables repeatable, auditable comparisons of model versions to detect regressions.

Quick Start

Define your evals with the /eval define command, run checks with /eval check, and generate a report with /eval report.

Frequently Asked Questions about eval-harness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is eval-driven development and how do formal evaluations guide AI coding sessions?

Eval-driven development uses formal evaluation frameworks to guide AI-assisted software development by defining capability and regression evals with structured success criteria, baselines, and pass/fail reporting to ensure model reliability.

How do I set up regression evals and measure pass@k metrics across model versions?

You set up regression evals by defining structured criteria and baselines, then run automated check workflows to measure pass@k metrics across model versions, enabling repeatable and auditable comparisons to detect regressions.

Can I use model-based grading and human review together in an evaluation workflow?

Yes, the evaluation framework supports multi-grader workflows allowing you to combine code-based, model-based, and human review graders to assess AI coding session outputs comprehensively.

How do I define, run, and report on AI testing criteria for Claude Code sessions?

You define evals using the define command, execute validation checks with the check command, and generate comprehensive pass/fail evaluation reports using the report command for end-to-end workflow automation.

Does the evaluation framework require external dependencies to store eval definitions?

No external dependencies are required as the framework provides centralized eval storage natively, storing all eval definitions locally under the .claude/evals directory for auditable access.

What is the best way to automate regression detection when comparing AI model versions?

The best way to automate regression detection is implementing formal evaluation workflows that apply structured criteria and pass@k metrics to generate repeatable, auditable comparisons across different model versions.