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.
In this repository9 other files it gives its agents.
- eval-auditSkill
- eval-buildSkill
- eval-datasetSkill
- eval-descentSkill
- eval-discoverSkill
- eval-error-analysisSkill
- eval-maintainSkill
- eval-runSkill
- eval-traceSkill
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
- Distinctive: line 12
Read the operating agreement and calibration.
- Distinctive: line 21
Use code when it can directly test the outcome.
≈ “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.
Files
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.
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
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.

