Eval

alirezarezvani/claude-skills/engineering/agenthub/skills/eval

by alirezarezvani19392f7a0826No license27K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 5 weeks ago

Evaluate and rank agent results by metric or LLM judge for an AgentHub session. Use when the user runs /hub:eval or asks to score, compare, or pick a winner among completed AgentHub agents.

Instructions onlyAI & Agents
AI-generated overview

Ranks completed AgentHub agent results by metric, LLM judge, or hybrid evaluation and names a winner.

What it does
This skill evaluates and ranks all agent results for an AgentHub session. It supports metric mode, which runs a configured evaluation command per agent worktree and ranks by a chosen metric and direction, and LLM judge mode, which compares agent diffs and result posts on correctness, simplicity, and quality. A hybrid mode runs metrics first and uses the judge to break ties within 10 percent. It outputs a ranked table with a highlighted winner and updates session state.
When to use it
Use it when the user runs /hub:eval or asks to score, compare, or pick a winner among completed AgentHub agents. It fits sessions where multiple agent results exist and a single best result must be chosen before merging.
Requirements
Requires an AgentHub session with completed agent results and git branches or worktrees to inspect. Metric mode needs a configured evaluation command and metric; LLM judge mode needs an LLM judge. The document references scripts result_ranker.py and session_manager.py, but no scripts ship with this skill.

/hub:eval — Evaluate Agent Results

Rank all agent results for a session. Supports metric-based evaluation (run a command), LLM judge (compare diffs), or hybrid.

Usage

/hub:eval                           # Eval latest session using configured criteria/hub:eval 20260317-143022           # Eval specific session/hub:eval --judge                   # Force LLM judge mode (ignore metric config)

What It Does

Metric Mode (eval command configured)

Run the evaluation command in each agent's worktree:

bash
python {skill_path}/scripts/result_ranker.py \  --session {session-id} \  --eval-cmd "{eval_cmd}" \  --metric {metric} --direction {direction}

Output:

RANK  AGENT       METRIC      DELTA      FILES1     agent-2     142ms       -38ms      22     agent-1     165ms       -15ms      33     agent-3     190ms       +10ms      1
Winner: agent-2 (142ms)

LLM Judge Mode (no eval command, or --judge flag)

For each agent:

  1. Get the diff: git diff {base_branch}...{agent_branch}
  2. Read the agent's result post from .agenthub/board/results/agent-{i}-result.md
  3. Compare all diffs and rank by:
    • Correctness — Does it solve the task?
    • Simplicity — Fewer lines changed is better (when equal correctness)
    • Quality — Clean execution, good structure, no regressions

Present rankings with justification.

Example LLM judge output for a content task:

RANK  AGENT    VERDICT                               WORD COUNT1     agent-1  Strong narrative, clear CTA            14802     agent-3  Good data points, weak intro           15203     agent-2  Generic tone, no differentiation       1350
Winner: agent-1 (strongest narrative arc and call-to-action)

Hybrid Mode

  1. Run metric evaluation first
  2. If top agents are within 10% of each other, use LLM judge to break ties
  3. Present both metric and qualitative rankings

After Eval

  1. Update session state:
bash
python {skill_path}/scripts/session_manager.py --update {session-id} --state evaluating
  1. Tell the user:
    • Ranked results with winner highlighted
    • Next step: /hub:merge to merge the winner
    • Or /hub:merge {session-id} --agent {winner} to be explicit

Source and attribution

Source:alirezarezvani/claude-skillsinengineering/agenthub/skills/evalat commit19392f7

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal