Source Analysis & Evaluation Skill
Overview
A systematic approach to reading, dismantling, and evaluating scientific papers and code repositories to extract core contributions and assess quality.
1. Academic Paper Analysis
Reading Strategy: The Three-Pass Approach
Pass 1: The Bird's Eye View (5-10 mins)
- •Title, Abstract, and Keywords: Determine relevance.
- •Introduction: Identify the problem statement and research gap.
- •Headings: Scan structure.
- •Conclusion: Read the Summary/Conclusion to see the main claim.
Pass 2: The Content (1 hour)
- •Figures and Tables: Look at the data first. Do the captions make sense?
- •Methodology: How did they solve the problem?
- •Experiments: What benchmarks were used?
Paper Quality Evaluation
- •Venue: Top-tier conference (NeurIPS, ICML, CVPR) or high-impact journal?
- •Citations: Is it highly cited relative to its age?
- •Rigor: Are experiments reproducible? Are baselines strong?
Extraction Framework: PICO-C
- •Population/Problem: What is being studied?
- •Intervention/Idea: What is the new proposed method?
- •Comparison: What are they comparing against?
- •Outcome: What were the results?
- •Context: Limitations and assumptions.
2. Code Repository Evaluation (GitHub)
Relevance Check
- •Does the README clearly state the problem and solution?
- •Is it a standalone implementation or just a collection of scripts?
Quality Signals
- •Stars/Forks: High numbers often indicate community trust (but check for bot inflation).
- •Activity: When was the last commit? Is it actively maintained?
- •Documentation: easy setup steps? Example usage?
- •License: Is there a permissive license (MIT, Apache 2.0)?
Code Inspection
- •Structure: Is the code modular?
- •Dependencies: Are they modern and pinned?
- •Tests: Are there unit tests? (
tests/folder)