Skill Tracer
Skills › Scientific Agent Skills › scholar-evaluation

scholar-evaluation

skill · 318 lines · MIT · skills/scholar-evaluation/SKILL.md

The facts

Its description

Provides qualitative-first, evidence-traceable developmental review of scholarly works and audit low-stakes research-assessment rubrics with optional local quality controls. Never use for ranking people or consequential decisions.

The description the agent reads to decide when to use it.

From its settingsline 3

Tools it may use, or may not

allowed-tools: Read Write Bash Glob Python

Tools it may use while it runs without asking you first.

From its settingsline 6

Runs scripts

python3 scripts/validate_rubric.py, python3 scripts/calculate_scores.py, python3 scripts/check_traceability.py, python3 scripts/summarize_agreement.py, python3 scripts/weight_sensitivity.py (first 5 of 7 lines)

Scripts the text names. Found by matching words, so treat them as pointers.

Found by matching wordsline 146 line 187 line 195 line 205 line 214

Files it mentions

references/responsible_assessment.md, references/source_ledger.md, assets/rubric_template.json, references/evaluation_framework.md, assets/evidence_manifest_template.json (first 5 of 16 lines)

Files the text names, such as ones to read or write. Found by matching words, so treat them as pointers.

Found by matching wordsline 47 line 62 line 136 line 150 line 157

Licence

MIT, from the skill file

The terms its author shares it under, which let it be shown here.

From its settingsline 4 licence text

Other settings

compatibility: Requires Python 3.11+ for optional bundled standard-library CLIs. All tooling is local JSON/CSV processing with no network, credentials, external models, or subprocesses. metadata: version: "2.4" last-reviewed: "2026-10-01" skill-author: K-Dense Inc.

More settings at the top of the file, shown as written.

From its settingsline 5 line 7
Other files in this skill (17) Close

The text

Open on GitHub

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

1---
2name: scholar-evaluation
3description: Provides qualitative-first, evidence-traceable developmental review of scholarly works and audit low-stakes research-assessment rubrics with optional local quality controls. Never use for ranking people or consequential decisions.
4license: MIT
5compatibility: Requires Python 3.11+ for optional bundled standard-library CLIs. All tooling is local JSON/CSV processing with no network, credentials, external models, or subprocesses.
6allowed-tools: Read Write Bash Glob Python
7metadata:
8 version: "2.4"
9 last-reviewed: "2026-10-01"
10 skill-author: K-Dense Inc.
11---
13# Scholar Evaluation

Scholar Evaluation

Raw lines 1 to 14
15## Purpose
17Provide developmental, evidence-traceable feedback on a **scholarly work**:
18paper, draft, protocol, literature synthesis, or research idea. Use
19qualitative judgment first. Optional scores only describe how submitted
20evidence maps to a predeclared bounded rubric.
22This skill also audits whether a low-stakes assessment process documents its
23construct, provenance, rater quality, uncertainty, traceability, sensitivity,
24fairness, accessibility, privacy, and human governance.

Purpose

Provide developmental, evidence-traceable feedback on a scholarly work: paper, draft, protocol, literature synthesis, or research idea. Use qualitative judgment first. Optional scores only describe how submitted evidence maps to a predeclared bounded rubric.

This skill also audits whether a low-stakes assessment process documents its construct, provenance, rater quality, uncertainty, traceability, sensitivity, fairness, accessibility, privacy, and human governance.

Raw lines 15 to 25
26## Hard safety boundary
28Never use this skill to automate, recommend, materially influence, or score:
30- hiring, promotion, or tenure;
31- admissions;
32- grants or other funding;
33- prizes, honors, or awards;
34- discipline, dismissal, or sanctions; or
35- any other high-impact personnel decision.
37Never rank people. Never reduce a person to a composite score. Never infer
38ability, character, integrity, protected traits, future performance, or worth.
39A nominal human-in-the-loop does not remove this boundary.
41If asked for a prohibited use, stop. Offer developmental comments on a
42scholarly work or a process-only audit that does not process applications,
43compare people, recommend an outcome, or advise a decision.
45Do not issue publication-readiness, accept/reject, or “top-tier” judgments.
47Read `references/responsible_assessment.md` before any organizational use.

Hard safety boundary

Never use this skill to automate, recommend, materially influence, or score:

  • hiring, promotion, or tenure;
  • admissions;
  • grants or other funding;
  • prizes, honors, or awards;
  • discipline, dismissal, or sanctions; or
  • any other high-impact personnel decision.

