Skip to content
Back to skills

Foundations Measurement Theory

ASecurity

Audits whether scores, benchmarks, LLM judges, or surveys measure what we think. Use when a benchmark is saturated, a score unreliable, or judge agreement untrustworthy.

  • 89 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added September 24, 2026
ai-agentsrustgoawsgit

Security analysis

A100/100

Pro scans all 7 files and shows the line behind each finding

Scanned October 6, 2026

npx -y skills add vasilyu1983/AI-Agents-public --skill foundations-measurement-theory --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Foundations Measurement Theory?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Foundations Measurement Theory
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/vasilyu1983-foundations-measurement-theory/badge)](https://www.skillsdirectory.com/skills/vasilyu1983-foundations-measurement-theory)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: foundations-measurement-theory
description: Audits whether scores, benchmarks, LLM judges, or surveys measure what we think. Use when a benchmark is saturated, a score unreliable, or judge agreement untrustworthy.
version: "1.1"
last_validated: 2026-09-27
---

# Measurement Theory Foundations

Establish whether an observation supports its intended interpretation and decision. A repeatable score can consistently measure the wrong thing.

## When to use

**Use when** a task asks whether a metric, questionnaire, benchmark, sensor, rating, or composite score measures its intended target, or whether scores can be compared across groups, instruments, or time.

**Do not use when** the task is only sampling uncertainty, causal identification, choosing an action, or implementing an evaluation pipeline. Those belong respectively to [statistical inference](../foundations-statistical-inference/SKILL.md), [causal inference](../foundations-causal-inference/SKILL.md), [decision theory](../foundations-decision-theory/SKILL.md), and [ai-evals](../ai-evals/SKILL.md).

## Workflow

1. Define the intended interpretation, population, decision, and cost of measurement error. Identify what is observed and what remains latent.
2. Choose the physical-measurement or psychometric branch in [measurement primitives](references/measurement-primitives.md). Do not translate psychometric reliability into metrological traceability, or treat benchmark scores as physical quantities without justification.
3. Audit the instrument with the eight primitives below. Use evidence actually available; mark missing evidence rather than supplying thresholds or validity claims.
4. For score comparisons, read [comparability and drift](references/comparability-and-drift.md). Preserve instrument versions, scoring changes, administration conditions, and population differences.
   For LLM benchmarks or LLM-judge scores, also read [AI evaluation measurement](references/ai-evaluation-measurement.md).
5. Complete the [measurement audit template](assets/templates/measurement-audit.md), using the [synthetic example](references/completed-example.md) only as a format example.

## Quick Reference

Eight primitives:

| Primitive | Required decision |
|---|---|
| Construct/measurand | Specify the target, domain, population, and intended use. |
| Operationalization | Identify observation, instrument, scoring, and construct underrepresentation or irrelevant variation. |
| Validity | Evaluate evidence for this interpretation and use; never infer validity from reliability alone. |
| Reliability/precision | Specify what is replicated: items, raters, occasions, tasks, or instruments; estimate the relevant uncertainty. For LLM judges, name the facets (judge, prompt template, order, seed). |
| Scale/transformations | Identify meaningful comparisons and operations; an arbitrary zero does not support ratio claims. |
| Error/uncertainty | Separate systematic bias, random error, missingness, and uncertainty in the measurement model. |
| Calibration/traceability | Identify reference and scope; calibration of a probability forecast is different from metrological calibration. |
| Invariance/drift | Determine whether the same interpretation survives group, time, setting, and instrument changes. A score that has become a target (a gate, a leaderboard, a training objective) is under selection pressure: treat it as a changed instrument (Goodhart's and Campbell's laws) and re-audit validity before reading later values as the original construct. |

## Completion criteria

Return a **supported**, **conditional**, or **insufficient** verdict for each intended interpretation, with evidence and restrictions. A verdict is an audit conclusion, not certification. Name the missing evidence and the smallest study or calibration needed to resolve it.

Do not use universal Cronbach alpha cutoffs. Internal consistency alone establishes neither unidimensionality, test-retest stability, agreement, nor validity. Keep item-level ordinal responses separate from assumptions used to analyze a composite.

## Navigation

- [Measurement primitives](references/measurement-primitives.md) — definitions, assumptions, and counterexamples.
- [Comparability and drift](references/comparability-and-drift.md) — cross-group and longitudinal checks.
- [AI evaluation measurement](references/ai-evaluation-measurement.md): read for LLM benchmarks and judges. Covers facets and G-theory D-studies, linking after judge or benchmark changes, IRT/DIF, saturation, and a construct-validity checklist.
- [Completed example](references/completed-example.md) — synthetic benchmark audit.
- [Output template](assets/templates/measurement-audit.md) — deliverable structure.
- [Dated primary sources](data/sources.json) — source scope and verification cutoff.

Files in this skill

  • SKILL.md4.3 KB
  • agents/openai.yaml372 B
  • assets/templates/measurement-audit.md688 B
  • data/sources.json2.2 KB
  • references/comparability-and-drift.md1.9 KB
  • references/completed-example.md1.8 KB
  • references/measurement-primitives.md3.1 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.