eval-harness

Define and run formal evaluations for AI-assisted development tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Eval-harness provides a structured, repeatable evaluation framework to prevent regressions and measure reliability in AI-assisted development, turning vague success criteria into measurable tests and metrics.

Core Features & Use Cases

  • Eval Definitions: Create capability and regression evals that define success criteria before implementation.
  • Grading Options: Support deterministic code graders, model-based graders for open-ended outputs, and human review flags for high-risk changes.
  • Metrics & Reporting: Track pass@k and pass^k, store run history, and generate EVAL REPORTs for benchmarking and release gating.
  • Use Case: Define evals for a new authentication feature, run automated capability and regression checks, and record pass@k for continuous monitoring across model versions.

Quick Start

Run /eval define feature-name to create a new eval definition file in .claude/evals and begin authoring capability and regression tests.

Frequently Asked Questions about eval-harness

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

FAQPage Schema
How do I run regression testing for AI-assisted development tasks?

You can define and run formal evaluations for AI-assisted development tasks by applying this framework to Claude Code sessions, executing code- and model-based graders, and recording run history under .claude/evals.

What is pass@k reliability measurement in AI development?

Pass@k reliability measurement tracks the probability that a model's output meets success criteria within k attempts. This framework calculates and reports pass@k and pass^k metrics to benchmark AI capabilities across model versions.

How do I define success criteria before implementing an AI feature?

You define success criteria by creating eval definitions using the command to generate a new file in .claude/evals. This allows you to author capability and regression tests that establish measurable thresholds before implementation begins.

Can I use model-based graders for open-ended AI outputs?

Yes, you can use model-based graders to evaluate open-ended outputs. The framework supports deterministic code graders, model-based graders, and human review flags for high-risk changes to ensure comprehensive capability testing.

Does eval-driven development work without external dependencies?

Yes, eval-driven development works without external dependencies. The framework operates independently to produce structured eval definitions, execute graders, and generate EVAL REPORTs for benchmarking and release gating.

What's the best way to benchmark AI capabilities across model versions?

The best way to benchmark AI capabilities is to run formal evaluations that track pass@k and pass^k metrics. This framework stores run history and generates EVAL REPORTs to provide structured benchmarking and release gating across versions.