Measurement Theory Foundations

SkillAI & models

Lets your agent audit whether a score, metric, or questionnaire actually measures what it claims to measure.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Measurement Theory Foundations skill

About this skill

Audit what scores and instruments measure. Use when auditing construct validity, measurement error, reliability, scales, calibration, invariance, or instrument drift.

What this skill tells your AI

The instructions your AI receives, as published by vasilyu1983/ai-agents-public in frameworks/shared-skills/skills/foundations-measurement-theory/SKILL.md and read by ahel’s review.

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, causal inference, decision theory, and ai-evals.

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. 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. Preserve instrument versions, scoring changes, administration conditions, and population differences.
  5. Complete the measurement audit template, using the synthetic example only as a format example.

Quick Reference

Eight primitives:

PrimitiveRequired decision
Construct/measurandSpecify the target, domain, population, and intended use.
OperationalizationIdentify observation, instrument, scoring, and construct underrepresentation or irrelevant variation.
ValidityEvaluate evidence for this interpretation and use; never infer validity from reliability alone.
Reliability/precisionSpecify what is replicated: items, raters, occasions, tasks, or instruments; estimate the relevant uncertainty.
Scale/transformationsIdentify meaningful comparisons and operations; an arbitrary zero does not support ratio claims.
Error/uncertaintySeparate systematic bias, random error, missingness, and uncertainty in the measurement model.
Calibration/traceabilityIdentify reference and scope; calibration of a probability forecast is different from metrological calibration.
Invariance/driftDetermine whether the same interpretation survives group, time, setting, and instrument changes.

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.

Fact-Checking

Check source scope against the intended interpretation. Distinguish established definitions, empirical validation evidence, and synthetic illustrations. Sources were inspected through 2026-09-17; verify later standards or instrument changes before describing them as current.

Navigation

Signals

GitHub stars
88
Forks
19
Last commit
Sep 2026
Advanced
Catalog kind
skill
Key
foundations-measurement-theory
Source
github.com/vasilyu1983/ai-agents-public