agent-eval

Compare coding agents on custom tasks using pass rate, cost, time, and consistency metrics.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Agent-eval addresses the challenge of determining which coding agent is best suited for your tasks by providing a head-to-head comparison with pass rate, cost, time, and consistency metrics.

Core Features & Use Cases

  • Comparison of Coding Agents: Evaluates performance on custom tasks using Claude Code, Aider, Codex, and more.
  • Custom Task Declarative Definition: Tasks are defined declaratively, specifying what to do, files to touch, and criteria for success.
  • Git Worktree Isolation: Each run is isolated within a git worktree to prevent interference between agents.
  • Performance Metrics: Provides pass rate, cost, time, and consistency metrics to aid in decision-making.
  • Use Case: When comparing Claude Code to Codex on custom code review tasks, agent-eval can help you decide which tool offers better performance.

Quick Start

To start evaluating coding agents, run 'agent-eval run --task tasks/example-task.yaml --agent claude-code --agent codex --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 agent performance on custom tasks?

You can evaluate coding agent performance by running head-to-head comparisons on custom tasks. The tool uses declarative task definitions to measure pass rate, cost, time, and consistency metrics, helping you determine which agent is best suited for your specific requirements.

How do I define custom tasks for benchmarking coding agents?

Custom tasks for benchmarking coding agents are defined declaratively. You specify what the agent needs to do, which files to touch, and the criteria for success within a YAML file. This ensures consistent evaluation across multiple agents and runs.

How do I prevent interference when running multiple coding agent evaluations?

To prevent interference when running multiple coding agent evaluations, each run is automatically isolated within a git worktree. This ensures that file modifications and environment changes made by one agent do not impact the results of another during comparative benchmarking.

Can I compare Claude Code and Codex on the same code review task?

Yes, you can compare Claude Code and Codex on the same code review task. By specifying multiple agents in the run command, the tool evaluates both on your custom task and provides comparative metrics like pass rate, cost, time, and consistency to aid your tool selection.

What metrics are used for evaluating coding agent performance?

Evaluating coding agent performance uses pass rate, cost, time, and consistency as primary metrics. These quantitative measures provide a comprehensive view of agent effectiveness, efficiency, and reliability when completing custom coding tasks.

Does agent-eval work without external dependencies?

Yes, agent-eval works without external dependencies. The tool requires no additional packages or modules to function, allowing you to directly run comparative analysis on coding agents within your existing development environment.