eval-harness

Automate formal evaluation workflows for Claude Code sessions with defined graders and lifecycle stages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured framework to define, execute, and observe evaluations for Claude Code sessions, enabling repeatable, traceable improvements through eval-driven development.

Core Features & Use Cases

  • Capability Evals: formal tests that verify new features behave as intended.
  • Regression Evals: checks that existing functionality remains intact after changes.
  • Grader Options: supports Code-Based, Model-Based, and Human graders for flexible assessment.
  • Workflow & Storage: a repeatable workflow with defined storage for eval definitions and histories.

Quick Start

Define a new evaluation workflow for a Claude Code feature and run: /eval define <feature-name>

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 automated evaluation workflows for Claude Code sessions?

Eval-harness automates formal evaluation workflows by defining capability and regression tests with multiple grader options. Start with /eval define <feature-name> to create a structured workflow, then execute evaluations with defined storage for definitions, logs, and baselines to track improvements systematically.

What's the difference between capability and regression evaluations?

Capability evals verify new features behave as intended, while regression evals check that existing functionality remains intact after changes. Eval-harness supports both through a single framework, enabling you to test new behavior and prevent breakage in one workflow.

Can I use different grading methods in the same evaluation?

Yes, eval-harness supports Code-Based, Model-Based, and Human graders for flexible assessment within a single evaluation framework. This lets you choose the most appropriate grading method for each test without switching tools.

How does eval-driven development improve Claude Code workflows?

Eval-driven development enables repeatable, traceable improvements by automating formal evaluations with defined lifecycles from define to report. You gain structured feedback on capability and regression tests, making incremental improvements measurable and observable.

What metadata and storage does eval-harness require?

Eval-harness requires frontmatter metadata to define evaluations and provides structured storage for eval definitions, execution logs, and baselines. This enables reproducible workflows and historical tracking of evaluation results across sessions.