Make agent performance measurable — and improvable¶
Evaluate skills and agent capabilities with one declarative
eval.yaml: analyze, generate cases, run, judge, trace in MLflow, then
optimize. Same config on your laptop, Harbor containers, or EvalHub.
Get started eval.yaml reference
Made at Red Hat
How the loop works¶
-
Point
/eval-analyzeat a skill or a prompt brief. The harness writeseval.yamlwith judges, schema, and thresholds. -
/eval-datasetfills cases from your schema — or bring your owncases/tree with gold references. -
/eval-runexecutes on Claude Code (or another runner), scores with LLM + code judges, and emits a rich HTML report. -
Optional
/eval-reviewcaptures human feedback on scored cases before you change the skill or config. -
Optional
/eval-mlflowsyncs metrics, artifacts, and hierarchical GenAI traces for every case. -
/eval-optimizeproposes skill fixes from failures and re-runs so you keep only real gains.
What you get¶
-
Skill or prompt mode
Test a packaged skill (
execution.skill) or agent capability directly (execution.prompt) — including agentic documentation checks. -
LLM + code judges
Built-in judges, inline Python checks, rubrics, pairwise A/B, and N-sample stability — all in one config.
-
One config, three backends
Local subprocess, Harbor (Podman / OpenShift), or EvalHub — backend is a CLI flag, never baked into
eval.yaml. -
Any agent runtime
Claude Code out of the box; bring OpenCode or a custom CLI / Responses API runner when you need it.
-
Reward API for RL
Collapse judges into a
[0, 1]reward for GRPO-style training via Harbor / NeMo Gym / SkyRL. -
MLflow-native
Experiments, datasets, hierarchical traces, and feedback sync — opt in with one
mlflow:block.
Choose your path¶
| Path | Use it when | Start |
|---|---|---|
| Claude Code plugin | You want slash commands in an existing project | claude plugin install agent-eval-harness@opendatahub-skills |
| Local clone | You are hacking on the harness itself | git clone https://github.com/opendatahub-io/agent-eval-harness |
| Harbor / OpenShift | You need containerized, reproducible trials | Running on Harbor |
claude plugin install agent-eval-harness@opendatahub-skills
/eval-setup
/eval-analyze --skill my-skill
/eval-dataset
/eval-run --model opus
Explore the docs¶
-
Get Started
Install and run your first evaluation end to end.
-
Guides
Task-oriented how-tos for every skill and backend.
-
Concepts
Execution model, judges, rewards, and tracing.
-
Cookbook
Worked configs for common evaluation scenarios.
-
Reference
eval.yaml schema, CLI, config fields, and glossary.