Step 1: Initial Assessment and Scope Definition
Begin by identifying the type of scholarly work being evaluated and the evaluation scope:
Work Types:
- Full research paper (empirical, theoretical, or review)
- Research proposal or protocol
- Literature review (systematic, narrative, or scoping)
- Thesis or dissertation chapter
- Conference abstract or short paper
Evaluation Scope:
- Comprehensive (all dimensions)
- Targeted (specific aspects like methodology or writing)
- Comparative (benchmarking against other work)
Ask the user to clarify if the scope is ambiguous.
Step 2: Dimension-Based Evaluation
Systematically evaluate the work across the ScholarEval dimensions. For each applicable dimension, assess quality, identify strengths and weaknesses, and provide scores where appropriate.
Refer to references/evaluation_framework.md for detailed criteria and rubrics for each dimension.
Core Evaluation Dimensions:
- Problem Formulation & Research Questions
- Clarity and specificity of research questions
- Theoretical or practical significance
- Feasibility and scope appropriateness
- Novelty and contribution potential
- Literature Review
- Comprehensiveness of coverage
- Critical synthesis vs. mere summarization
- Identification of research gaps
- Currency and relevance of sources
- Proper contextualization
- Methodology & Research Design
- Appropriateness for research questions
- Rigor and validity
- Reproducibility and transparency
- Ethical considerations
- Limitations acknowledgment
- Data Collection & Sources
- Quality and appropriateness of data
- Sample size and representativeness
- Data collection procedures
- Source credibility and reliability
- Analysis & Interpretation
- Appropriateness of analytical methods
- Rigor of analysis
- Logical coherence
- Alternative explanations considered
- Results-claims alignment
- Results & Findings
- Clarity of presentation
- Statistical or qualitative rigor
- Visualization quality
- Interpretation accuracy
- Implications discussion
- Scholarly Writing & Presentation
- Clarity and organization
- Academic tone and style
- Grammar and mechanics
- Logical flow
- Accessibility to target audience
- Citations & References
- Citation completeness
- Source quality and appropriateness
- Citation accuracy
- Balance of perspectives
- Adherence to citation standards
Step 3: Scoring and Rating
For each evaluated dimension, provide:
Qualitative Assessment:
- Key strengths (2-3 specific points)
- Areas for improvement (2-3 specific points)
- Critical issues (if any)
Quantitative Scoring (Optional):
Use a 5-point scale where applicable:
- 5: Excellent - Exemplary quality, publishable in top venues
- 4: Good - Strong quality with minor improvements needed
- 3: Adequate - Acceptable quality with notable areas for improvement
- 2: Needs Improvement - Significant revisions required
- 1: Poor - Fundamental issues requiring major revision
To calculate aggregate scores programmatically, use scripts/calculate_scores.py.
Step 4: Synthesize Overall Assessment
Provide an integrated evaluation summary:
- Overall Quality Assessment - Holistic judgment of the work's scholarly merit
- Major Strengths - 3-5 key strengths across dimensions
- Critical Weaknesses - 3-5 primary areas requiring attention
- Priority Recommendations - Ranked list of improvements by impact
- Publication Readiness (if applicable) - Assessment of suitability for target venues
Step 5: Provide Actionable Feedback
Transform evaluation findings into constructive, actionable feedback:
Feedback Structure:
- Specific - Reference exact sections, paragraphs, or page numbers
- Actionable - Provide concrete suggestions for improvement
- Prioritized - Rank recommendations by importance and feasibility
- Balanced - Acknowledge strengths while addressing weaknesses
- Evidence-based - Ground feedback in evaluation criteria
Feedback Format Options:
- Structured report with dimension-by-dimension analysis
- Annotated comments mapped to specific document sections
- Executive summary with key findings and recommendations
- Comparative analysis against benchmark standards
Step 6: Contextual Considerations
Adjust evaluation approach based on:
Stage of Development:
- Early draft: Focus on conceptual and structural issues
- Advanced draft: Focus on refinement and polish
- Final submission: Comprehensive quality check
Purpose and Venue:
- Journal article: High standards for rigor and contribution
- Conference paper: Balance novelty with presentation clarity
- Student work: Educational feedback with developmental focus
- Grant proposal: Emphasis on feasibility and impact
Discipline-Specific Norms:
- STEM fields: Emphasis on reproducibility and statistical rigor
- Social sciences: Balance quantitative and qualitative standards
- Humanities: Focus on argumentation and scholarly interpretation