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.