DeepPaperNote

A skill that deep-reads a single paper and builds a structured Obsidian-style research note

Skill

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Reads local PDFs and fetches papers by link
  • Writes note files into the vault
All reasons and checks

917dhj/deeppapernote

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/deeppapernote

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .claude/skills
cp -R "$tmp/skills/deeppapernote" .claude/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .agents/skills
cp -R "$tmp/skills/deeppapernote" .agents/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .github/skills
cp -R "$tmp/skills/deeppapernote" .github/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .agents/skills
cp -R "$tmp/skills/deeppapernote" .agents/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .agents/skills
cp -R "$tmp/skills/deeppapernote" .agents/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .devin/skills
cp -R "$tmp/skills/deeppapernote" .devin/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Formerly Windsurf.

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .cline/skills
cp -R "$tmp/skills/deeppapernote" .cline/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .roo/skills
cp -R "$tmp/skills/deeppapernote" .roo/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add 917dhj/deeppapernote --skill deeppapernote -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 7989771
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .agents/skills
cp -R "$tmp/skills/deeppapernote" .agents/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .agents/skills
cp -R "$tmp/skills/deeppapernote" .agents/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/917dhj/deeppapernote.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/deeppapernote/
git -C "$tmp" checkout 79897719fba115e0289516240aef2b05347d0c45
mkdir -p .agents/skills
cp -R "$tmp/skills/deeppapernote" .agents/skills/deeppapernote

Commands for macOS and Linux, on Windows run them in Git Bash.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 7989771.

Text for your agent

Install the skill with npx skills add 917Dhj/DeepPaperNote and pick deeppapernote. Then add the PDF dependency: python3 -m pip install PyMuPDF.

Other ways from the author
npx skills add 917Dhj/DeepPaperNote

The installer asks which skills to add and to which agents.

This is third-party code. Review the repository files before installing.

What it does

The skill takes one paper by title, DOI, URL, arXiv ID, Zotero item or a local PDF and turns it into a detailed Markdown note. It breaks the work down by substance: the problem, the method, the evidence and the weak spots, and leaves placeholders for figures. The finished note is saved into the Obsidian vault chosen in the user configuration. A separate paper-glossary skill handles terms. It runs the same way in Claude Code and Codex.

Who it is for. For researchers, graduate students and analysts who keep a personal library of paper notes.

Good fit when

  • You want to carefully break down one paper into a ready note
  • You want to add a paper analysis to an Obsidian knowledge base
  • You want consistent formatting for paper summaries

Not a fit when

  • You need a survey of dozens of papers at once rather than a deep read of one
  • You do not want an Obsidian and Markdown workflow

Example request

Read this paper by its arXiv ID and build a deep note for my Obsidian vault

Limitations

Reading PDFs requires the PyMuPDF package in the same Python environment the skill uses. Note quality depends on the agent's model. The skill analyzes the paper but does not replace your own verification of its conclusions.

How to disable. Remove the deeppapernote skill from the agent's skills directory or disable the plugin via /plugin.

Security check

  • Reads local PDFs and fetches papers by link
  • Writes note files into the vault

README in short

The README presents a skill for reading exactly one paper at a time and stresses the questions that separate a careful analysis from a retelling. Installation goes through npx skills add with a choice of skills and agents, and PyMuPDF is installed for PDF parsing. The note is saved into an Obsidian vault per the user configuration, with an optional paper-glossary skill. MIT licensed.

SKILL.md

---
name: deeppapernote
description: Generate a high-quality deep-reading note for a single paper and write it into an Obsidian-style vault. Use when the user gives a paper title, DOI, URL, arXiv ID, Zotero item, or local PDF and wants a polished Markdown note with strong structure, evidence-based analysis, and figure placeholders.
---

# DeepPaperNote

Use this skill when the user wants one outcome:
- read one paper carefully
- generate a high-quality Markdown note
- save the note to the workspace or Obsidian target selected by resolved configuration

FAQ

Which agents does it work with?

The same skill targets Claude Code and Codex, and the installer can lay it out for other agents too.

Do I need both skills?

No. deeppapernote is enough; paper-glossary is optional for term work.

Official

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium riskNo VPN needed187.4KRepository stars
Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk178.8KRepository stars
Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk56.8KRepository stars
Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium riskNo VPN needed42.6KRepository stars
Foxx AIDeepPaperNote

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.