Paper Reading skill for Codex

What the paper claims vs what it proves. Codex reads a paper in three passes: the claimed contributions, the evidence behind each claim, then reproducibility and limits. It checks baseline strength, ablations, run-to-run variance, benchmark contamination and compute confounds, assigns a trust rating with reasons, and ends with what the result means for your system and the smallest experiment to test it.

  • Research
  • $paper-reading
  • 125 lines
  • 2 files
  • ~1,450 tokens
  • MIT
  • Updated

Install

curl -fsSL codexskills.dev/install.sh \  | sh -s -- paper-reading

Installs to ~/.agents/skills/paper-reading/ for every project on this machine.

104-line POSIX script. No sudo, no telemetry. Read install.sh

Use it in Codex

Start a prompt with $paper-reading, or pick it from /skills. You can also just describe the task: Codex reads the description below and loads the playbook when your request matches.

What Codex reads before loading it

Reads research papers critically in three passes - claims and contribution, method and evidence, then reproducibility and limits - checking baselines, ablations, statistics, data leakage, benchmark contamination and code availability, and produces a structured summary with a trust rating and what it would take to apply the result. Use when asked to summarize, explain, critique or review an arXiv preprint, conference or journal paper, or decide whether a paper's technique is worth implementing.

Use it when

  • You need a critical summary of a single paper, not just the abstract
  • You are deciding whether to implement a technique from a paper
  • You have to review a paper for a conference, journal or reading group

Use something else when

How to check the result

Every number in the summary cites a table or section of the paper, and each weakness points to a specific experiment rather than a generic call for more work.

The mistake it prevents

Accepting a single-seed improvement that is smaller than the run-to-run variance reported elsewhere in the same paper.

~/.agents/skills/paper-reading/SKILL.md

--- name: paper-reading description: Reads research papers critically in three passes - claims and contribution, method and evidence, then reproducibility and limits - checking… license: MIT ---

A useful paper summary separates what the authors claim, what their evidence actually supports, and what a practitioner should do with it. Restating the abstract in different words is not a reading.

Get the right version

  • arXiv: check the version history (/abs/2401.01234v3) and whether a peer-reviewed version exists (venue, journal DOI). Results sometimes change between versions.
  • Look for the official code and data links, an OpenReview page with reviews (ICLR, NeurIPS and others publish them), errata and retraction notices.
  • If the user supplies a PDF, extract text with pdftotext -layout paper.pdf - or $pdf-processing; check figures and tables visually, since extraction mangles them.

Fetching papers and code needs network; in an offline sandbox, work from the provided file and list what you could not check.

Three passes

Pass 1: shape (10 minutes)

Read title, abstract, introduction’s contribution list, section headings, figures and tables, conclusion. Answer:

  1. What problem, for whom, and why existing approaches fall short (according to authors)?
  2. What are the claimed contributions? List them, numbered, in the authors’ terms.
  3. What kind of paper: new method, empirical study, benchmark/dataset, theory, system, position, survey?
  4. Is it worth a deeper read for the user’s purpose? If not, stop and say why.

Pass 2: evidence

For each claimed contribution, find the experiment or proof that supports it and judge it.

CheckQuestions
BaselinesAre they strong, recent and tuned with similar effort? Missing the obvious simple baseline?
DatasetsStandard and appropriate? Same splits as prior work? Any overlap between train and test?
ContaminationFor LLM work: could the benchmark be in the pretraining data? Was it checked?
MetricsDo they measure the claim? Is the improvement within noise?
StatisticsMultiple seeds/runs? Variance, confidence intervals or significance tests reported?
AblationsDoes removing each component show it matters?
ComputeIs the gain explained by more parameters, data or compute rather than the idea?
GeneralityTested on more than one dataset, domain, scale or model family?
Cherry-pickingQualitative examples selected how? Are failure cases shown?
TheoryAre assumptions realistic? Do proofs cover the setting used in experiments?

Write down the single most important table or figure and what it actually shows.

Pass 3: reproducibility and limits

  • Code, weights and data released? Licence? Does the repo match the paper’s version?
  • Are hyperparameters, prompts, hardware and training time given?
  • What do the authors list as limitations, and what did they leave out?
  • Has anyone reproduced or refuted it? Search for the title plus “reproduction”, “replication”, or check citing papers in Semantic Scholar.
  • Conflicts of interest: does the authors’ organisation sell the method or product?

Trust rating

RatingMeaning
StrongClaims match evidence; solid baselines; multiple runs; code available; ideally reproduced
PromisingGood idea, evidence suggestive but limited (one dataset, single seed, no code)
WeakGains within noise, weak baselines, or key confounder unaddressed
UnsupportedMain claim not backed by the experiments shown

State the rating with the one or two reasons that decided it.

Explaining to the user

Match depth to the request:

  • “Explain this paper”: plain-language problem, idea, result, and one analogy. Define each term on first use. Include a small worked example or pseudo-code of the core method.
  • “Should we use this”: add applicability to their system (data size, latency, licence, engineering cost) and a minimal experiment to test it on their data.
  • “Review this paper” (as a reviewer): structure as summary, strengths, weaknesses, questions for authors, minor issues, and an overall assessment. Be specific and fair; critique the work, never the authors.

Gotchas

  • “State of the art” usually means on specific benchmarks at a specific date. Name them.
  • Relative improvements hide scale: “30% error reduction” from 1.0% to 0.7% may not matter.
  • Single-seed deep learning results often vary by more than the reported gain.
  • Benchmarks saturate and leak; recent LLM papers on old benchmarks need contamination checks.
  • Figures with truncated or log axes exaggerate differences. Read the numbers.
  • Do not reproduce long passages, figures or tables verbatim from copyrighted papers. Summarise and cite with page or section numbers.
  • Never invent numbers, author names, or venues. If the PDF is unreadable at a point, say so.
  • For a set of papers on one topic, use $literature-review instead.

Verification

  • Every number quoted in the summary appears in the paper (cite table or section).
  • The contribution list matches the paper’s own; disagreements with it are labelled as yours.
  • Weaknesses are concrete (“Table 3 uses one seed; the 0.4 gain is within the 0.6 std in Table 7”), not generic (“more experiments needed”).

Output template

# <Paper title> (<venue/arXiv id, version>, <year>)
**One line:** <what they did and found>
**Type:** method | empirical | benchmark | theory | system | survey
**Trust:** Strong | Promising | Weak | Unsupported - <reason>

## Problem and idea
## Claimed contributions
1. ...
## What the evidence shows
- Claim 1 -> <table/figure>: <supported / partly / not>, because ...
## Weaknesses and open questions
## Reproducibility
Code: <link/none> | Data: <...> | Reproduced by others: <yes/no/unknown>
## So what for us
<applicability, cost, the smallest experiment that would test it on our data>

What the zip contains

SKILL.md plus the interface file below. Nothing runs on install.

agents/openai.yamlgenerated from this page

Gives the Codex app a display name, a one-line description and a starter prompt for this skill.

interface:
  display_name: "Paper Reading"
  short_description: "What the paper claims vs what it proves"
  default_prompt: "$paper-reading Summarise this arXiv paper and tell me whether the results hold up"

About this skill

Written and maintained by the Codex Skills editors to the same editorial standard as every skill here: a selective description, a real workflow, known pitfalls and a way to verify the work. First published , last updated . MIT licensed. Something wrong or out of date? Tell us.

esc