eval-harness

Define and run Gemini CLI capability and regression evals with pass@k metrics.

Updated Sep 13, 2025
One-click install
npx skills add https://github.com/llmh333/employee_management_spring --skill eval-harness-llmh333
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-harness
Source: https://github.com/llmh333/employee_management_spring/tree/main/.gemini/skills/eval-harness
Command: npx skills add https://github.com/llmh333/employee_management_spring --skill eval-harness-llmh333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Eval-harness helps teams define expected AI behavior, run repeatable evaluations, and detect regressions in Gemini CLI workflows so improvements don’t break reliability.

Core Features & Use Cases

  • Eval-driven development (EDD) for AI: Define capability and regression evals before implementation to lock in success criteria.
  • Grader strategy support: Use deterministic code graders, model-based graders, or human review markers for different risk levels.
  • Reliability metrics tracking: Measure pass@k and pass^k to quantify performance across attempts and critical paths.
  • Workflow templates for report generation: Store and run eval definitions and produce structured EVAL REPORTs for accountability and iteration.

Quick Start

Use the command /egc-eval define feature-name to create an eval definition file in .gemini/evals for the behavior you want Gemini CLI to achieve.

Frequently Asked Questions about eval-harness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent AI regressions in Gemini CLI workflows?

To prevent AI regressions in Gemini CLI workflows, implement eval-driven development by defining expected behavior and running repeatable capability and regression evals to track reliability metrics.

What is eval-driven development for AI feature validation?

Eval-driven development for AI feature validation involves defining capability and regression evals before implementation, executing them, and tracking reliability metrics to ensure new improvements do not break existing behavior.

How do I measure pass@k and reliability metrics for AI outputs?

You measure pass@k and pass^k reliability metrics for AI outputs by running structured assessments using code, model, or human graders, then tracking performance across attempts and critical paths.

How do I set up regression testing for Gemini CLI sessions?

You set up regression testing for Gemini CLI sessions by defining expected behavior in an eval definition file with YAML frontmatter discovery metadata, then storing repeatable evals under the .gemini/ directory.

Can I use different grading strategies for AI reliability evaluations?

Yes, you can use different grading strategies for AI reliability evaluations by applying deterministic code graders, model-based graders, or human review markers to match varying risk levels.

What is the best way to generate structured reports for AI capability assessments?

The best way to generate structured reports for AI capability assessments is to use workflow templates that store eval definitions and automatically produce structured EVAL REPORTs for accountability and iteration.