# Deeppapernote

Generate a high-quality deep-reading note for a single paper and write it into an...

- Repository: https://github.com/917Dhj/DeepPaperNote (1279 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add 917Dhj/DeepPaperNote --skill deeppapernote -g -a claude-code -y`
Codex: `npx skills add 917Dhj/DeepPaperNote --skill deeppapernote -g -a codex -y`
Cursor: `npx skills add 917Dhj/DeepPaperNote --skill deeppapernote -g -a cursor -y`
Gemini CLI: `npx skills add 917Dhj/DeepPaperNote --skill deeppapernote -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add 917Dhj/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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

Chinese trigger examples:
- `给这篇论文生成深度笔记`
- `写一篇高质量论文精读笔记`
- `把这篇文章整理成 obsidian 笔记`
- `读这篇论文并生成 md 笔记`

English trigger examples:
- `Generate a deep-reading note for this paper`
- `Turn this paper into an Obsidian research note`

## User Configuration

Before a normal paper run, read `references/user-configuration.md` for configuration admission, migration, repair, Run Overrides, and Preference Changes.

Resolve Run Overrides from the explicit request, CLI, and current process environment first. When they form a complete valid configuration for the selected Save Mode, Configuration Readiness is complete without reading User Configuration. Only inspect User Configuration when those Run Overrides need fallback values.

## Language Integrity Contract

After Configuration Readiness, resolve one `output_language` (`zh-CN` or `en`) for the run. `source_manifest.language_hint` describes source text only and never selects the note profile.

Bind that exact value through Save Target Admission → Figure Plan → Figure/Table Decisions → Synthesis Bundle → Note Plan → Grounding Lint → Final Note Lint → Final Quality Review → Final Readability Review → Formal Save:

The rest: https://github.com/917Dhj/DeepPaperNote/blob/HEAD/skills/deeppapernote/SKILL.md