DeepPaperNote
A skill that deep-reads a single paper and builds a structured Obsidian-style research note
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
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/deeppapernoteDetects 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 -yThe 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/deeppapernoteCommands 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 -yThe 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/deeppapernoteCommands 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 -yThe 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/deeppapernoteCommands 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 -yThe 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/deeppapernoteCommands 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 -yThe 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/deeppapernoteCommands 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/deeppapernoteCommands 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 -yThe 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/deeppapernoteCommands 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 -yThe 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/deeppapernoteCommands 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 -yThe 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/deeppapernoteCommands 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/deeppapernoteCommands 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/deeppapernoteCommands for macOS and Linux, on Windows run them in Git Bash.
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/DeepPaperNoteThe 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 vaultLimitations
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.
Related
Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
Anthropic skills
Skills
Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec
A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations
A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types