Never rank people. Never reduce a person to a composite score. Never infer ability, character, integrity, protected traits, future performance, or worth. A nominal human-in-the-loop does not remove this boundary.

If asked for a prohibited use, stop. Offer developmental comments on a scholarly work or a process-only audit that does not process applications, compare people, recommend an outcome, or advise a decision.

Do not issue publication-readiness, accept/reject, or “top-tier” judgments.

Read references/responsible_assessment.md before any organizational use.

Raw lines 26 to 48
49## ScholarEval status
51The referenced ScholarEval project is an **experimental
52literature-grounded research-idea evaluation framework**, not validated
53psychometrics.
55The verified primary record is Moussa et al., *ScholarEval: Research Idea
56Evaluation Grounded in Literature*, arXiv:2510.16234v2, revised 2026-02-28.
57It reports a retrieval-augmented soundness/contribution framework, a
58117-idea four-discipline dataset, coverage experiments, and a user study.
60Do not generalize those results to person assessment, consequential decisions,
61all disciplines, or this skill's rubric. No peer-reviewed publication status
62was verified during the dated review. See `references/source_ledger.md`.

ScholarEval status

The referenced ScholarEval project is an experimental literature-grounded research-idea evaluation framework, not validated psychometrics.

The verified primary record is Moussa et al., ScholarEval: Research Idea Evaluation Grounded in Literature, arXiv:2510.16234v2, revised 2026-02-28. It reports a retrieval-augmented soundness/contribution framework, a 117-idea four-discipline dataset, coverage experiments, and a user study.

Do not generalize those results to person assessment, consequential decisions, all disciplines, or this skill's rubric. No peer-reviewed publication status was verified during the dated review. See references/source_ledger.md.

Raw lines 49 to 63
64## Metric and prestige policy
66Do not score or infer quality from:
68- Journal Impact Factor or other journal measures;
69- h-index, publication counts, or citation counts;
70- altmetrics or attention;
71- journal, conference, venue, institution, employer, or geographic prestige;
72- author affiliation, reputation, network, or career path.
74The rubric validator rejects common proxy-measure criteria.
76If a qualified reviewer mentions an indicator descriptively outside the
77scoring tools, record its exact purpose, source, coverage, field and time
78effects, uncertainty, missingness, biases, gaming risk, and why it does not
79directly measure quality. Never hide indicators inside an opaque composite.

Metric and prestige policy

Do not score or infer quality from:

  • Journal Impact Factor or other journal measures;
  • h-index, publication counts, or citation counts;
  • altmetrics or attention;
  • journal, conference, venue, institution, employer, or geographic prestige;
  • author affiliation, reputation, network, or career path.

The rubric validator rejects common proxy-measure criteria.

If a qualified reviewer mentions an indicator descriptively outside the scoring tools, record its exact purpose, source, coverage, field and time effects, uncertainty, missingness, biases, gaming risk, and why it does not directly measure quality. Never hide indicators inside an opaque composite.

Raw lines 64 to 80
81## Data boundary
83Bundled scripts accept only strict local JSON/CSV containing pseudonymous IDs,
84bounded ratings, statuses, uncertainty, and local references.
86Do not put raw private applications, CVs, letters, reviewer identities,
87contact details, protected attributes, or source-document text in inputs,
88outputs, logs, examples, or prompts. Keep source content in the authorized
89records system and use opaque local references.
91Allowed classifications are:
93- `synthetic`
94- `public_scholarly_work`
95- `deidentified_low_stakes`
97No script searches the web, loads environment files, reads credentials, calls a
98model, executes supplied text, deserializes executable objects, or launches a
99process.
101Use Bash only to invoke the documented local `python3` commands.

Data boundary

Bundled scripts accept only strict local JSON/CSV containing pseudonymous IDs, bounded ratings, statuses, uncertainty, and local references.

Do not put raw private applications, CVs, letters, reviewer identities, contact details, protected attributes, or source-document text in inputs, outputs, logs, examples, or prompts. Keep source content in the authorized records system and use opaque local references.

Allowed classifications are:

  • synthetic
  • public_scholarly_work
  • deidentified_low_stakes

No script searches the web, loads environment files, reads credentials, calls a model, executes supplied text, deserializes executable objects, or launches a process.

Use Bash only to invoke the documented local python3 commands.

Raw lines 81 to 102
103## Workflow
105### 1. Confirm allowed use and authorization
107Record:
109- developmental purpose;
110- unit of assessment: `scholarly_work`;
111- work type, stage, discipline, language, and audience;
112- authorized source location and data classification;
113- accountable committee owner;
114- conflicts and recusals;
115- accessibility and accommodation process;
116- appeal or correction route; and
117- data purpose, access, retention, and deletion.
119Stop on a prohibited decision context or unnecessary private data.

