scholar-evaluation
使用 ScholarEval 框架对学术工作进行系统性评估,在研究质量维度(包括问题表述、方法学、分析与写作)上提供结构化评价,并结合定量评分与可执行的改进建议。
分类
内容创作安装
下载并解压到你的 skills 目录
复制命令,发送给智能体自动安装:
Scholar Evaluation
Overview
Apply the ScholarEval framework to systematically evaluate scholarly and research work. This skill provides structured evaluation methodology based on peer-reviewed research assessment criteria, enabling comprehensive analysis of academic papers, research proposals, literature reviews, and scholarly writing across multiple quality dimensions.
When to Use This Skill
Use this skill when:
Visual Enhancement with Scientific Schematics
When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.
If your document does not already contain schematics or diagrams:
For new documents: Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.
How to generate schematics:
python scripts/generate_schematic.py "your diagram description" -o figures/output.pngThe AI will automatically:
When to add schematics:
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
Evaluation Workflow
Step 1: Initial Assessment and Scope Definition
Begin by identifying the type of scholarly work being evaluated and the evaluation scope:
Work Types:
Evaluation Scope:
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:
- Clarity and specificity of research questions
- Theoretical or practical significance
- Feasibility and scope appropriateness
- Novelty and contribution potential
- Comprehensiveness of coverage
- Critical synthesis vs. mere summarization
- Identification of research gaps
- Currency and relevance of sources
- Proper contextualization
- Appropriateness for research questions
- Rigor and validity
- Reproducibility and transparency
- Ethical considerations
- Limitations acknowledgment
- Quality and appropriateness of data
- Sample size and representativeness
- Data collection procedures
- Source credibility and reliability
- Appropriateness of analytical methods
- Rigor of analysis
- Logical coherence
- Alternative explanations considered
- Results-claims alignment
- Clarity of presentation
- Statistical or qualitative rigor
- Visualization quality
- Interpretation accuracy
- Implications discussion
- Clarity and organization
- Academic tone and style
- Grammar and mechanics
- Logical flow
- Accessibility to target audience
- 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:
Quantitative Scoring (Optional):
Use a 5-point scale where applicable:
To calculate aggregate scores programmatically, use scripts/calculate_scores.py.
Step 4: Synthesize Overall Assessment
Provide an integrated evaluation summary:
Step 5: Provide Actionable Feedback
Transform evaluation findings into constructive, actionable feedback:
Feedback Structure:
Feedback Format Options:
Step 6: Contextual Considerations
Adjust evaluation approach based on:
Stage of Development:
Purpose and Venue:
Discipline-Specific Norms:
Resources
references/evaluation_framework.md
Detailed evaluation criteria, rubrics, and quality indicators for each ScholarEval dimension. Load this reference when conducting evaluations to access specific assessment guidelines and scoring rubrics.
Search patterns for quick access:
scripts/calculate_scores.py
Python script for calculating aggregate evaluation scores from dimension-level ratings. Supports weighted averaging, threshold analysis, and score visualization.
Usage:
python scripts/calculate_scores.py --scores <dimension_scores.json> --output <report.txt>Best Practices
Example Evaluation Workflow
User Request: "Evaluate this research paper on machine learning for drug discovery"
Response Process:
references/evaluation_framework.md for detailed criteria- Problem formulation: Clear research question about ML model performance
- Literature review: Comprehensive coverage of recent ML and drug discovery work
- Methodology: Appropriate deep learning architecture with validation procedures
- [Continue through all dimensions...]
- Strong methodology and reproducible code
- Needs more diverse dataset evaluation
- Writing could improve clarity in results section
Integration with Scientific Writer
This skill integrates seamlessly with the scientific writer workflow:
After Paper Generation:
SCHOLAR_EVALUATION.md alongside PEER_REVIEW.mdDuring Revision:
Publication Preparation:
Notes
Citation
This skill is based on the ScholarEval framework introduced in:
Moussa, H. N., Da Silva, P. Q., Adu-Ampratwum, D., East, A., Lu, Z., Puccetti, N., Xue, M., Sun, H., Majumder, B. P., & Kumar, S. (2025). _ScholarEval: Research Idea Evaluation Grounded in Literature_. arXiv preprint arXiv:2510.16234. https://arxiv.org/abs/2510.16234
Abstract: ScholarEval is a retrieval augmented evaluation framework that assesses research ideas based on two fundamental criteria: soundness (the empirical validity of proposed methods based on existing literature) and contribution (the degree of advancement made by the idea across different dimensions relative to prior research). The framework achieves significantly higher coverage of expert-annotated evaluation points and is consistently preferred over baseline systems in terms of evaluation actionability, depth, and evidence support.