scholar-evaluation
affaan-m/ecc
Structured evaluation of academic papers, proposals, and research using a repeatable 9-dimension rubric.
What is scholar-evaluation?
Scholar Evaluation provides a systematic framework for assessing scholarly work across problem clarity, literature coverage, methodology, data quality, analysis rigor, results interpretation, limitations, writing, and citations. Use it to review papers, proposals, theses, and literature reviews with consistent, actionable feedback.
- Score research artifacts across 9 dimensions (problem, literature, methodology, data, analysis, results, limitations, writing, citations) on a 1–5 scale
- Identify critical blockers versus revision suggestions with evidence-based justification
- Compare multiple papers against the same rubric for relative quality assessment
- Verify that claims are supported by cited sources and primary evidence
- Generate structured feedback in markdown table format ready for author revision
How to install scholar-evaluation
npx skills add null --skill scholar-evaluationHow to use scholar-evaluation
- 1.Identify the artifact type (empirical paper, proposal, literature review, thesis chapter, etc.)
- 2.Choose evaluation scope: comprehensive (all dimensions), targeted (1–2 dimensions), or comparative (rank multiple works)
- 3.Read the abstract, introduction, figures, and conclusion to understand the claimed contribution
- 4.Read methods and results sections to assess evidence quality
- 5.Check the strongest claims against their cited sources
- 6.Score each applicable dimension 1–5 (or N/A if not applicable)
- 7.Separate critical blockers from revision suggestions
- 8.Provide concrete next edits in the output template
Use cases
- Peer review of journal submissions or conference abstracts before formal review
- Thesis advisor feedback on dissertation chapters or proposals
- Self-assessment of your own paper before submission to identify weak spots
- Comparative evaluation of competing methodologies or datasets for a research project
- Quality gate for literature reviews to ensure synthesis rather than mere listing
- Academic researchers and graduate students
- Journal editors and peer reviewers
- Thesis advisors and committee members
- Research proposal evaluators
- Anyone conducting systematic literature reviews
scholar-evaluation FAQ
No. Only score dimensions relevant to the artifact's scope. A short conference abstract may not need a full limitations section; a theoretical paper may not have a data section.
Check whether cited papers actually support the attached claims, prefer primary sources over reviews, verify that preprints and reviews are labeled as such, and confirm metadata accuracy.
Negative results are valid if the methodology is sound and limitations are acknowledged. Penalize only if the paper misrepresents null findings as positive or fails to discuss implications.
No. Score only the work itself. Citation count, venue prestige, and author reputation are not substitutes for evaluating the actual evidence and argument quality.
High confidence when you have deep domain expertise and access to all cited sources; medium when you can verify key claims but lack full context; low when the topic is unfamiliar or sources are inaccessible.
Full instructions (SKILL.md)
Source of truth, from affaan-m/ecc.
name: scholar-evaluation description: Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback. metadata: origin: community
Scholar Evaluation
Use this skill to evaluate academic or scientific work with a repeatable rubric.
When to Use
- Reviewing a research paper, proposal, thesis chapter, or literature review.
- Checking whether claims are supported by cited evidence.
- Evaluating methodology, study design, analysis, or limitations.
- Comparing two or more papers for quality or relevance.
- Producing structured feedback for revision.
Evaluation Scope
Start by identifying the artifact:
- empirical research paper
- theoretical paper
- technical report
- systematic or narrative literature review
- research proposal
- thesis or dissertation chapter
- conference abstract or short paper
Then choose scope:
- comprehensive: all rubric dimensions
- targeted: one or two dimensions, such as method or citations
- comparative: rank multiple works against the same rubric
Rubric
Score each applicable dimension from 1 to 5:
- 5: excellent; clear, rigorous, and publication-ready
- 4: good; minor improvements needed
- 3: adequate; meaningful gaps but usable
- 2: weak; substantial revision needed
- 1: poor; major validity or clarity problems
Use N/A for dimensions that do not apply.
1. Problem and Research Question
- Is the problem clear and specific?
- Is the contribution meaningful?
- Are scope and assumptions explicit?
- Does the question match the claimed contribution?
2. Literature and Context
- Is relevant prior work covered?
- Does the work synthesize rather than merely list sources?
- Are gaps accurately identified?
- Are recent and foundational sources balanced?
3. Methodology
- Does the method answer the research question?
- Are design choices justified?
- Are variables, datasets, participants, or materials described clearly?
- Could another researcher reproduce the work?
- Are ethical and practical constraints acknowledged?
4. Data and Evidence
- Are data sources credible and appropriate?
- Is sample size or corpus coverage adequate?
- Are inclusion, exclusion, and preprocessing decisions documented?
- Are missing data and bias risks discussed?
5. Analysis
- Are statistical, qualitative, or computational methods appropriate?
- Are baselines and controls fair?
- Are uncertainty, sensitivity, or robustness checks included when needed?
- Are alternative explanations considered?
6. Results and Interpretation
- Are results clearly presented?
- Do claims stay within the evidence?
- Are figures, tables, and metrics understandable?
- Are negative or null results handled honestly?
7. Limitations and Threats to Validity
- Are limitations specific rather than generic?
- Are internal, external, construct, and conclusion-validity risks addressed?
- Does the paper distinguish speculation from demonstrated results?
8. Writing and Structure
- Is the argument easy to follow?
- Are sections organized around the research question?
- Are definitions and notation clear?
- Is the tone precise and scholarly?
9. Citations
- Do cited papers support the claims attached to them?
- Are primary sources used where possible?
- Are reviews labeled as reviews?
- Are preprints labeled as preprints?
- Are citation metadata and links correct?
Review Process
- Read the abstract, introduction, figures, and conclusion for claimed contribution.
- Read methods and results for evidence quality.
- Check the strongest claims against cited sources.
- Score each applicable dimension.
- Separate critical blockers from revision suggestions.
- End with concrete next edits.
Output Template
# Scholar Evaluation: <Artifact>
## Overall Assessment
- Overall score: <1-5 or N/A>
- Confidence: <high | medium | low>
- Summary: <3-5 sentences>
## Dimension Scores
| Dimension | Score | Evidence | Revision priority |
| --- | ---: | --- | --- |
| Problem and question | | | |
| Literature and context | | | |
| Methodology | | | |
| Data and evidence | | | |
| Analysis | | | |
| Results and interpretation | | | |
| Limitations | | | |
| Writing and structure | | | |
| Citations | | | |
## Critical Issues
## Recommended Revisions
## Evidence Checks Needed
Pitfalls
- Do not use the score as a substitute for concrete feedback.
- Do not penalize a paper for omitting a dimension outside its scope.
- Do not treat citation count, venue, or author reputation as proof of quality.
- Do not accept unsupported claims just because they appear in the abstract.
Related skills
More from affaan-m/ecc and the wider catalog.
search-first
Research existing solutions before writing custom code—search npm, PyPI, MCP, and GitHub systematically.
security-bounty-hunter
Hunt for exploitable, bounty-worthy security vulnerabilities in repositories with minimal noise.
security-review
Comprehensive security checklist and patterns for authentication, input validation, secrets, and sensitive features.
security-scan
Audit Claude Code configuration for security vulnerabilities, misconfigurations, and injection risks.
seo
Audit and implement technical SEO, on-page optimization, structured data, and content strategy for better search visibility.
skill-comply
Measure whether agents actually follow skills, rules, and definitions across prompt strictness levels.