agentleFS
confident-aiconfident-ai/eval-skills/skills/eval-grade/SKILL.md

eval-grade

Skill11 starsChanged 44 days agoApache-2.0View on GitHub

Implement and calibrate failure-specific AI evaluators against expert labels. Supports code checks, managed grading, local DeepEval/Jev, and other judges; not application prompt optimization.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the operating agreement and calibration.

    line 12
  2. Distinctive:

    Use code when it can directly test the outcome.

    line 21

≈ “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

Build and validate graders

Read the operating agreement and calibration. Use managed grading for Confident AI, DeepEval integration only for that local track, or other graders.

For bundled local tools and exact commands, read toolkit setup. Run the workspace installer for this skill; it preserves existing customized files. For the managed route, use concrete service operations after confirming the connected schema.

Establish the claim

Start from an observed failure or explicit product requirement. Reuse reviewed taxonomy IDs, definitions, and boundary examples. If notes need consolidation, use eval-error-analysis when installed; taxonomy approval does not replace independent calibration labels. Name the check, its unit (output, turn, conversation, trace, or end state), necessary evidence, and clear pass/fail meaning. A vague “quality” score is not enough.

Use code when it can directly test the outcome. Do not substitute keyword matching for a semantic requirement without measuring that proxy against human judgment. For agents, inspect fixture state, tests, files, or expected API effects; use transcript checks for process constraints.

For subjective checks prefer one failure mode per judge and concrete Pass/Fail definitions. Use continuous measures for genuine tradeoffs and blind pairwise comparison for comparative preferences; document thresholds and tie treatment before scoring. Keep cost/latency separate from quality.

Implement within the chosen track

Managed: configure supported hosted criteria, retain definitions, and verify example verdicts. No DeepEval setup is required.

Local with DeepEval: recommend it as the grading component without requiring its runner, tracing, or datasets. Ask once for Jev system_one (recommended), hybrid, or LLM judging. Preserve a previously chosen mode. Check metric support and use explicit configuration.

Local alternatives: reuse the project's evaluator or write a small callable in its language. Return a structured result and reason. Treat judge inputs as untrusted data; require structured outputs where supported and reject malformed verdicts.

Validate before trusting

Prepare expert-labeled passes and failures. Separate prompt examples from development calibration and final held-out validation. Exercise clear passes, failures, empty outputs, wrong-question answers, and injection-like text. Compare judge verdicts to humans, inspect disagreements, refine definitions, and rerun development examples.

Record false passes and false failures separately, class counts, uncertainty, judge configuration, and criteria version. An agent's generated labels cannot validate its own judge. Jev confidence indicates decisiveness, not accuracy.

Show actual outputs, labels, verdicts, and reasons for human review. If disagreement remains unresolved, mark the grader provisional and constrain its use. Revalidate after a change of judge, mode, rubric, or domain distribution.

Deliver

Provide versioned criteria, runnable/configured graders, validation evidence, and known limitations. Reference the relevant failure categories. Do not begin application optimization until the measurement is fit for the intended decision.

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.