Skill Tracer
Skills › Scientific Agent Skills › scholar-evaluation › evaluation_framework.md

evaluation_framework.md

275 lines · skills/scholar-evaluation/references/evaluation_framework.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Evaluation Framework
2

Evaluation Framework

Raw lines 1 to 2
3## What ScholarEval is—and is not
4
5The paper currently referenced by this skill is Moussa et al.,
6[*ScholarEval: Research Idea Evaluation Grounded in
7Literature*](https://arxiv.org/abs/2510.16234), arXiv:2510.16234v2,
8revised 2026-02-28.
9
10The preprint describes an experimental retrieval-augmented system for evaluating
11research ideas on:
13- **soundness:** whether existing literature empirically supports proposed
14 methods; and
15- **contribution:** how an idea advances beyond prior work along comparison
16 dimensions.
18It reports a 117-idea, four-discipline dataset, coverage comparisons with
19expert-annotated review points, and a user study. Those studies evaluate that
20framework. They do **not** validate the generalized rubric in this skill as a
21psychometric instrument, establish stable score meaning across disciplines, or
22authorize use in consequential decisions.
24As of the dated source review, arXiv and the official project repository were
25the verified primary publication records. No peer-reviewed publication status
26was verified. Cite it as an arXiv preprint unless a later primary record is
27checked. See `references/source_ledger.md`.

What ScholarEval is—and is not

The paper currently referenced by this skill is Moussa et al., ScholarEval: Research Idea Evaluation Grounded in Literature, arXiv:2510.16234v2, revised 2026-02-28.

The preprint describes an experimental retrieval-augmented system for evaluating research ideas on:

  • soundness: whether existing literature empirically supports proposed methods; and
  • contribution: how an idea advances beyond prior work along comparison dimensions.

It reports a 117-idea, four-discipline dataset, coverage comparisons with expert-annotated review points, and a user study. Those studies evaluate that framework. They do not validate the generalized rubric in this skill as a psychometric instrument, establish stable score meaning across disciplines, or authorize use in consequential decisions.

As of the dated source review, arXiv and the official project repository were the verified primary publication records. No peer-reviewed publication status was verified. Cite it as an arXiv preprint unless a later primary record is checked. See references/source_ledger.md.

Raw lines 3 to 28
29## Relationship to this skill
31This skill borrows the useful discipline of:
331. defining what is being assessed;
342. grounding judgments in traceable literature and work evidence;
353. separating soundness-like questions from contribution-like questions; and
364. auditing whether generated feedback covers expert concerns.
38It does not reproduce ScholarEval's model pipeline, prompts, retrieval system,
39dataset, or reported metrics. The bundled scripts do not call ScholarEval,
40search the web, invoke a model, or evaluate private documents.
42The template is a **locally governed developmental rubric**. Its default
43construct is:
45> Traceable support for a scholarly work's claims and methods: the degree to
46> which a work states a bounded question, situates its contribution, uses
47> fit-for-purpose methods, aligns analysis with claims, and documents
48> transparent and responsible practices using traceable evidence.
50This construct must be reviewed and adapted by relevant disciplinary experts.

Relationship to this skill

This skill borrows the useful discipline of:

  1. defining what is being assessed;
  2. grounding judgments in traceable literature and work evidence;
  3. separating soundness-like questions from contribution-like questions; and
  4. auditing whether generated feedback covers expert concerns.

It does not reproduce ScholarEval's model pipeline, prompts, retrieval system, dataset, or reported metrics. The bundled scripts do not call ScholarEval, search the web, invoke a model, or evaluate private documents.

The template is a locally governed developmental rubric. Its default construct is:

Traceable support for a scholarly work's claims and methods: the degree to which a work states a bounded question, situates its contribution, uses fit-for-purpose methods, aligns analysis with claims, and documents transparent and responsible practices using traceable evidence.

This construct must be reviewed and adapted by relevant disciplinary experts.

Raw lines 29 to 51
52## Five template criteria

Five template criteria

Raw lines 52 to 53
54### 1. Question and scope
56Review:
58- a clear, bounded question or objective;
59- significance rationale appropriate to the field and work stage;
60- assumptions, boundary conditions, and success conditions; and
61- feasibility of the proposed or reported scope.
63Do not treat fashionable topics, institutional affiliation, or venue
64expectations as evidence of significance.

1. Question and scope

Review:

  • a clear, bounded question or objective;
  • significance rationale appropriate to the field and work stage;
  • assumptions, boundary conditions, and success conditions; and
  • feasibility of the proposed or reported scope.

Do not treat fashionable topics, institutional affiliation, or venue expectations as evidence of significance.

Raw lines 54 to 65
66### 2. Literature grounding and contribution claim
68Review:
70- source-selection or search boundaries;
71- engagement with relevant and contrary evidence;
72- traceable primary sources for comparison claims;
73- comparison dimensions used to define the contribution; and
74- limits on novelty or advancement claims.
76Failure to find prior work does not establish novelty. Search coverage varies by
77database, language, date, indexing, terminology, discipline, and access.

2. Literature grounding and contribution claim

Review:

  • source-selection or search boundaries;
  • engagement with relevant and contrary evidence;
  • traceable primary sources for comparison claims;
  • comparison dimensions used to define the contribution; and
  • limits on novelty or advancement claims.

Failure to find prior work does not establish novelty. Search coverage varies by database, language, date, indexing, terminology, discipline, and access.

Raw lines 66 to 78
79### 3. Method and design fit
81Review:
83- alignment between question, design, data or materials, and method;
84- sampling, corpus, inclusion, exclusion, and measurement choices;
85- alternatives and design rationale;
86- validity threats, bias, and mitigation;
87- ethics, consent, privacy, safety, and governance; and
88- detail sufficient for appropriate checking or reproduction.
90Use discipline-specific reporting and methods standards. Do not reward
91complexity for its own sake.

3. Method and design fit

Review:

  • alignment between question, design, data or materials, and method;
  • sampling, corpus, inclusion, exclusion, and measurement choices;
  • alternatives and design rationale;
  • validity threats, bias, and mitigation;
  • ethics, consent, privacy, safety, and governance; and
  • detail sufficient for appropriate checking or reproduction.

Use discipline-specific reporting and methods standards. Do not reward complexity for its own sake.

Raw lines 79 to 92
93### 4. Analysis, claims, and uncertainty
95Review:
97- fit of analytical methods to data and inferential target;
98- assumptions and diagnostics;
99- robustness, sensitivity, negative cases, and alternative explanations;
100- appropriate statistical or qualitative uncertainty;
101- alignment between results and claims; and
102- explicit limits on generalization and causal language.
104The rubric's `uncertainty` value is a rater-supplied bounded judgment range. It
105is not a sampling confidence interval, posterior interval, or standard error.

4. Analysis, claims, and uncertainty

Review:

  • fit of analytical methods to data and inferential target;
  • assumptions and diagnostics;
  • robustness, sensitivity, negative cases, and alternative explanations;
  • appropriate statistical or qualitative uncertainty;
  • alignment between results and claims; and
  • explicit limits on generalization and causal language.

The rubric's uncertainty value is a rater-supplied bounded judgment range. It is not a sampling confidence interval, posterior interval, or standard error.

Raw lines 93 to 106
107### 5. Transparency, integrity, and reproducibility
109Review:
111- complete reporting, provenance, and stable evidence locators;
112- protocols, registrations, data, code, materials, and justified restrictions;
113- negative, null, and contradictory findings where relevant;
114- conflicts, limitations, corrections, and research-integrity safeguards;
115- accessible communication; and
116- transparent attribution of contributions.
118Open practice is not an absolute requirement when privacy, consent, safety,
119security, Indigenous data governance, commercial constraints, or other
120legitimate restrictions apply. Assess whether restrictions are justified and
121whether safe access or metadata alternatives are provided.

5. Transparency, integrity, and reproducibility

Review:

  • complete reporting, provenance, and stable evidence locators;
  • protocols, registrations, data, code, materials, and justified restrictions;
  • negative, null, and contradictory findings where relevant;
  • conflicts, limitations, corrections, and research-integrity safeguards;
  • accessible communication; and
  • transparent attribution of contributions.

Open practice is not an absolute requirement when privacy, consent, safety, security, Indigenous data governance, commercial constraints, or other legitimate restrictions apply. Assess whether restrictions are justified and whether safe access or metadata alternatives are provided.

Raw lines 107 to 122
123## Scale semantics
125The template uses an ordinal 0–4 scale:
127- **0 — observed lack of support**
128- **1 — limited support**
129- **2 — mixed support**
130- **3 — substantial support**
131- **4 — strong support**
133These are evidence anchors, not labels of a person or universal levels of
134research quality. The rubric defines criterion-specific anchors. Raters must use
135the anchor text, not intuition about what a number “usually means.”
137Do not convert the score to:
139- accept/reject or publication readiness;
140- exceptional/poor labels;
141- predicted success or impact;
142- person ranking; or
143- funding, hiring, promotion, tenure, admissions, award, or discipline advice.

Scale semantics

The template uses an ordinal 0–4 scale:

  • 0 — observed lack of support
  • 1 — limited support
  • 2 — mixed support
  • 3 — substantial support
  • 4 — strong support

These are evidence anchors, not labels of a person or universal levels of research quality. The rubric defines criterion-specific anchors. Raters must use the anchor text, not intuition about what a number “usually means.”

Do not convert the score to:

  • accept/reject or publication readiness;
  • exceptional/poor labels;
  • predicted success or impact;
  • person ranking; or
  • funding, hiring, promotion, tenure, admissions, award, or discipline advice.
Raw lines 123 to 144
145## Rating statuses
147Each criterion has exactly one status:
149- `rated`: score, uncertainty, evidence identifiers, and rationale reference
150 are required;
151- `missing`: evidence needed for assessment is absent or unavailable; score and
152 uncertainty are null; or
153- `not_applicable`: the criterion does not apply to this work under a documented
154 rationale; score and uncertainty are null.
156A rated zero must cite inspected evidence demonstrating lack of support or a
157contradiction. An inaccessible section or unassessed evidence is `missing`, not
158zero. Do not encode missing or not-applicable as zero.

Rating statuses

Each criterion has exactly one status:

  • rated: score, uncertainty, evidence identifiers, and rationale reference are required;
  • missing: evidence needed for assessment is absent or unavailable; score and uncertainty are null; or
  • not_applicable: the criterion does not apply to this work under a documented rationale; score and uncertainty are null.

A rated zero must cite inspected evidence demonstrating lack of support or a contradiction. An inaccessible section or unassessed evidence is missing, not zero. Do not encode missing or not-applicable as zero.

Raw lines 145 to 159
160## Transparent score math
162Numeric averaging additionally assumes meaningful spacing between anchors and
163compensatory tradeoffs between criteria. Ordinal labels alone do not justify
164these assumptions. Use a composite only when the local rubric owner documents
165them for the stated developmental purpose; otherwise retain criterion findings.
167For rated criteria \(R\), score \(s_i\), and predeclared weight \(w_i\):
169\[
170\text{descriptive score}
172\frac{\sum_{i \in R} w_i s_i}
173 {\sum_{i \in R} w_i}
174\]
176The score report separately provides:
178- total, applicable, rated, missing, and not-applicable weight;
179- coverage of applicable weight;
180- each weighted contribution;
181- the normalized descriptive score; and
182- a bounded aggregation of criterion uncertainty ranges.
184The uncertainty aggregation is not a confidence interval. Normalization does
185not make incomplete evaluations comparable. Review missingness before looking
186at any score.

Transparent score math

Numeric averaging additionally assumes meaningful spacing between anchors and compensatory tradeoffs between criteria. Ordinal labels alone do not justify these assumptions. Use a composite only when the local rubric owner documents them for the stated developmental purpose; otherwise retain criterion findings.

For rated criteria \(R\), score \(s_i\), and predeclared weight \(w_i\):

\[ \text{descriptive score} = \frac{\sum_{i \in R} w_i s_i} {\sum_{i \in R} w_i} \]

The score report separately provides:

  • total, applicable, rated, missing, and not-applicable weight;
  • coverage of applicable weight;
  • each weighted contribution;
  • the normalized descriptive score; and
  • a bounded aggregation of criterion uncertainty ranges.

The uncertainty aggregation is not a confidence interval. Normalization does not make incomplete evaluations comparable. Review missingness before looking at any score.

Raw lines 160 to 187
188## Rubric development record
190Before replacing `content_validity_status: not_established`, document:
1921. the exact discipline, work type, language, stage, and intended use;
1932. construct definition and excluded constructs;
1943. literature and standard review used to draft criteria;
1954. disciplinary expert and stakeholder selection;
1965. systematic mapping of criteria to construct components;
1976. cognitive interviews or rater response-process evidence;
1987. accessibility and translation review;
1998. pilot sample and evidence-availability analysis;
2009. revisions, dissent, unresolved gaps, and approval; and
20110. the limits of any validity claim.
203Rubric provenance must identify the version, owner role, source identifiers,
204review date, and content-evidence reference.

Rubric development record

Before replacing content_validity_status: not_established, document:

  1. the exact discipline, work type, language, stage, and intended use;
  2. construct definition and excluded constructs;
  3. literature and standard review used to draft criteria;
  4. disciplinary expert and stakeholder selection;
  5. systematic mapping of criteria to construct components;
  6. cognitive interviews or rater response-process evidence;
  7. accessibility and translation review;
  8. pilot sample and evidence-availability analysis;
  9. revisions, dissent, unresolved gaps, and approval; and
  10. the limits of any validity claim.

Rubric provenance must identify the version, owner role, source identifiers, review date, and content-evidence reference.

Raw lines 188 to 205
206## Rater protocol
208At minimum:
2101. select qualified raters with relevant disciplinary and methods expertise;
2112. disclose conflicts and recuse where required;
2123. train on construct boundaries, anchors, evidence rules, missingness,
213 accessibility, bias, and privacy;
2144. calibrate on synthetic or authorized examples;
2155. rate independently before discussion;
2166. record evidence identifiers and uncertainty;
2177. summarize agreement and investigate systematic disagreements;
2188. resolve only through documented evidence and rationale, not forced averaging;
2199. monitor drift over time; and
22010. retrain, revise, or suspend the rubric when evidence warrants.
222The bundled agreement script compares raters only within the same criterion,
223work, and evaluation round. It reports exact agreement, within-one-step agreement,
224and mean absolute difference, pooling rater pairs. More heavily rated rounds
225contribute more pairs; pairs sharing a rater/work are dependent observations. Those summaries do not replace a
226design-appropriate reliability analysis. The rubric therefore separately
227records `inter_rater_reliability_status` and
228`inter_rater_reliability_ref`; the template leaves reliability not established.

Rater protocol

At minimum:

  1. select qualified raters with relevant disciplinary and methods expertise;
  2. disclose conflicts and recuse where required;
  3. train on construct boundaries, anchors, evidence rules, missingness, accessibility, bias, and privacy;
  4. calibrate on synthetic or authorized examples;
  5. rate independently before discussion;
  6. record evidence identifiers and uncertainty;
  7. summarize agreement and investigate systematic disagreements;
  8. resolve only through documented evidence and rationale, not forced averaging;
  9. monitor drift over time; and
  10. retrain, revise, or suspend the rubric when evidence warrants.

The bundled agreement script compares raters only within the same criterion, work, and evaluation round. It reports exact agreement, within-one-step agreement, and mean absolute difference, pooling rater pairs. More heavily rated rounds contribute more pairs; pairs sharing a rater/work are dependent observations. Those summaries do not replace a design-appropriate reliability analysis. The rubric therefore separately records inter_rater_reliability_status and inter_rater_reliability_ref; the template leaves reliability not established.

Raw lines 206 to 229
230## Evidence traceability
232Each rated criterion must point to one or more entries in the evidence manifest.
233Each entry records:
235- pseudonymous evidence identifier;
236- linked criterion identifiers;
237- source type;
238- local stable locator;
239- local claim reference;
240- access status; and
241- verification status.
243Never place an excerpt or raw private document in the manifest. Keep source
244content in the authorized source system.

Evidence traceability

Each rated criterion must point to one or more entries in the evidence manifest. Each entry records:

  • pseudonymous evidence identifier;
  • linked criterion identifiers;
  • source type;
  • local stable locator;
  • local claim reference;
  • access status; and
  • verification status.

Never place an excerpt or raw private document in the manifest. Keep source content in the authorized source system.

Raw lines 230 to 245
246## Weight sensitivity and order instability
248Weights are value judgments. Predeclare and justify them. Run
249`scripts/weight_sensitivity.py` before interpreting a composite.
251The script increases and decreases one weight at a time and renormalizes the
252weights. It reports score ranges and whether pairwise ordinal relationships
253among scholarly works change, using unrounded scores and a stated numerical
254tolerance. Tied pairs are explicit. Different applicable or rated criterion sets
255limit comparability even at 100% applicable coverage. Instability is evidence that an apparent order
256depends on contestable weights.
258The output must not be used to rank people or decide a high-impact outcome.
259Even stable ordering does not establish validity.

Weight sensitivity and order instability

Weights are value judgments. Predeclare and justify them. Run scripts/weight_sensitivity.py before interpreting a composite.

The script increases and decreases one weight at a time and renormalizes the weights. It reports score ranges and whether pairwise ordinal relationships among scholarly works change, using unrounded scores and a stated numerical tolerance. Tied pairs are explicit. Different applicable or rated criterion sets limit comparability even at 100% applicable coverage. Instability is evidence that an apparent order depends on contestable weights.

The output must not be used to rank people or decide a high-impact outcome. Even stable ordering does not establish validity.

Raw lines 246 to 260
Runs code scripts/weight_sensitivity.py :249
261## Interpretation template
263For each criterion, qualified reviewers should record:
2651. status and evidence references;
2662. observed evidence;
2673. interpretation against the anchor;
2684. score and uncertainty, if rated;
2695. missing or not-applicable rationale;
2706. disciplinary and stage context;
2717. strengths and limitations; and
2728. non-prescriptive improvement options.
274Conclude with construct, provenance, coverage, agreement, sensitivity, bias,
275privacy, accessibility, and validity limitations—not a decision recommendation.

Interpretation template

For each criterion, qualified reviewers should record:

  1. status and evidence references;
  2. observed evidence;
  3. interpretation against the anchor;
  4. score and uncertainty, if rated;
  5. missing or not-applicable rationale;
  6. disciplinary and stage context;
  7. strengths and limitations; and
  8. non-prescriptive improvement options.

Conclude with construct, provenance, coverage, agreement, sensitivity, bias, privacy, accessibility, and validity limitations—not a decision recommendation.

Raw lines 261 to 275