Skip to content
Back to search

deeppapernote

MarketplaceWorks with Claude CodeGitHub

Official marketplace for the DeepPaperNote paper-reading skills.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/917dhj/deeppapernote with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/917dhj/deeppapernote'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/917dhj-deeppapernote/badge.svg)](/listings/917dhj-deeppapernote)

HTML

<a href="/listings/917dhj-deeppapernote"><img src="/api/listings/917dhj-deeppapernote/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the plugin

**Claude Code** — install from the plugin marketplace:

claude plugin marketplace add 917Dhj/DeepPaperNote
claude plugin install deeppapernote@deeppapernote

**Any agent** — install with the skills CLI:

npx skills add 917Dhj/DeepPaperNote

Both routes install the same skills. The plugin route brings both `deeppapernote` and `paper-glossary`; the skills CLI installer lets you choose which skills to install and which agents should receive them. For most users, start with `deeppapernote`; add `paper-glossary` only if you want reusable terminology notes.

2. Install the core PDF dependency

python3 -m pip install PyMuPDF

If you use `uv`, install `PyMuPDF` into the same Python environment that DeepPaperNote will use:

uv pip install PyMuPDF

DeepPaperNote requires Python 3.10 or newer. `PyMuPDF` powers the core PDF extraction path.

3. Hand a paper to your agent

A title, DOI, URL, arXiv ID, or local PDF all work. Zotero items are also supported when a compatible integration is available.

Generate a deep-reading note for this paper: <title, DOI, URL, arXiv ID, or local PDF>
Turn this paper into an Obsidian note: <paper>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "deeppapernote",
  3. "description": "Official marketplace for the DeepPaperNote paper-reading skills.",
  4. "owner": {
  5. "name": "917Dhj",
  6. "url": "https://github.com/917Dhj"
  7. },
  8. "plugins": [
  9. {
  10. "name": "deeppapernote",
  11. "source": "./",
  12. "description": "Academic paper reading and Obsidian note generation skills for building a research WIKI.",
  13. "category": "research"
  14. }
  15. ]
  16. }
