Agent skill · AI & Agents

eval-harness

Formal evaluation framework for Claude Code sessions implementing eval-driven development (EDD) principles

vibeevalgithub.com/vibeevalGitHub ↗
claude-codeMIT
Install
npx skills add vibeeval/vibecosystem --skill eval-harness --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 5 KB
Bundled scripts: none
Path: skills/eval-harness/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 521
Language: C#

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Eval Harness Skill A formal evaluation framework for Claude Code sessions, implementing eval-driven development (EDD) principles. ## Philosophy Eval-Driven Development treats evals as the "unit tests of AI development": - Define expected behavior BEFORE implementation - Run evals continuously during development - Track regressions with each change - Use pass@k metrics for reliability measurement ## Eval Types ### Capability Evals Test if Claude can do something it couldn't before: ```markdown [CAPABILITY EVAL: feature-name] Task: Description of what Claude should accomplish Success Criteria: - [ ] Criterion 1 - [ ] Criterion 2 - [ ] Criterion 3 Expected Output: Description of expected result ``` ### Regression Evals Ensure changes don't break existing functionality: ```markdown [REGRESSION EVAL: feature-name] Baseline: SHA or checkpoint name Tests: - existing-test-1: PASS/FAIL - existing-test-2: PASS/FAIL - existing-test-3: PASS/FAIL Result: X/Y passed (previously Y/Y) ``` ## Grader Types ### 1. Code-Based Grader Deterministic checks using code: ```bash # Check if file contains expected pattern grep -q "export function handleAuth" src/auth.ts && echo "PASS" || echo "FAIL" # Check

What's inside
Steps it walks through
  1. Philosophy
  2. Eval Types
  3. Capability Evals
  4. Regression Evals
  5. Grader Types
  6. 1. Code-Based Grader
  7. 2. Model-Based Grader
  8. 3. Human Grader
  9. Metrics
  10. pass@k
  11. pass^k
  12. Eval Workflow
  13. 1. Define (Before Coding)
  14. 2. Implement
Commands it runs
Check if file contains expected pattern
grep -q "export function handleAuth" src/auth.ts && echo "PASS" || echo "FAIL"
Check if tests pass
npm test -- --testPathPattern="auth" && echo "PASS" || echo "FAIL"
Check if build succeeds
npm run build && echo "PASS" || echo "FAIL"
Run capability evals
Run regression evals
npm test -- --testPathPattern="existing"
Generate report
More from vibecosystem
All skills →
About this skill
What does the eval-harness skill do?

Formal evaluation framework for Claude Code sessions implementing eval-driven development (EDD) principles

How do I install it?

Run `npx skills add vibeeval/vibecosystem --skill eval-harness --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From vibeeval/vibecosystem, a repository with 521 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going