Skip to content
Skills Library
Science & research · Learning & explanation

paper-reader

/paper-reader

Read one paper (PDF, arXiv id, DOI, or text) and produce a structured note: the claim, method, evidence, limitations, how it relates to the student's research question, and quotable passages with locations, so that lit-review-synthesis can build an argument from many notes. Use when working through a reading list, when a supervisor asks what a paper actually shows, or before citing a paper for a specific claim.

Repository
dotclaude ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Read one paper (PDF, arXiv id, DOI, or text) and produce a structured note: the claim, method, evidence, limitations, how it relates to the student's research question, and quotable passages with locations, so that lit-review-synthesis can build an argument from many notes. Use when working through a reading list, when a supervisor asks what a paper actually shows, or before citing a paper for a specific claim.

Arguments

/paper-reader path, DOI, or arXiv id of the paper; optionally the research question to read it against
Original author description

Read one paper (PDF, arXiv id, DOI, or text) and produce a structured note: the claim, method, evidence, limitations, how it relates to the student's research question, and quotable passages with locations, so that lit-review-synthesis can build an argument from many notes. Use when working through a reading list, when a supervisor asks what a paper actually shows, or before citing a paper for a specific claim.

How it works

  1. Get the text
  2. Read in this order
  3. The note
  4. Rules
Original SKILL.md headings · 69 lines, 473 words
SKILL.md preview
---
name: paper-reader
description: "Read one paper (PDF, arXiv id, DOI, or text) and produce a structured note: the claim, method, evidence, limitations, how it relates to the student's research question, and quotable passages with locations, so that lit-review-synthesis can build an argument from many notes. Use when working through a reading list, when a supervisor asks what a paper actually shows, or before citing a paper for a specific claim."
argument-hint: "path, DOI, or arXiv id of the paper; optionally the research question to read it against"
---

Read the paper, not the abstract. The note you produce will be trusted later, when the student is writing under deadline and will not reopen the PDF, so every claim in the note must be traceable to a page or section.

## Get the text

- A local PDF: extract text (`pdftotext -layout file.pdf -`), and read the figures and tables where the text is unclear.
- An arXiv id: fetch the LaTeX source when available (`https://arxiv.org/e-print/<id>`, a gzipped tar) because it keeps equations and tables intact; otherwise the PDF (`https://arxiv.org/pdf/<id>`).
- A DOI: resolve it to metadata with CrossRef, then ask the student for the PDF if it is not open access. Do not summarise a paper from its abstract and pretend it was read.

## Read in this order

1. Abstract, introduction, conclusion: what the authors *claim*.
2. Method and setup: what they *did*, precisely enough to judge the claim.
3. Results, including tables: what the evidence *shows*, including what it does not show.
4. Related work and limitations: where they place themselves and what they concede.
5. References: which works they lean on (candidates for `citation-graph`).

## The note

Write one markdown file per paper under `research/notes/`, named `<firstauthor><year>-<short-title>.md`, with the BibTeX key in the front matter so `citation-verifier` and `lit-review-synthesis` can join them:

```markdown
---
key: smith2023feedback
title: ...
authors: ...
year: 2023
venue: ...
doi: 10.xxxx/yyyy
type: empirical | design | survey | theory | position
read: 2026-09-21
relevance: high | medium | low
---

## One-sentence claim
What the paper says it shows, in your words.

## Research question it answers
Their question, and which of the student's sub-questions it bears on.

## Method
Design, data (source, size), procedure, metrics, baselines. Enough to judge validity.

## Evidence
The key results with numbers, and the table or figure each comes from (Table 3, Fig. 2).
What was not tested.

## Limitations
Theirs (from the paper) and yours (what you noticed).

## Relation to this thesis
Supports / contradicts / extends / provides method for: which claim of the student's, and how.

## Quotable
> "exact sentence" (p. 4, Sec. 3.2)
At most five. Exact text, with location, for use in the review.

## Follow-up
References worth chasing, with the reason.
```

## Rules

- Distinguish what the paper *claims* from what its evidence *supports*; when they differ, say so in Limitations.
- Numbers are copied, not rounded or recalled. If a number is unreadable in the extraction, write `[unreadable, check Table N]`.
- Never invent a page number. If the source is LaTeX or HTML with no pagination, cite the section.
- The note is in the student's voice for the student's purpose; "relevance: low" is a valid and useful outcome.
- When reading several papers, do not compare them here; that is `lit-review-synthesis`. One paper, one note.

Versions

RepositoryScoreLicence
This page · khaledsaeed18/dotclaude100MIT
lxwang98/research-writing-preset100MIT
huangkiki/dailypaper-skills100Apache-2.0

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 18343eeef5ce (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90read-paper-to-notes
    Read an academic-paper PDF or supplied full text and turn it into a faithful, structured Markdown deep-reading note. Use when the user provides a research paper and asks to read, explain, summarize, take notes, extract its problem, method, equations, experiments, results,…
  • 100researchzy-paper-card
    Build a source-grounded Paper Card (fixed Sections 01-16) for one paper from a PDF, DOI, arXiv ID, publisher page or pasted text, covering the research question, method logic, experiment-to-claim evidence, conclusion boundaries, limitations, critical analysis and testable…
  • 100triage-paper
    Triage an academic paper into a structured reference summary for the research repo. Use when given an arxiv ID, arxiv URL, DOI, or paper PDF. Creates references/{slug}.md; adds REVIEWED.md entry and REFERENCE_INDEX.md row. Triggers: triage paper, add paper, analyse paper, review…
  • 86paper-ingest
    Read a paper URL or arXiv/DOI identifier, produce an evidence-grounded embodied AI note, classify it, and save it to an Embodied Paper Notes repository. Use for adding or updating individual papers, not broad literature reviews.
  • 91read-arxiv-paper
    Use this skill when asked to read an arxiv paper given an arxiv URL
  • 95zotero-paper-reader
    Deep-read or quick-read a given paper, arXiv link or existing Zotero item, reading the local PDF (including Attanger attachments), and save the research note as a Zotero child note. Use for "read this", "deep read", "take a quick look"; hand save-only requests to zotero-paper-save.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.