eval-harness

Define and run capability and regression evals for Claude Code sessions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A formal evaluation framework for Claude Code sessions, implementing eval-driven development (EDD) principles.

Core Features & Use Cases

  • Capability Evals and Regression Evals to validate AI behavior
  • Graders: code-based, model-based, and human evaluators for flexible scoring
  • Metrics: pass@k and pass^k with a centralized eval registry
  • End-to-end workflow: define, implement, evaluate, and report
  • Storage pattern: store definitions and logs under .claude/evals

Quick Start

Define your first eval with /eval define feature-name and then implement, run checks, and generate a report with /eval report feature-name.

Frequently Asked Questions about eval-harness

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

FAQPage Schema
How do I set up AI model evaluation for Claude Code sessions?

To set up AI model evaluation for Claude Code sessions, define your first eval with /eval define feature-name, then implement, run checks, and generate a report using /eval report feature-name.

What is eval-driven development and how does it apply to prompt engineering?

Eval-driven development for prompt engineering validates AI behavior through capability and regression evals, enforcing pass@k and pass^k metrics to improve development reliability across model updates.

Can I use human graders alongside automated code graders for AI testing?

Yes, the AI testing framework supports code-based, model-based, and human evaluators as graders, providing flexible scoring options for validating Claude Code session behavior.

What's the best way to prevent regressions when updating AI workflows?

The best way to prevent regressions in AI workflows is implementing regression evals that enforce pass@k and pass^k metrics, storing definitions and logs under the .claude/evals directory.

Does the evaluation framework require external dependencies to run capability evals?

No external dependencies are required to run capability evals; the framework operates self-contained within Claude Code, managing eval definitions and logs under the .claude/evals storage pattern.

Why define evals before implementing features in an AI testing workflow?

Defining evals before implementing features establishes clear capability and regression benchmarks, ensuring the end-to-end workflow from definition to reporting maintains AI development reliability.