coval-eval-audit
Skill3 starsChanged 17 days agoMITView on GitHub
Audit an existing Coval evaluation setup for coverage, misleading scores, missing evidence, judge validation and execution risk. Read-only; use when inheriting an eval or deciding whether its results support a release decision.
In this repository33 other files it gives its agents.
- setup-agentSkill
- build-dashboardSkill
- coval-calibrate-metricSkill
- coval-compare-runsSkill
- coval-discover-failuresSkill
- coval-evals-as-codeSkill
- coval-eval-startSkill
- review-llm-annotations-and-improve-promptSkill
- configure-metricsSkill
- migrate-bluejaySkill
- onboardSkill
- coval-resourcesSkill
- design-personaSkill
- personas-from-artifactsSkill
- analyze-accent-reportSkill
- analyze-adversarial-reportSkill
- analyze-audio-quality-reportSkill
- launch-runSkill
- quick-evalSkill
- run-accent-testingSkill
- run-adversarial-testingSkill
- run-audio-quality-testingSkill
- watch-runSkill
- download-audioSkill
- get-resultsSkill
- consult-sofiaSkill
- build-test-suiteSkill
- distill-test-setSkill
- huggingface-importSkill
- configure-trace-metricsSkill
- debug-tracesSkill
- optimize-trace-observabilitySkill
- setup-tracingSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 6 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
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
- Distinctive: line 14
Use explicit resource IDs where available.
- Very specific: line 33
Check ok, errors and pagination.
- Distinctive: line 51
Read actual transcript excerpts and metric explanations for consequential findings.
- Distinctive: line 57
Do not force everything into binary judging.
- Distinctive: line 67
Keep hypotheses separate from confirmed findings.
- Distinctive: line 75
Use app URLs verified from the user's org/workspace context or returned by Coval.
- Distinctive: line 76
Do not expose credentials, signed recording URLs, private metadata or full customer transcripts in a shareable report.
≈ “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
Audit a Coval evaluation
Inspect what the customer actually ran and what decision those results support. Stay read-only unless they separately request a concrete repair or test.
Collect the smallest useful evidence
Confirm organization, workspace, API environment, agent, time window and decision. Use explicit resource IDs where available. Start with a recent relevant run, its agent, persona, cases and metrics; sample completed, failed and unscored conversations. Don't download the whole account or launch a run to fill a gap.
Discover installed commands with coval --agent agent manifest and resource
context. Common reads:
coval --agent runs get <run-id>
coval --agent agents get <agent-id>
coval --agent personas get <persona-id>
coval --agent test-sets get <test-set-id>
coval --agent test-cases list --test-set-id <test-set-id> --page-size 100
coval --agent simulated-conversations list --run-id <run-id> --page-size 100
coval --agent simulated-conversations get <simulation-id>
coval --agent simulated-conversations metrics <simulation-id>
coval --agent metrics get <metric-id>Check ok, errors and pagination. Some CLI versions return only the first page
without its token. For complete coverage, use the published /v1/openapi schemas
and public API pagination (page_token from next_page_token), retaining the
original filter and workspace header. Never infer missing resources from a
failed read, a truncated page or an unsearched workspace. If evidence is bounded,
state the inspected sample and leave completeness unknown.
Inspect six decision risks
| Area | Inspect | Consequence / next step |
| Evaluation objective | Requirement, pass rule and origin of each key criterion | Generic sentiment/tone alone cannot establish task success. Use configure-metrics for a concrete criterion. |
| Scenario coverage | Actual inputs/expectations, known incidents, source distribution, duplicate cases, language and persona choices | A generated happy-path suite may miss observed failures. Use coval-discover-failures or build-test-suite. |
| Execution validity | Requested vs observed conversations; individual statuses; both transcript speakers; recording availability; test scenario actually exercised | A completed run can contain unusable calls. Separate connection, simulator, provider and agent failures; do not count unknowns as passes. |
| Measurement validity | Metric output status, value, units, polarity, criteria subvalues, evidence source, metric version | Null/skipped/failed is not zero or pass. A composite average can hide one mandatory failed criterion. Transcript claims don't prove a tool side effect. |
| Human calibration | Human label provenance, disagreements, both classes, prompt examples, dev/test separation and version matching | Agreement on tuned examples is development evidence. Use coval-calibrate-metric; missing labels means unvalidated, not a bad judge by assertion. |
| Comparison and cost | Exact case IDs/versions, persona/config/model changes, repeats, missing pairs, runtime/spend and rerun authorization | Confounded deltas and small samples cannot establish improvement. Use coval-compare-runs; propose a bounded test, never an automatic hill-climb. |
Read actual transcript excerpts and metric explanations for consequential findings. For audio claims, listen to the relevant recording segments. For tool or retrieval claims, inspect correlated traces and returned evidence; missing instrumentation is an observability gap, not proof a tool never ran.
Numerical latency, counts and calibrated categorical metrics are legitimate. Do not force everything into binary judging. Prefer deterministic checks for exact constraints; require an explicit decision threshold when the result is used as a release gate. Safety-critical requirements can justify tests before any naturally occurring failure is observed.
Report
For each material finding, provide severity relative to the customer's decision, observed evidence and resource IDs, impact, smallest fix, and how to verify it. Mark each inspected area supported, problem observed, or unknown. Keep hypotheses separate from confirmed findings. Do not invent a numeric readiness score.
Finish with:
- What was inspected (counts, scope, window, versions and missing evidence).
- Whether the evidence supports the stated decision, and why.
- At most three next actions, ordered by expected learning per cost.
Use app URLs verified from the user's org/workspace context or returned by Coval. Do not expose credentials, signed recording URLs, private metadata or full customer transcripts in a shareable report. No resource mutations, notifications, scheduled monitoring or paid evaluations are part of this audit.
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.

