agent-evals

Installation
SKILL.md

Agent evals — proving the thing behaves

An agent's behaviour does not exist in its source. The code says what it is allowed to do; only a run says what it did. So the artifact under test is the execution record, and the suite runs on two clocks: the observable is authored up front, before the implementation exists, and the corpus it runs against is grown from production (§6).

Three claims follow, and they are what makes this different from testing ordinary code:

  • You are testing reasoning, not code paths, so one granularity is never enough.
  • Every natural-language input is unique, so the edge cases cannot be enumerated offline. Production is not only where you catch what you missed — it is where you discover what to test for.
  • Traces become test cases. The corpus grows from what actually happened; the criterion it is measured against does not.

1. Three primitives

Installs
127
GitHub Stars
4
First Seen
Aug 12, 2026
agent-evals — ssheleg/agent-stack