Read exp
PaperDoctor: Evidence-Grounded and Actionable Feedback for Scientific Papers in Progress
npx -y skills add QinghongLin/paperdoctor --skill read-expAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Review experiment design and produce a prioritized reproduction plan. Targets claims with evidence_type "experiment" from check_claim.json. Output feeds into run-exp.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
4.3 KB, as published. Nobody here has run it
Review Experiments
Review experiment design for fairness and rigor, then produce a prioritized plan for reproduction.
Workflow
- [ ] Step 1: Load claims and paper
- [ ] Step 2: Review experiment design
- [ ] Step 3: Plan reproduction
- [ ] Step 4: Save report
Step 1: Load Claims and Paper
{paper_dir}/reports/check_claim.json— filter claims withevidence_typeincluding"experiment"
Each claim's id, source, quote, claim, evidence_type fields should be copied as-is into the output — do not modify them.
- Paper text from
{paper_dir}/metadata/{arxiv_id}/mathpix/{arxiv_id}.md - Repo
README.md— for setup instructions, datasets, checkpoints, commands
Step 2: Review Experiment Design
For each experiment claim, assess the design quality:
- Fair comparison — same training setting, same data splits, same evaluation protocol as baselines?
- Ablation sufficiency — are the key components isolated and tested?
- Statistical rigor — are results averaged over multiple runs? error bars or std reported?
- Baseline selection — are the baselines relevant and recent enough?
- Cherry-picking risk — are only favorable configurations shown, or is coverage broad?
Each design issue:
{
"id": 9,
"source": "experiments",
"quote": "Results are averaged over 5 independent runs",
"claim": "Main results are averaged over 5 runs",
"evidence_type": ["experiment"],
"status": "warning",
"reason": "No standard deviation or confidence interval reported despite claiming 5 runs",
"suggest": "Add standard deviations or confidence intervals across the 5 runs in Table 2."
}
When status is warning or error, include a suggest field with a concrete one-sentence fix.
Step 3: Plan Reproduction
Scan the repo for datasets and checkpoints. For each experiment claim, assign:
priority: high (main results) / medium (secondary) / low (very expensive)feasibility: ready (can run easily) / blocked (missing data, needs training, or too expensive)mode: eval / train / othercommand: exact command to rungoal: key metric(s) and target value(s) from the paper
Data/checkpoint availability:
- provided — already exists locally
- downloadable — public URL, < 1 GB
- restricted — registration required, or > 1 GB
Step 4: Save Report
Output: {paper_dir}/reports/check_exp.json
{
"summary": {
"total_claims": 10,
"design_issues": 3,
"experiments": 5,
"high": 2, "medium": 2, "low": 1,
"ready": 1, "blocked": 4
},
"results": [
{
"id": 9,
"source": "experiments",
"quote": "Results are averaged over 5 independent runs",
"claim": "Main results are averaged over 5 runs",
"evidence_type": ["experiment"],
"status": "warning",
"reason": "No standard deviation or confidence interval reported despite claiming 5 runs",
"suggest": "Add standard deviations or confidence intervals across the 5 runs in Table 2."
}
],
"plan": [
{
"id": 4,
"source": "experiments",
"quote": "Our method achieves 76.5% top-1 accuracy on CIFAR-100",
"claim": "Proposed distillation method reaches 76.5% on CIFAR-100",
"evidence_type": ["experiment"],
"priority": "high",
"feasibility": "ready",
"mode": "eval",
"command": "python eval.py --config configs/cifar100_resnet32x4.yaml --ckpt checkpoints/best.pth",
"goal": {"top1_acc": 76.5}
}
],
}
Coverage Rule
Every claim with experiment in evidence_type MUST appear in either results or plan. No claim may be silently skipped. If a claim is not worth a full review, still include it in results with status: "pass" and a brief reason.
Tips
- Missing error bars on a table that claims "average over N trials" is a
warning - Comparing against a 3-year-old baseline when newer ones exist is a
warning - Using different training epochs or data for your method vs baselines is an
error