1. Confirm allowed use and authorization

Record:

  • developmental purpose;
  • unit of assessment: scholarly_work;
  • work type, stage, discipline, language, and audience;
  • authorized source location and data classification;
  • accountable committee owner;
  • conflicts and recusals;
  • accessibility and accommodation process;
  • appeal or correction route; and
  • data purpose, access, retention, and deletion.

Stop on a prohibited decision context or unnecessary private data.

Raw lines 105 to 120
121### 2. Define the construct before criteria
123State:
125- what quality or support is being examined;
126- excluded constructs;
127- intended interpretation;
128- contexts where the interpretation does not travel;
129- evidence requirements; and
130- known limitations.
132Start with values and disciplinary context, not available metrics.

2. Define the construct before criteria

State:

  • what quality or support is being examined;
  • excluded constructs;
  • intended interpretation;
  • contexts where the interpretation does not travel;
  • evidence requirements; and
  • known limitations.

Start with values and disciplinary context, not available metrics.

Raw lines 121 to 133
134### 3. Adapt and validate the rubric
136Begin with `assets/rubric_template.json`, then obtain qualified disciplinary,
137assessment-methods, stakeholder, accessibility, privacy, and fairness review.
139The template deliberately records content validity as `not_established`.
140Do not change that status without documented evidence for the exact intended
141use.
143Validate structure:
145```bash
146PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_rubric.py \
147 --rubric assets/rubric_template.json
148```
150Read `references/evaluation_framework.md` for construct, anchor, validity, and
151rater guidance.

3. Adapt and validate the rubric

Begin with assets/rubric_template.json, then obtain qualified disciplinary, assessment-methods, stakeholder, accessibility, privacy, and fairness review.

The template deliberately records content validity as not_established. Do not change that status without documented evidence for the exact intended use.

Validate structure:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_rubric.py \
  --rubric assets/rubric_template.json

Read references/evaluation_framework.md for construct, anchor, validity, and rater guidance.

