agent-eval

Compare coding agents on custom YAML-defined tasks in isolated git worktrees.

1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/zero3041/PREP --skill agent-eval-zero3041
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-eval
Source: https://github.com/zero3041/PREP/tree/main/.claude/skills/skills/agent-eval
Command: npx skills add https://github.com/zero3041/PREP --skill agent-eval-zero3041

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The agent-eval Skill addresses the challenge of comparing coding agents' performance across various tasks, providing metrics on pass rate, cost, time, and consistency.

Core Features & Use Cases

  • Agent Comparison: Head-to-head comparison of coding agents like Claude Code, Aider, Codex, etc.
  • Custom Task Execution: Run custom tasks on coding agents and measure their performance.
  • Task Definition: Define tasks using YAML, specifying actions, files to touch, and criteria for success.
  • Reproducibility: Isolates each agent run in a fresh git worktree for accurate comparison.

Quick Start

Run the task 'add-retry-logic' against the agents 'claude-code' and 'aider' with 3 trials using the command: agent-eval run --task tasks/add-retry-logic.yaml --agent claude-code --agent aider --runs 3

Frequently Asked Questions about agent-eval

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

FAQPage Schema
How do I compare coding agents on custom tasks?

You can compare coding agents by defining tasks in YAML, executing them in isolated git worktrees, and measuring performance metrics like pass rate, cost, time, and consistency for accurate head-to-head evaluation.

How do I define custom tasks for coding agent performance comparison?

You define custom tasks for performance comparison using YAML files that specify the required actions, target files to touch, and the specific criteria for success to evaluate the coding agents accurately.

What is the best way to ensure reproducibility when benchmarking coding agents?

To ensure reproducibility when benchmarking coding agents, the evaluation system isolates each agent run in a fresh git worktree, preventing cross-contamination and keeping performance metrics accurate.

Does agent-eval support head-to-head comparison of specific coding agents?

Yes, the system supports head-to-head comparison of coding agents like Claude Code and Aider, allowing you to run multiple trials against custom YAML tasks to measure their pass rate and cost.

What metrics are tracked when running coding agents against YAML tasks?

When running coding agents against YAML tasks, the system tracks performance metrics including pass rate, execution cost, completion time, and consistency across multiple isolated runs.

How do I execute multiple trials for a coding agent comparison task?

You execute multiple trials by running the command with your YAML task file, specifying the target agents, and setting the desired number of runs to measure consistency and pass rate accurately.