agent-eval

Compare coding agents on YAML-defined tasks with git worktree isolation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/lllooollpp/solopreneur- --skill agent-eval-lllooollpp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-eval
Source: https://github.com/lllooollpp/solopreneur-/tree/main/solopreneur/data/skills/agent-eval
Command: npx skills add https://github.com/lllooollpp/solopreneur- --skill agent-eval-lllooollpp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This CLI tool benchmarks coding agents head-to-head on reproducible tasks, turning subjective opinions into data-driven decisions.

Core Features & Use Cases

  • YAML task definitions to declare what each agent should do and how success is judged
  • Git worktree isolation for reproducible, deterministic runs across agents
  • Metrics collection (pass rate, cost, time, and consistency) to compare performance across tasks
  • Use case: verify which agent handles a given codebase task best before committing to a toolchain

Quick Start

Create a tasks/ directory with YAML task definitions and run agent-eval against multiple agents to generate a comparison report.

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 to compare performance?

You can benchmark coding agents by running them against reproducible YAML task definitions and collecting metrics like pass rate, cost, time, and consistency. This approach isolates runs using git worktrees to ensure deterministic, comparable results across different tools.

What is the best way to evaluate which coding agent handles my codebase best?

Evaluating coding agents requires comparing them on reproducible tasks within your codebase. By defining tasks in YAML and recording quantitative metrics such as pass rate and execution time, you can identify the best-performing tool through data-driven analysis.

Does agent-eval support benchmarking for tools like Claude Code and Aider?

Yes, benchmarking is applicable to evaluating Claude Code, Aider, Codex, and other coding agents. The tool compares these agents across codebases using per-task metrics to identify the highest-performing option.

How do git worktrees isolate coding agent runs for reproducible experiments?

Git worktrees provide isolation for coding agent runs by creating separate working directories from the same repository. This ensures reproducible, deterministic experiments by preventing agents from interfering with each other or modifying shared state.

Can I define my own success criteria when comparing coding agents?

Yes, you define success criteria using YAML task definitions that declare what each agent should do and how success is judged. This allows customizable evaluation tailored to specific codebase tasks and expected outcomes.

What metrics are recorded when running reproducible coding agent comparisons?

Reproducible coding agent comparisons record pass rate, cost, time, and consistency metrics. These quantitative results are collected across tasks to generate a comprehensive comparison report for analysis.