README.md · README · 221 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # DeepPaperNote
  3. **Turn one complex paper into an Obsidian note you will actually want to keep.**
  4. [English](./README.md) | [简体中文](./README.zh-CN.md)
  5. [![Homepage](https://img.shields.io/badge/homepage-online-2563eb)](https://917dhj.github.io/DeepPaperNote/)
  6. [![Release](https://img.shields.io/github/v/release/917Dhj/DeepPaperNote?display_name=tag&color=0f766e)](https://github.com/917Dhj/DeepPaperNote/releases)
  7. [![License](https://img.shields.io/badge/license-MIT-c9a227)](./LICENSE)
  8. [![Agents](https://img.shields.io/badge/agents-Claude%20Code%20%2B%20Codex-7c3aed)](./skills/deeppapernote/SKILL.md)
  9. [![Output](https://img.shields.io/badge/output-Obsidian-16a34a)](./skills/deeppapernote/references/obsidian-format.md)
  10. </div>
  11. [![DeepPaperNote Hero](./assets/hero-deep-reading-workshop.png)](https://917dhj.github.io/DeepPaperNote/)
  12. <p align="center">
  13. <em>Read one paper deeply. Add one durable page to your academic wiki.</em>
  14. </p>
  15. **When you study an important paper, the hard part is rarely the reading. It is turning what you understood into a note you can still use later.** Finding the source, matching figures to the text, copying numbers over, and tracing the method often take the better part of a day. And the papers you have read end up scattered, with nothing connecting one to another.
  16. **DeepPaperNote is an agent skill that runs in Claude Code, Codex, and any other agent that supports skills.** Hand it a paper, and it reads the full text, writes an illustrated deep-reading note, saves it into your Obsidian vault, and links it to the other papers you have read. **Every paper you read grows your academic wiki a little.**
  17. - 🚀 **One sentence, one note.** No prompts to learn, no templates to set up. Say "Generate a deep-reading note for this paper" with a title, DOI, arXiv ID, or PDF, and it finds the paper, reads it in full, extracts the figures, and saves the note into your vault.
  18. - 🎓 **Reads like a domain expert.** From CS and AI to medicine, psychology, and the humanities, from new methods and benchmarks to surveys and clinical trials, your papers can all go to DeepPaperNote. Each of 10 paper types gets its own way of reading, drawn from more than 50 reviewer guidelines and reporting standards such as the NeurIPS review criteria and CONSORT, and tested on 34 real papers.
  19. - 🎯 **Accurate and complete.** Every conclusion traces back to the paper, numbers come straight from its text and tables, and every main experiment is covered. When the paper does not report something, the note says so instead of guessing. Before saving, every note goes through an independent review and a strict quality check, and when the full text cannot be read, it never makes one up.
  20. - 🖼️ **Figures, tables, and formulas in the text.** Figures and tables are cropped from the PDF and placed right where the note discusses them, and key formulas render in Obsidian. No more flipping back to the PDF.
  21. - 🧠 **A vault that knows you better the more you use it.** Each note links to related papers in your vault and goes into the domain folders you already use. Record your research directions, and each note's Takeaways tell you what the paper means for your own work.
  22. ## 📰 News
  23. - **[v3.0.0]** 🎓 Notes read each paper by its type: 10 paper types each get their own way of reading and note structure, every figure is visually reviewed before it enters the note, and an independent quality review runs before saving. [Release notes](https://github.com/917Dhj/DeepPaperNote/releases/tag/v3.0.0)
  24. - **[v3.0.0]** 🧠 Every note joins your vault: notes gain Takeaways and Connections sections and carry structured properties, and two new skills, [`research-memory`](./skills/research-memory/README.md) and [`organize-wiki`](./skills/organize-wiki/README.md), tailor the takeaways to your research directions and keep your domain folders in order.
  25. - **[v2.3.1]** 🔌 Added support for [DeepPaperNote Connector](https://github.com/917Dhj/DeepPaperNote-Connector): papers you save from your browser can get their notes in the same paper directory. [Release notes](https://github.com/917Dhj/DeepPaperNote/releases/tag/v2.3.1)
  26. News lists only the three most recent user-facing milestones. See the [changelog](./CHANGELOG.md) and [GitHub Releases](https://github.com/917Dhj/DeepPaperNote/releases) for the full history.
  27. ## 🚀 Quick Start
  28. ### 1. Install
  29. **Claude Code**: install from the plugin marketplace
  30. ```bash
  31. claude plugin marketplace add 917Dhj/DeepPaperNote
  32. claude plugin install deeppapernote@deeppapernote
  33. ```
  34. **Codex and other agents that support skills**: install with the skills CLI
  35. ```bash
  36. npx skills add 917Dhj/DeepPaperNote
  37. ```
  38. The plugin installs all four skills at once. The skills CLI lets you choose which skills to install and which agents receive them. To try it out, `deeppapernote` alone is enough; see [below](#-from-paper-to-wiki) for what the other three do.
  39. ### 2. Install the PDF dependency
  40. ```bash
  41. python3 -m pip install PyMuPDF
  42. ```
  43. Python 3.10 or newer is required. If you use `uv`, run `uv pip install PyMuPDF` in the Python environment DeepPaperNote will use.
  44. ### 3. Read a paper
  45. Tell your agent in one sentence, with the paper's title, DOI, URL, arXiv ID, or local PDF:
  46. ```text
  47. Generate a deep-reading note for this paper: <paper>
  48. Turn this paper into an Obsidian note: <paper>
  49. ```
  50. You can also call it with the slash command `/deeppapernote <paper>`.
  51. The first time, it asks you two things: whether notes should be in English or Chinese, and whether to save them in the current workspace or your Obsidian vault. It remembers your answers and does not ask again. To use a different language or location for one paper, just say so in the request. For environment variables and other settings, see [User Configuration](./skills/deeppapernote/references/user-configuration.md).
  52. ### 4. Update to a new version
  53. **Claude Code**:
  54. ```bash
  55. claude plugin marketplace update deeppapernote
  56. claude plugin update deeppapernote@deeppapernote
  57. ```
  58. Restart Claude Code to apply the update.
  59. **skills CLI**:
  60. ```bash
  61. npx skills update
  62. ```
  63. ## 👀 What a Note Looks Like
  64. ![A DeepPaperNote deep-reading note for Attention Is All You Need](./assets/demo-note.en.webp)
  65. Every note has three parts: the opening and closing are the same for every paper, and the body in between follows the paper's type.
  66. | Part | Sections |
  67. | --- | --- |
  68. | **Opening** | Core Information · Abstract · Contributions · One-Sentence Summary |
  69. | **Body** | Method paper: Background and Problem → Limitations of Prior Work → Key Idea and Challenges → Method → Experimental Evidence → Deep Analysis<br>Benchmark: Evaluation Gap → Task and Design Goals → Construction and Quality Control → Evaluation Framework → Findings → What It Really Measures<br>Survey: Scope and Search → Taxonomy → Directions → Consensus, Disagreement, and Gaps<br>…10 paper types in all |
  70. | **Closing** | Limitations · Takeaways · Connections · My Notes |
  71. The closing sections are where the note meets your vault:
  72. - **Takeaways**: Transferable Ideas and Next Steps, covering which of the paper's ideas carry over to other problems and what to do after reading it. Once you set up research memory, this part is written against your own research directions.
  73. - **Connections**: links to related paper notes in your vault, and the key prior work you need to understand this paper.
  74. - **My Notes**: yours to write in, and kept exactly as it is when the note is regenerated.
  75. <details>
  76. <summary><b>What appears in your vault after saving</b></summary>
  77. Each paper gets its own folder, and figures and tables are named after their labels in the paper:
  78. ```text
  79. <your papers folder>/
  80. └── NLP/ ← domain folder, reusing the ones you already have
  81. └── Attention_Is_All_You_Need/
  82. ├── Attention_Is_All_You_Need.en.md
  83. └── images/
  84. ├── figure_1.png
  85. └── table_2.png
  86. ```
  87. Each note opens with structured properties you can query and filter with Obsidian Bases, for example to list every benchmark paper you have read, or everything you read this month:
  88. ```yaml
  89. paper_type: benchmark_or_dataset
  90. methods: [...]
  91. datasets: [...]
  92. tasks: [...]
  93. read_date: 2026-11-08
  94. ```
  95. </details>
  96. ## 🧩 From Paper to Wiki
  97. DeepPaperNote reads each paper deeply and saves it well. The other three skills are optional companions that look after your vault as a whole.
  98. | Skill | What it does for you | How to call it |
  99. | --- | --- | --- |
  100. | [`deeppapernote`](./skills/deeppapernote/SKILL.md) | **Core.** Deep-reads one paper and saves an illustrated note into your vault, linked to the other papers you have read. | "Generate a deep-reading note for this paper: <paper>"<br>or `/deeppapernote` |
  101. | [`research-memory`](./skills/research-memory/README.md) | Keeps a research memory for you: it records the research directions you are working on and follows them as you read. With it, DeepPaperNote writes each note's Takeaways against your directions, so the next note knows you better. | "Build my research memory"<br>or `/research-memory` |
  102. | [`organize-wiki`](./skills/organize-wiki/README.md) | Organizes your vault: it sorts out the domain categories, moves papers filed under the wrong domain, and fixes their domain tags. The categories it settles become what DeepPaperNote follows when it files new papers. | "Organize my paper library"<br>or `/organize-wiki` |
  103. | [`paper-glossary`](./skills/paper-glossary/README.md) | Builds a glossary for your vault: it turns a paper's key concepts into reusable term notes and links them back into the paper's text. The same term in different papers points to the same term note. | "Build glossary notes for this paper"<br>or `/paper-glossary` |
  104. A good rhythm: read a few papers with DeepPaperNote first; once your vault has some notes, build a research memory; when the papers pile up and the categories start to drift, organize the vault.
  105. ## ✅ Notes You Can Trust
  106. - **A deep read, not a summary.** Every note answers all the core questions of its paper type, and states plainly where the paper does not report something.
  107. - **Grounded in the paper.** Conclusions and numbers in the note come from the paper itself, with nothing invented or guessed.
  108. - **No full text, no note.** If only the abstract is available, it stops and asks you for the paper instead of handing over a note that only looks complete.
  109. - **Every figure is checked.** Each figure and table is visually reviewed before it enters the note; a crop that is incomplete or does not match the text stays out.
  110. - **A final check before saving.** An independent review checks the note for errors and omissions, and the note is fixed before it is saved.
  111. - **Your existing notes are safe.** An existing note is never silently overwritten, and regenerating a note keeps its My Notes section exactly as it is.
  112. **More than words:** we run regression tests on 34 real papers covering all 10 paper types, and in a blind evaluation on 6 sample papers with our internal rubric, the average score rose from 73.6 to 84.2 (out of 100) after the type-specific redesign.
  113. ## 🔧 Optional Enhancements
  114. DeepPaperNote reads ordinary digital PDFs without any of these. Add them as you need:
  115. | Enhancement | What it does for you | How to turn it on |
  116. | --- | --- | --- |
  117. | **[DeepPaperNote Connector](https://github.com/917Dhj/DeepPaperNote-Connector)** | Saves a paper from your browser into your Obsidian paper library in one click, so its note can later be written in the same folder | Install the browser extension; it currently supports Chrome on macOS |
  118. | **Zotero** | Uses the item and PDF already in your Zotero library, with no searching or downloading again | In Zotero 7, open Settings → Advanced and check "Allow other applications on this computer to communicate with Zotero"; it is used automatically from then on |
  119. | **Semantic Scholar API key** | Finds the right title, authors, and venue even for papers that are hard to identify | Set the environment variable `SEMANTIC_SCHOLAR_API_KEY` |
  120. | **OCR** | Recovers the text of scanned or poor-quality PDFs | Install Tesseract and `pytesseract` |
  121. For any of these, you can also ask your agent to check your environment and set it up for you.
  122. ## 🛠️ Troubleshooting
  123. When something goes wrong, the easiest fix is to ask your agent:
  124. - **Installed, but it does not work**: say "Check DeepPaperNote's environment." It tells you what is missing, covering Python and PyMuPDF, your Obsidian settings, and optional enhancements such as Zotero and OCR.
  125. - **A note stopped partway or was not saved**: say "Where did this DeepPaperNote run stop?" It tells you where it got stuck, what is missing, and what to do next.
  126. Intermediate files are kept under `~/.deeppapernote/runs/`, one directory per paper, and are not cleaned up automatically. Delete them by hand if they take up too much space.
  127. If that does not solve it, please [open an issue](https://github.com/917Dhj/DeepPaperNote/issues).
  128. ## 🧭 Inspirations
  129. DeepPaperNote was influenced by projects that take paper reading, evidence extraction, and note generation seriously, especially:
  130. - [heleninsights-dot/phd-deepread-workflow](https://github.com/heleninsights-dot/phd-deepread-workflow)
  131. - [juliye2025/evil-read-arxiv](https://github.com/juliye2025/evil-read-arxiv)
  132. - [HKUSTDial/Supervisor-Skills](https://github.com/HKUSTDial/Supervisor-Skills)
  133. ## 🤝 Contributing
  134. Pull requests should target `develop`, not `main`. Before submitting, run the tests and lint locally:
  135. ```bash
  136. python3 -m pip install -e '.[dev]'
  137. python3 -m pytest -q -n auto
  138. python3 -m ruff check skills tests
  139. ```
  140. The workflow is defined in [`skills/deeppapernote/SKILL.md`](./skills/deeppapernote/SKILL.md). Changes that may affect note quality should be evaluated with [`evals/regression-workflow.md`](./evals/regression-workflow.md) and [`evals/note-quality-rubric.md`](./evals/note-quality-rubric.md).
  141. ## Star History
  142. [![Star History Chart](./assets/star-history.svg)](https://www.star-history.com/?repos=917Dhj%2FDeepPaperNote&type=date&legend=top-left)
  143. <p align="center">
  144. <em>Thanks for reading, using, and supporting DeepPaperNote. May your paper-reading days be a little clearer, calmer, and more rewarding.</em>
  145. </p>
  146. <p align="center">
  147. <a href="./LICENSE">MIT License</a> &copy; <a href="https://github.com/917Dhj">917Dhj</a>
  148. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.