eval-rubric SKILL.md skillA

eval-rubric from calibre-labs/reforge-ai-evals is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add calibre-labs/reforge-ai-evals/eval-rubric@git:20261003.9a39ab5

Pins git:20261003.9a39ab5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
calibre-labs/reforge-ai-evals
Path
skills/eval-rubric/SKILL.md
Versions recorded
1
Latest version
git:20261003.9a39ab5, committed Oct 3, 2026
Size
8,918 bytes
Repository stars
94
License
MIT

Write or update the eval rubric for an AI agent or AI feature: the pass/fail criteria that define good behavior, in four groups (outcome, trajectory, governance, experience), plus the release thresholds that belong in the PRD. Use this skill whenever someone asks to "write an eval rubric", "define what good looks like", "add evals to my PRD", "what should we evaluate", "turn this PRD into a rubric", "update the rubric from these traces", or shares a PRD, agent spec, system prompt or trace…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Eval rubric skill

An eval rubric is the written definition of good behavior for one AI product. It is a section of
the PRD. Every line is a pass/fail check on a single trace. Numbers that hold across many traces
(cost, latency, failure rate) are release thresholds and live in their own PRD section.

This skill writes v1 before any traces exist, and v2 after traces have been read. It also audits
a rubric someone else wrote.

Read `references/worked-examples.md` before writing a rubric for the first time in a session. It
shows two products taken from v1 to v2.

## Pick the mode

| The user has | Mode |
|---|---|
| A PRD, spec, system prompt or a product description, and no traces yet | v1 |
| A v1 rubric plus trace codes or annotated traces | v2 |
| A rubric and wants feedback on it | Audit |

If it is unclear, ask one question: "Have you read traces from this agent yet?"

## The four kinds of lines

| Group | Question it answers | Comes from | Typical owner |
|---|---|---|---|
| Outcome (O) | What did it produce, and is it right? | Definition of success | PM, subject expert, engineering |
| Trajectory (T) | How did it get there? | Autonomy table, known risks | Engineering |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add calibre-labs/reforge-ai-evals/eval-rubric@sha256:ef0dfa31b827bb79

The line at the top of this page pins the label git:20261003.9a39ab5, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2sey75wrldd6s2vw.svg)](https://markdownregistry.com/a/art_2sey75wrldd6s2vw)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 3, 2026.

versioncommittedcommitsizeaudit
git:20261003.9a39ab5 latest2026-10-03 9a39ab5 8,918 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8918 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

calibre-labs/reforge-ai-evals · 94 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2sey75wrldd6s2vw
GET https://markdownregistry.com/api/v1/resolve?ref=calibre-labs/reforge-ai-evals/eval-rubric
GET https://markdownregistry.com/api/v1/blob/ef0dfa31b827bb792644b25a3385988baa45c4d8cf4a1c0ef81d220cbdbb51c8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from calibre-labs/reforge-ai-evals

llms.txt llms.txt file
calibre-labs/reforge-ai-evals · llms.txt
git:20261028.6d7e49a · audit A · 94 stars
eval-code SKILL.md skill
calibre-labs/reforge-ai-evals · skills/eval-code/SKILL.md · Write deterministic, code-based evaluator functions for an AI product. Use this skill whenever you need to write…
git:20261102.9ec9f47 · audit A · 94 stars
eval-guide SKILL.md skill
calibre-labs/reforge-ai-evals · skills/eval-guide/SKILL.md · Entry point for eval work. Use when someone asks for help with evals in general, does not know where to start, asks…
git:20261019.1d63dc1 · audit A · 94 stars
eval-llm-judge SKILL.md skill
calibre-labs/reforge-ai-evals · skills/eval-llm-judge/SKILL.md · Write LLM-as-judge evaluator prompts for AI products. Use this skill whenever you need to evaluate semantic properties…
git:20261102.9ec9f47 · audit A · 94 stars
llm-align SKILL.md skill
calibre-labs/reforge-ai-evals · skills/llm-align/SKILL.md · Analyze alignment between LLM judge scores and human labels in an eval dataset. Use this skill whenever someone wants…
git:20261016.c78dbc2 · audit A · 94 stars
ticket-to-eval SKILL.md skill
calibre-labs/reforge-ai-evals · skills/ticket-to-eval/SKILL.md · Strip PII from a customer support ticket or eval trace and convert it into eval dataset rows. Produces two outputs: a…
git:20261003.9a39ab5 · audit A · 94 stars
trace-codes SKILL.md skill
calibre-labs/reforge-ai-evals · skills/trace-codes/SKILL.md · Turn free-form notes from reading agent traces into trace codes: named, yes/no failure or quality patterns with…
git:20261019.b5e5462 · audit A · 94 stars
trace-review-app SKILL.md skill
calibre-labs/reforge-ai-evals · skills/trace-review-app/SKILL.md · Design and build a custom trace review app for one AI product: a single-page tool where the team reads traces, writes…
git:20261028.d1290e3 · audit A · 94 stars
uig SKILL.md skill
calibre-labs/reforge-ai-evals · skills/uig/SKILL.md · Build a User Input Grid (UIG) for an AI product or feature, evaluate existing eval datasets against it, and propose new…
git:20261003.9a39ab5 · audit A · 94 stars

Every file in calibre-labs/reforge-ai-evals

Browse by kind, by grade A, or by owner.