agentsclimarketplace

Alterlab ssci measurement gate

Skill AlterLab-IEU/AlterLab-Academic-Skills/skills/social-science-workflow/alterlab-ssci-measurement-gate

Gates measurement quality before a scale or instrument is trusted — checks that each construct is defined and operationalized, that reliability is evidenced with McDonald omega (not Cronbach alpha alone, which assumes tau-equivalence and is only a lower bound), that reliability is not confused with validity (content, criterion, convergent/discriminant construct validity), and that measurement invariance is tested before comparing groups. Use when asking whether a scale or survey instrument is valid, reporting a Cronbach alpha, building or adopting a multi-item measure, or comparing a latent construct across groups. For designing the questionnaire items prefer alterlab-survey-design; for running the confirmatory factor analysis prefer alterlab-sem-psychometrics; to execute basic statistics prefer alterlab-statistical-analysis. Part of the AlterLab Academic Skills suite.From its SKILL.md

Install
npx -y skills add AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-ssci-measurement-gate

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

6.6 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

Measurement Gate — Reliability Is Not Validity

Skill type: DISCIPLINE-ENFORCING. Before any hypothesis test consumes a scale, this gate checks that the scale measures what it claims, reliably, and comparably across groups. It does not fit factor models itself — it requires the right evidence and routes execution to the psychometrics skill.

The Core Rule

A RELIABLE MEASURE OF THE WRONG CONSTRUCT IS STILL WRONG. RELIABILITY ≠ VALIDITY.

High internal consistency only means the items move together; it says nothing about whether they capture the intended construct. Evidence for validity (content, criterion, construct) is separate and mandatory. And the usual reliability number — Cronbach alpha — rests on an assumption (tau-equivalence: equal item loadings) that real scales rarely meet, so alpha is a lower bound that can under- or (with correlated errors) over-state reliability.

When to Use This Skill

  • "Is my scale / survey instrument valid?"
  • "My Cronbach alpha is 0.78 — is the scale good to use?" (← alpha alone is not enough)
  • "I built a new 6-item measure of burnout; how do I show it works?"
  • "I want to compare a latent trait (e.g. trust) across countries/groups."

Does NOT Trigger

The request is really about…Route toWhy not this skill
Writing / wording the questionnaire items, response scalesalterlab-survey-designInstrument construction, upstream of validation.
Running the CFA / SEM / IRT / invariance modelalterlab-sem-psychometricsThis gate requires CFA; that skill fits it.
Basic descriptive/inferential stats executionalterlab-statistical-analysisComputation, not measurement discipline.
Which statistical test to run on a measured outcomealterlab-test-selection-guardTest choice, not measurement quality.
Sampling frame / how many respondentsalterlab-ssci-sampling-gateSampling, not measurement.

Reliability: report alpha AND omega

Cronbach's alpha assumes tau-equivalence (all items load equally on one factor) and is a lower bound on reliability under that model. McDonald's omega relaxes tau-equivalence by weighting items by their factor loadings and should be reported alongside alpha (McNeish, 2018, Psychological Methods, "Thanks coefficient alpha, we'll take it from here"). In practice the alpha-vs-omega gap for well-constructed unidimensional scales is often small (Warne, 2025 — around 4.5% underestimate), so the discipline is: report both, plus item-total correlations and a dimensionality check — not to fetishize a single number, but to show the estimate is not resting on an unexamined assumption.

Rules this gate enforces:

  1. Alpha alone is insufficient. Ask for omega; if only alpha is available, state the tau-equivalence caveat explicitly.
  2. Reliability presupposes dimensionality. A high alpha on a multidimensional set is meaningless — check the factor structure (CFA, alterlab-sem-psychometrics) first.
  3. Item diagnostics. Item-total correlations and (for two halves) Spearman-Brown; drop or revise items that do not cohere — but pre-specify such decisions, do not fish.

Validity: four kinds, none optional

ValidityQuestionEvidence
ContentDo items cover the construct's domain?expert review, blueprint against the definition
CriterionDoes it predict/correlate with a gold standard?concurrent & predictive correlations
ConvergentDoes it correlate with related measures?AVE, correlations with kindred scales
DiscriminantIs it distinct from other constructs?heterotrait-monotrait ratio, cross-loadings

Construct validity is established with a confirmatory factor analysis — route the fit to alterlab-sem-psychometrics (CFI/TLI, RMSEA, SRMR against Hu & Bentler cutoffs).

Measurement invariance before group comparison

Comparing a latent construct across groups (countries, waves, conditions) is only valid if the measure means the same thing in each group. Require a multi-group CFA invariance sequence — configural → metric → scalar — before interpreting group differences in means. Without at least metric/scalar invariance, a "difference" may be a measurement artifact, not a real effect. Route the test to alterlab-sem-psychometrics.

The Design Passport (hand-off)

Append to each construct in the Passport: reliability (alpha + omega + caveat), validity_evidence (which of the four kinds are shown), dimensionality (CFA fit), and invariance (level established) before any group comparison downstream.

Self-Check Before Advancing

  • Is each construct explicitly defined and operationalized to its items?
  • Is reliability shown with omega (or alpha with the tau-equivalence caveat stated)?
  • Is at least one form of validity evidence present — not just reliability?
  • Was dimensionality confirmed (CFA) before trusting a single reliability coefficient?
  • Is measurement invariance established before comparing the construct across groups?

References

  • references/reliability_and_validity.md — alpha vs omega math, the four validities, the invariance sequence, and reporting templates. Loaded on demand.

Part of the AlterLab Academic Skills suite.

What ships with it: 2 files

10.8 KB alongside SKILL.md

evals/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.