eval-harness

Define, execute, and report capability and regression evals for Claude Code sessions.

1.8k|303|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/xu-xiang/everything-claude-code-zh --skill eval-harness-xu-xiang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eval-harness
Source: https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/zh-TW/skills/eval-harness
Command: npx skills add https://github.com/xu-xiang/everything-claude-code-zh --skill eval-harness-xu-xiang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a formal evaluation framework for Claude Code sessions, enabling eval-driven development by defining clear evaluation criteria before implementation and continuously validating changes through structured evals.

Core Features & Use Cases

  • Capability and regression evals to validate new features and prevent regressions.
  • Multiple grader options (code-based, model-based, and human) to score changes.
  • Integrated workflow from eval definition to reporting, with metrics like pass@k and pass^k for reliability.

Quick Start

Create an eval definition under .claude/evals (e.g., add-authentication.md), then run: /eval define add-authentication /eval check add-authentication /eval report add-authentication

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 eval-driven development for Claude Code sessions?▼

Eval-driven development for Claude Code requires creating standardized eval definitions in .claude/evals, then running commands to execute checks and generate reports with pass@k and pass^k metrics.

What are capability and regression evals in an evaluation framework?▼

Capability and regression evals validate new features and prevent regressions by continuously checking changes against structured evaluation criteria defined before implementation.

How do I run model-based and code-based graders for software testing evals?▼

Software testing evals support multiple grader types including code-based, model-based, and human graders to score changes within the integrated workflow from definition to reporting.

Can I define custom evaluation criteria before implementation in Claude Code?▼

Yes, you can define custom evaluation criteria before implementation by creating a standardized eval definition file under .claude/evals and executing it through the formal workflow commands.

What is the best way to measure pass@k reliability metrics for Claude Code evaluations?▼

Measuring pass@k and pass^k reliability metrics is handled natively by the eval-harness framework, which generates these metrics automatically when you run the report command on your eval definitions.