eval-harness

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

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/sakamoto-family-smile/agent_monorepo --skill eval-harness-sakamoto-family-smile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-harness
Source: https://github.com/sakamoto-family-smile/agent_monorepo/tree/main/.claude/skills/ecc/eval-harness
Command: npx skills add https://github.com/sakamoto-family-smile/agent_monorepo --skill eval-harness-sakamoto-family-smile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Capability and Regression eval types to structure testing across model iterations.
  • Multiple grader options (Code, Model, Human) with clear success criteria and storage for results.
  • Guidance on an end-to-end eval lifecycle from define to report with storage in .claude/evals.

Quick Start

Define an eval feature with /eval define feature-name and implement tests, then run /eval check feature-name to execute the eval.

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 for Claude Code and when do I need it?

Eval-driven development (EDD) for Claude Code is a formal evaluation framework that structures testing across model iterations. You need it when researchers and engineers require capability and regression evaluations with structured eval lifecycles stored under .claude/evals.

How do I run regression evals to check Claude Code capabilities?

To run regression evals, define an eval feature with /eval define feature-name, implement tests, then execute /eval check feature-name. This workflow supports multiple grader options including Code, Model, and Human graders with clear success criteria.

Can I use pass@k metrics with custom graders in Claude Code evaluations?

Yes, Claude Code evaluations support pass@k metrics alongside multiple grader options. You can implement custom code graders, use model-based grading, or define human grading criteria to evaluate capability and regression eval definitions across model versions.

Does Claude Code eval framework support automated testing storage and reporting?

The Claude Code eval framework provides a structured eval lifecycle from define to report with storage in .claude/evals. It stores eval results and integrates with /eval commands to manage the end-to-end evaluation workflow for model versions.

What's the best way to structure capability evals across different model versions?

The best way to structure capability evals across model versions is using the EDD framework's formal lifecycle: define eval features with /eval define, implement tests with appropriate graders, execute with /eval check, and store results under .claude/evals for regression tracking.