Skip to content
Skills Library
Science & research · Analysis

paper-read

/paper-read

Line-by-line reading of a paper, thesis, manual or book chapter with exact page, equation, figure and table numbers - no skimming, signs checked on the rendered page, a reading note written to disk. Use whenever a PDF is read to cite it, extract a method or equation, check a claim, or feed the FWI Book or a manuscript; and when delegating reading to the benz:reader agent.

Repository
benz-skills ↗
Licence
MIT
Last repository change
10.11.2026

Assessment and security

90/ 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.
Content25 / 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
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.11.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

Line-by-line reading of a paper, thesis, manual or book chapter with exact page, equation, figure and table numbers - no skimming, signs checked on the rendered page, a reading note written to disk. Use whenever a PDF is read to cite it, extract a method or equation, check a claim, or feed the FWI Book or a manuscript; and when delegating reading to the benz:reader agent.

Original author description

Line-by-line reading of a paper, thesis, manual or book chapter with exact page, equation, figure and table numbers - no skimming, signs checked on the rendered page, a reading note written to disk. Use whenever a PDF is read to cite it, extract a method or equation, check a claim, or feed the FWI Book or a manuscript; and when delegating reading to the benz:reader agent.

How it works

  1. Steps
  2. Rules
Original SKILL.md headings · 33 lines, 344 words
SKILL.md preview
---
name: paper-read
description: Line-by-line reading of a paper, thesis, manual or book chapter with exact page, equation, figure and table numbers - no skimming, signs checked on the rendered page, a reading note written to disk. Use whenever a PDF is read to cite it, extract a method or equation, check a claim, or feed the FWI Book or a manuscript; and when delegating reading to the benz:reader agent.
---

# paper-read

A citation is only as good as the reading behind it. Read every line of what you cite; never cite
what you did not open; never attribute an equation you did not see on the page.

## Steps

1. **Locate and identify.** Find the PDF on disk (`mypaper/mybible/{alg,etc,fwi,das,cs}/`,
   `inspiring_papers/`, a repo's `papers/`). Take the full reference **from the PDF itself** (title page,
   journal header, DOI). Record the **page offset** (printed page vs PDF page) once, e.g. "PDF p = printed p + 17".
2. **Read it all, in order**, including appendices and supplementary material, in chunks of <= 20 PDF pages
   (`Read` with `pages=`; `pdftotext -layout -f a -l b` for search). Completion: every page was opened;
   the note says which pages were read.
3. **Check symbols on the rendered page** wherever a sign, conjugate, prime, transpose, hat or bar matters
   (`pdftotext` drops overbars and primes): read the page image. Write which equations were checked this way.
4. **Write the reading note** (`references/note_template.md`) to the project's notes folder
   (`mypaper/mybible/notes/<Key>.md`, or the repo's `docs/notes/<Key>.md`): claims with page + eq/fig/table;
   assumptions; method equations transcribed with their numbers and conventions (Fourier sign, units);
   data and numbers reported; limitations the authors state; what we can use; what we must not claim.
5. **Mark uncertainty**: anything not verified on the page is written as UNVERIFIED in the note, and an
   unverifiable pointer is dropped from the text (keep the citation, drop the "eq. N") rather than guessed.

## Rules

- Quote at most 15 words of any source, in quotation marks, with page; otherwise paraphrase.
- Separate "the paper claims" from "we verified" in every note and every manuscript sentence.
- Cite the book (FWI Book) by `\label`, never by page/chapter number (it renumbers).
- When delegating: use the `benz:reader` agent with the PDF path, page range, the questions, and the note
  path; require page/eq for every statement; re-check two of its pointers yourself (`benz:core-delegate`).
- Venue red flags (non-peer-reviewed preprint servers of unknown standing) are recorded in the note; such
  papers are not cited as evidence.
Files in this package (2)
  • SKILL.md 3 KB
  • references/note_template.md 1 KB

Versions

The database has no other skills named paper-read.

Database snapshot: 13.11.2026 · package version f5dae3ed9eb2 (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,…
  • 90paper-write
    Honest scientific writing for Benz's manuscripts and books - book first (the FWI Book takes published work only, then the project paper), no hallucination or ghost citations, math derived step by step, every number traced, scope beside the headline, refuted predictions stated,…
  • 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.
  • 100zotero-paper-note
    Read a paper from Zotero, generate a structured reading note, attach it back to the Zotero item, and append one structured JSON line to literature.jsonl for later batch analysis. Use when the user provides a paper title/authors/DOI/Zotero item and asks to "read this paper",…
  • 100paper-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…
  • 100paper-equation-guide
    Explain every equation of a research paper in a colored PDF guide: labeled equation terms, plain meaning, worked numeric examples, helper drawings and simulation checks. Use when asked to explain a paper's math.

Feedback and reports

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