eval-harness

Define, run, and report evaluations for Claude Code sessions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/zh667/person-blog --skill eval-harness-zh667
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-harness
Source: https://github.com/zh667/person-blog/tree/main/.cursor/.agents/skills/eval-harness
Command: npx skills add https://github.com/zh667/person-blog --skill eval-harness-zh667

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Formalizes and streamlines eval-driven development workflows for Claude Code sessions, enabling consistent evaluation criteria and automated reporting.

Core Features & Use Cases

  • Define capability and regression evaluations with structured criteria.
  • Run evaluations deterministically with multiple graders and pass/fail metrics.
  • Track regressions across model versions and generate evaluation reports.

Quick Start

Define your first evaluation and run it with the built-in /eval workflow.

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 regression checks for AI code generation tasks?

You can set up regression checks by defining structured capability and regression evaluations with pass/fail criteria. The framework allows you to track regressions across model versions and generate automated evaluation reports for your AI sessions.

What is pass@k scoring and how does it work for code assessment?

Pass@k is a formal scoring metric supported by this evaluation framework to measure code generation reliability. It evaluates whether at least one successful outcome exists within k attempts, providing quantitative assessment for AI-generated code tasks.

How do I run automated evaluations for Claude Code sessions?

You can run evaluations using the built-in /eval CLI workflow. Define your evaluation criteria, select from multiple grader types, and execute the evaluation to generate pass/fail metrics and formal scoring reports.

Can I track AI model regressions across different versions?

Yes, the framework supports tracking regressions across model versions. By defining consistent evaluation criteria and running deterministic evaluations, you can compare reliability metrics and identify performance degradations between different AI model versions.

Does this evaluation framework require any external dependencies?

No, the evaluation harness operates without external dependencies. It provides a self-contained eval storage pattern and integrated CLI workflow, allowing you to define, run, and report evaluations directly within your development environment.

What types of graders can I use for AI testing evaluations?

The framework supports multiple grader types for deterministic evaluation runs. You can define custom pass/fail criteria for capability and regression evaluations, enabling flexible code assessment tailored to your specific AI testing requirements.