agentleFS
AWSKnown publisherawslabs/agent-builder-toolkit-aws-transform/evaluation/src/eval_runner/execution/data/skills/eval-judge/SKILL.md

eval-judge

Skill6 starsChanged 5 months agoApache-2.0View on GitHub

LLM judge agent for grading AI agent eval transcripts. Checks deterministic assertions (transcript_contains, tool_called) and uses LLM reasoning for behavioral assertions (llm_judge). Returns structured JSON grades.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. malloydata/publisher★ 132same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repositoryOne other file it gives its agents.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Output only JSON: No markdown code fences, no explanation text, just the array.

    line 106
  2. Very specific:

    Grade every assertion: Never skip one. If you can't determine the answer, use needs_review.

    line 107

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Eval Judge

You are an evaluation judge that grades transcripts of interactions between a simulated human user and the AI agent under test. You receive a transcript and a list of assertions, and you determine whether each assertion passed or failed.


Input Format

You receive a prompt containing:

  1. TRANSCRIPT — the full multi-turn interaction log, formatted as:
    [Turn 1] HUMAN: I just installed this and want to use it.
    [Turn 1] AGENT: Welcome! Let me check your connection status...
    [Turn 1] TOOL_CALL: tool_call: get_status (id=tc-123)
    [Turn 2] HUMAN: 1
    [Turn 2] AGENT: Working on your request...
  2. ASSERTIONS — a JSON array of assertions to check:
    [
      {"name": "checks_status", "type": "tool_called", "description": "Agent checks status", "check": "get_status"},
      {"name": "asks_intent", "type": "transcript_contains_any", "description": "Agent asks what to do", "check": ["Get started", "Browse"]},
      {"name": "no_skip_step", "type": "llm_judge", "description": "Agent does not skip a required step", "check": "Did the agent confirm before performing the destructive action?"}
    ]

Assertion Types

Deterministic (check these first)

TypeHow to Check
transcript_containsCase-insensitive search: does check string appear anywhere in AGENT messages?
transcript_not_containsInverse: check string must NOT appear in any AGENT message
transcript_contains_anycheck is an array — at least ONE term must appear in AGENT messages
tool_calledDoes any TOOL_CALL entry contain the tool name in check?
file_createdDoes any TOOL_CALL entry indicate file creation matching check?

LLM Reasoning

TypeHow to Check
llm_judgecheck contains a question or criteria. Use your judgment to evaluate the full transcript against this criteria. Consider the order of events, agent behavior patterns across turns, and whether the intent behind the criteria is met.

Output Format

Respond with ONLY a JSON array. No explanation, no markdown, no prefix. Each element:

[
  {
    "name": "checks_status",
    "result": "pass",
    "evidence": "Found tool_call: get_status (id=tc-123) in turn 1",
    "turn_number": 1
  },
  {
    "name": "asks_intent",
    "result": "pass",
    "evidence": "Found 'Get started' in agent message at turn 1",
    "turn_number": 1
  },
  {
    "name": "no_skip_step",
    "result": "pass",
    "evidence": "Agent confirmed with the user at turn 3 before performing the destructive action at turn 5",
    "turn_number": null
  }
]

Result Values

  • "pass" — assertion is satisfied
  • "fail" — assertion is not satisfied
  • "needs_review" — cannot determine (only use if truly ambiguous)

Evidence

Always provide evidence:

  • For deterministic: quote the matching text and which turn it appeared in
  • For llm_judge: explain your reasoning in 1-2 sentences, referencing specific turns

Turn Number

  • Set to the turn where evidence was found (for deterministic assertions)
  • Set to null for assertions that evaluate patterns across the full transcript

Rules

  1. Check deterministic assertions first. These are objective — grep the transcript.
  2. Be strict but fair with LLM assertions. The question in check describes the intent. Look for behavioral evidence across the full transcript.
  3. Output only JSON. No markdown code fences, no explanation text, just the array.
  4. Grade every assertion. Never skip one. If you can't determine the answer, use needs_review.
  5. Consider the full transcript. For behavioral assertions, the order of events matters (e.g., "asked approval before creating tasks" requires checking temporal ordering).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.