CtrlK
BlogDocsLog inGet started
Tessl Logo

hannaklim/ai-eval-report

Generates AI quality evaluation reports for LLM and ML-powered products — designs golden datasets, defines accuracy metrics, tracks quality across iterations, and produces stakeholder-ready summaries that explain probabilistic behaviour in business language. Use when evaluating AI or LLM output quality, building an eval framework or golden dataset, benchmarking accuracy between releases or prompt versions, reporting AI quality to clients or executives, or when the user asks "how good is our AI", "accuracy report", "eval results", "benchmark the model", or "why does the AI give different answers to the same question".

80

Quality

100%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

stakeholder-explainer.mdreferences/

Explaining Probabilistic AI Behaviour to Stakeholders

Stakeholders who expect deterministic software interpret probabilistic behaviour as broken software. This file provides framing and copy-ready language for the conversations that decide whether an AI product keeps its client.

The core reframe

Never compare the AI system to perfect software — compare it to the process it replaces.

  • Wrong frame: "The system is 91% accurate" (heard as: "it's broken 9% of the time").
  • Right frame: "The current manual process takes experts N hours and also produces errors. The system does the same work in minutes at 91% accuracy, and every answer shows its sources so an expert can verify the critical ones."

The honest product promise for most AI systems is capability + verification path, not perfection: the system does the heavy work, the human makes the final call where stakes are high.

The "why not 100%?" conversation

Have it at kickoff, not after the first disappointing benchmark. Delaying this conversation is the single most common trust failure in AI delivery. Key points to land:

  1. The system generates answers from learned patterns, not database lookups — variability is inherent to how it works, not a defect to be patched out.
  2. Accuracy improves iteration by iteration and is measured on every release against a fixed test set — show the trend line.
  3. 100% is not the bar the current process meets either — human experts make errors too; nobody has measured them because nobody was counting.
  4. For decisions where an error is unacceptable, the design answer is human-in-the-loop review, and the report shows exactly which cases need it.

Copy-ready explanation paragraph

Adapt to context:

"The system doesn't retrieve stored answers — it generates each answer by reading the source documents, the way an analyst would, only faster. Like an analyst, it can occasionally misread or miss something, which is why we measure its accuracy on every release against a fixed set of expert-validated test cases, and why answers link back to their source documents. Current performance: [X]% on [N] test cases, up from [Y]% at baseline. For [critical decision type], an expert reviews the answer before it's used."

Language rules for client-facing sections

  • Replace "hallucination" with "unsupported answer" or "answer not grounded in the sources" — then show the faithfulness metric that tracks it.
  • Replace "the model is non-deterministic" with "we've configured the system to give consistent answers — the same question always returns the same answer" (when deterministic settings are used).
  • Never promise a future accuracy number; promise the measurement process and the trend.
  • Put the confidence and limitations statement in the report rather than delivering it verbally — a written record of managed expectations protects both sides.

SKILL.md

tile.json