agentsclimarketplace

Read exp

Skill QinghongLin/paperdoctor/skills/read-exp

PaperDoctor: Evidence-Grounded and Actionable Feedback for Scientific Papers in Progress

Install
npx -y skills add QinghongLin/paperdoctor --skill read-exp

Assembled 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 with evidence_type including "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 / other
  • command: exact command to run
  • goal: 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

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.