agent-eval

Benchmark coding agents in isolated git worktrees with deterministic or model-based criteria.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/starrank-soft/PixelArraySkill --skill agent-eval-starrank-soft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-eval
Source: https://github.com/starrank-soft/PixelArraySkill/tree/main/skills/agent-eval
Command: npx skills add https://github.com/starrank-soft/PixelArraySkill --skill agent-eval-starrank-soft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of objective, reproducible performance data when choosing or updating coding agents like Claude Code, Aider, or Codex, replacing subjective feelings with hard metrics.

Core Features & Use Cases

  • Head-to-Head Comparison: Run multiple coding agents against the same tasks to measure success rates, costs, and execution time.
  • Deterministic Benchmarking: Use custom YAML task definitions with built-in test suites (pytest, grep, or LLM-based judges) to validate agent output.
  • Use Case: Before upgrading your team to a new model, run a suite of 5 common refactoring tasks to verify that the new agent maintains a high pass rate without significantly increasing API costs.

Quick Start

Run the agent-eval skill to compare the performance of claude-code and aider on the tasks defined in the tasks directory over three iterations.

Frequently Asked Questions about agent-eval

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

FAQPage Schema
How do I benchmark coding agents for performance and cost?

Compare coding agents by running them against identical tasks within isolated git worktrees to measure pass rate, cost, and latency. This systematic benchmarking replaces subjective feelings with hard metrics for model selection.

Can I run a head-to-head comparison between Claude Code and Aider?

Run head-to-head comparisons between coding agents like Claude Code and Aider by executing them against the same custom YAML task definitions over multiple iterations. This directly measures their success rates, costs, and execution time.

What evaluation criteria are used for coding agent benchmarking?

Coding agent benchmarking evaluates results using deterministic criteria like pytest test suites and grep commands, alongside model-based LLM judges. You define these validation methods within custom YAML task definitions to verify agent output.

Do I need Python and git to run coding agent benchmarks?

Yes, you need Python and git to run coding agent benchmarks. Python manages task execution while git provides the isolated worktree environments required to test multiple agents safely without interfering with your main repository.

Why use isolated git worktrees for coding agent evaluation?

Isolated git worktrees provide separate environments for coding agent evaluation, preventing file conflicts when running multiple agents against the same repository. This ensures reproducible performance data for accurate comparative analysis.