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.
curl -fsSL codexskills.dev/install.sh \ | sh -s -- paper-reading Installs to ~/.agents/skills/paper-reading/ for every project on this machine.
curl -fsSL codexskills.dev/cli.mjs -o codex-skills.mjsnode codex-skills.mjs install paper-reading The CLI also searches, updates and removes skills. Run it with no arguments to pick from a list. Needs Node 20.12+.
curl -fsSL codexskills.dev/install.sh \ | sh -s -- --project paper-reading Installs to .agents/skills/paper-reading/ in the current repository. Commit it and everyone who runs Codex there gets it.
curl -fsSLO codexskills.dev/downloads/paper-reading.zipunzip -o paper-reading.zip -d ~/.agents/skills/ The archive holds the skill folder with its generated agents/openai.yaml. Unzip into .agents/skills/ to scope it to a repo.
& ([scriptblock]::Create((irm codexskills.dev/install.ps1))) paper-reading PowerShell 5.1 or 7. Installs to %USERPROFILE%\.agents\skills\. Add -Project for the current repo.
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
- You need to survey many papers on a topic: use literature-review
- You want to reproduce the paper's benchmark numbers yourself: use benchmark-comparisons
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.
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:
- What problem, for whom, and why existing approaches fall short (according to authors)?
- What are the claimed contributions? List them, numbered, in the authors’ terms.
- What kind of paper: new method, empirical study, benchmark/dataset, theory, system, position, survey?
- 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.
| Check | Questions |
|---|---|
| Baselines | Are they strong, recent and tuned with similar effort? Missing the obvious simple baseline? |
| Datasets | Standard and appropriate? Same splits as prior work? Any overlap between train and test? |
| Contamination | For LLM work: could the benchmark be in the pretraining data? Was it checked? |
| Metrics | Do they measure the claim? Is the improvement within noise? |
| Statistics | Multiple seeds/runs? Variance, confidence intervals or significance tests reported? |
| Ablations | Does removing each component show it matters? |
| Compute | Is the gain explained by more parameters, data or compute rather than the idea? |
| Generality | Tested on more than one dataset, domain, scale or model family? |
| Cherry-picking | Qualitative examples selected how? Are failure cases shown? |
| Theory | Are 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
| Rating | Meaning |
|---|---|
| Strong | Claims match evidence; solid baselines; multiple runs; code available; ideally reproduced |
| Promising | Good idea, evidence suggestive but limited (one dataset, single seed, no code) |
| Weak | Gains within noise, weak baselines, or key confounder unaddressed |
| Unsupported | Main 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-reviewinstead.
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.yaml
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.