Raw lines 134 to 152
Reads a file assets/rubric_template.json :136
Runs code python3 scripts/validate_rubric.py :146
153### 4. Build traceable evidence records
155Reviewers may read an authorized work outside the scripts. Record only stable
156local locators and claim references in
159For every criterion, distinguish:
161- observed evidence from interpretation;
162- supporting from contrary evidence;
163- available from unavailable evidence;
164- `missing` from `not_applicable`; and
165- uncertainty from absence.
167Failure to find prior work does not prove novelty. Freeze the exact work revision and evidence-access date before independent rating so raters assess the same material. For public papers, check publisher correction/retraction notices and [Crossmark](https://www.crossref.org/services/crossmark/) where available; record unresolved status rather than treating absence of a notice as verification. If the work changes materially, issue a new evaluation linked to the prior revision.

4. Build traceable evidence records

Reviewers may read an authorized work outside the scripts. Record only stable local locators and claim references in assets/evidence_manifest_template.json.

For every criterion, distinguish:

  • observed evidence from interpretation;
  • supporting from contrary evidence;
  • available from unavailable evidence;
  • missing from not_applicable; and
  • uncertainty from absence.

Failure to find prior work does not prove novelty. Freeze the exact work revision and evidence-access date before independent rating so raters assess the same material. For public papers, check publisher correction/retraction notices and Crossmark where available; record unresolved status rather than treating absence of a notice as verification. If the work changes materially, issue a new evaluation linked to the prior revision.

Raw lines 153 to 168
169### 5. Rate independently
171Use `assets/evaluation_template.json`. Each criterion must be:
173- `rated` with an anchor score, bounded uncertainty, evidence IDs, and a local
174 rationale reference;
175- `missing` with null score/uncertainty and a rationale reference; or
176- `not_applicable` with null score/uncertainty and a rationale reference.
178A rated zero requires inspected evidence demonstrating lack of support; unavailable
179evidence is `missing`. Do not encode missing or not-applicable as zero. Raters should train, calibrate,
180disclose conflicts, rate independently, and document disagreement.

5. Rate independently

Use assets/evaluation_template.json. Each criterion must be:

  • rated with an anchor score, bounded uncertainty, evidence IDs, and a local rationale reference;
  • missing with null score/uncertainty and a rationale reference; or
  • not_applicable with null score/uncertainty and a rationale reference.

A rated zero requires inspected evidence demonstrating lack of support; unavailable evidence is missing. Do not encode missing or not-applicable as zero. Raters should train, calibrate, disclose conflicts, rate independently, and document disagreement.

Raw lines 169 to 181
182### 6. Run local quality checks
184Bounded scoring, without labels or recommendation:
186```bash
187PYTHONDONTWRITEBYTECODE=1 python3 scripts/calculate_scores.py \
188 --rubric assets/rubric_template.json \
189 --evaluation assets/evaluation_template.json
190```
192Evidence traceability:
194```bash
195PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_traceability.py \
196 --rubric assets/rubric_template.json \
197 --evaluation assets/evaluation_template.json \
198 --evidence assets/evidence_manifest_template.json
199```
201Inter-rater agreement (one `evaluation_id` identifies one frozen work and round;
202raters share that ID within the round):
204```bash
205PYTHONDONTWRITEBYTECODE=1 python3 scripts/summarize_agreement.py \
206 --rubric assets/rubric_template.json \
207 --ratings assets/ratings_template.csv
208```
210Weight sensitivity requires two or more distinct scholarly-work evaluation
211files:
213```bash
214PYTHONDONTWRITEBYTECODE=1 python3 scripts/weight_sensitivity.py \
215 --rubric assets/rubric_template.json \
216 --evaluation /tmp/work-a-evaluation.json \
217 --evaluation /tmp/work-b-evaluation.json
218```
220Process controls:
222```bash
223PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_process.py \
224 --process assets/process_checklist_template.json
225```
227The checklist template is intentionally unconfirmed and fails closed.
228Instructions and exact schemas are in `references/local_tooling.md`.

6. Run local quality checks

Bounded scoring, without labels or recommendation:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/calculate_scores.py \
  --rubric assets/rubric_template.json \
  --evaluation assets/evaluation_template.json

Evidence traceability:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_traceability.py \
  --rubric assets/rubric_template.json \
  --evaluation assets/evaluation_template.json \
  --evidence assets/evidence_manifest_template.json

Inter-rater agreement (one evaluation_id identifies one frozen work and round; raters share that ID within the round):

PYTHONDONTWRITEBYTECODE=1 python3 scripts/summarize_agreement.py \
  --rubric assets/rubric_template.json \
  --ratings assets/ratings_template.csv

Weight sensitivity requires two or more distinct scholarly-work evaluation files:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/weight_sensitivity.py \
  --rubric assets/rubric_template.json \
  --evaluation /tmp/work-a-evaluation.json \
  --evaluation /tmp/work-b-evaluation.json

Process controls:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_process.py \
  --process assets/process_checklist_template.json

The checklist template is intentionally unconfirmed and fails closed. Instructions and exact schemas are in references/local_tooling.md.

Raw lines 182 to 229
Runs code python3 scripts/calculate_scores.py :187
Runs code python3 scripts/check_traceability.py :195
Runs code python3 scripts/summarize_agreement.py :205
Runs code python3 scripts/weight_sensitivity.py :214
Runs code python3 scripts/check_process.py :223
Reads a file references/local_tooling.md :228
230### 7. Synthesize qualitative findings
232Lead with criterion-level evidence, not the composite. For each criterion:
2341. cite evidence references;
2352. state `rated`, `missing`, or `not_applicable`;
2363. explain the anchor interpretation;
2374. report score and uncertainty only if rated;
2385. note disagreements and context;
2396. identify strengths and limitations; and
2407. offer non-prescriptive improvement options.
242Generate an empty-reference scaffold if useful:
244```bash
245PYTHONDONTWRITEBYTECODE=1 python3 scripts/generate_report_scaffold.py \
246 --rubric assets/rubric_template.json \
247 --evaluation assets/evaluation_template.json \
248 --output /tmp/developmental-report-scaffold.json
249```
251The scaffold does not read source documents or draft findings.

7. Synthesize qualitative findings

Lead with criterion-level evidence, not the composite. For each criterion:

  1. cite evidence references;
  2. state rated, missing, or not_applicable;
  3. explain the anchor interpretation;
  4. report score and uncertainty only if rated;
  5. note disagreements and context;
  6. identify strengths and limitations; and
  7. offer non-prescriptive improvement options.

Generate an empty-reference scaffold if useful:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/generate_report_scaffold.py \
  --rubric assets/rubric_template.json \
  --evaluation assets/evaluation_template.json \
  --output /tmp/developmental-report-scaffold.json

The scaffold does not read source documents or draft findings.

Raw lines 230 to 252
Runs code python3 scripts/generate_report_scaffold.py :245
253### 8. Human review and release
255Before releasing an organizational report, a qualified accountable human
256committee must verify:
258- construct and rubric provenance;
259- content-validity evidence and limits;
260- rater training, agreement, inter-rater reliability evidence, and drift;
261- evidence traceability and source access;
262- missingness, not-applicable rationales, and uncertainty;
263- weight sensitivity and order instability;
264- disciplinary and subgroup bias review;
265- conflicts and recusals;
266- accessibility and accommodations;
267- privacy, minimization, retention, and output controls; and
268- correction or appeal information.
270Document dissent. Do not imply consensus, validity, or precision beyond the
271evidence. Periodically evaluate the evaluation and retire harmful criteria.

8. Human review and release

Before releasing an organizational report, a qualified accountable human committee must verify:

  • construct and rubric provenance;
  • content-validity evidence and limits;
  • rater training, agreement, inter-rater reliability evidence, and drift;
  • evidence traceability and source access;
  • missingness, not-applicable rationales, and uncertainty;
  • weight sensitivity and order instability;
  • disciplinary and subgroup bias review;
  • conflicts and recusals;
  • accessibility and accommodations;
  • privacy, minimization, retention, and output controls; and
  • correction or appeal information.

Document dissent. Do not imply consensus, validity, or precision beyond the evidence. Periodically evaluate the evaluation and retire harmful criteria.

Raw lines 253 to 272
273## Interpretation rules
275- A score is an ordinal rubric summary, not a natural measurement. Weighted means
276 additionally assume meaningful numeric spacing and tradeoffs; justify these
277 locally or use criterion-level qualitative findings without a composite.
278- Normalization does not repair incomplete evidence.
279- The bundled uncertainty range is not a confidence interval.
280- Agreement does not establish reliability, validity, fairness, or correctness.
281- Stable results under tested weights do not establish validity.
282- The overall score never overrides criterion evidence or qualified judgment.
283- No output is a decision recommendation.

Interpretation rules

  • A score is an ordinal rubric summary, not a natural measurement. Weighted means additionally assume meaningful numeric spacing and tradeoffs; justify these locally or use criterion-level qualitative findings without a composite.
  • Normalization does not repair incomplete evidence.
  • The bundled uncertainty range is not a confidence interval.
  • Agreement does not establish reliability, validity, fairness, or correctness.
  • Stable results under tested weights do not establish validity.
  • The overall score never overrides criterion evidence or qualified judgment.
  • No output is a decision recommendation.
Raw lines 273 to 284
285## Bundled resources
287- `references/responsible_assessment.md` — safety, metrics, governance,
288 accessibility, privacy, and bias.
289- `references/evaluation_framework.md` — ScholarEval boundary, construct,
290 criteria, anchors, validity, and interpretation.
291- `references/local_tooling.md` — strict schemas, formulas, commands, and
292 output behavior.
293- `references/source_ledger.md` — authoritative sources and publication-status
294 verification refreshed 2026-10-01.
295- `references/security_validation.md` — baseline remediation, validation, and
296 residual security-scan record.
297- `assets/rubric_template.json` — bounded rubric template.
298- `assets/evaluation_template.json` — rating template.
299- `assets/evidence_manifest_template.json` — traceability template.
300- `assets/process_checklist_template.json` — fail-closed process checklist.
301- `assets/ratings_template.csv` — synthetic agreement data.

Bundled resources

Raw lines 285 to 302
Boilerplate, lines 303 to 318. The same text appears in 125 other files here. Close
303## Citing Scientific Agent Skills
305This skill is part of Scientific Agent Skills by K-Dense. If it materially contributed to a
306manuscript, report, presentation, or code release, add the paper to the references or
307software section and tell the user you did so:
309> Kassis, T., Agarwal, V., He, Y., Patel, D., & Brueckner, A. M. (2026). Scientific Agent
310> Skills: A Library of Procedural Knowledge for Research Agents. arXiv:2609.00065.
311> https://doi.org/10.48550/arXiv.2609.00065
313Always cite the current version. The DOI and https://arxiv.org/abs/2609.00065 resolve to the
314latest arXiv version, so never append a version suffix such as `v1`. When network access is
315available, fetch https://arxiv.org/abs/2609.00065 (or
316http://export.arxiv.org/api/query?id_list=2609.00065) before writing the reference and take
317the author list, year, and version from that record. If the record lists a journal reference
318or publisher DOI, cite the published version instead.

From K-Dense-AI/scientific-agent-skills at 5f2bc03, 2026-10-26. Not read by a model yet. Summary and techniques by Claude Opus 5.5 on 2026-11-06.