literature-reader

literature-reader is a skill for Claude Code from wpsnote/wpsnote-skills. It costs 174 tokens per session (1,627 once invoked), scanned A, original, MIT.

A document-reading skill for analysing PDF research papers in English or Chinese and producing structured notes. It can identify a paper’s metadata, research question, methods, results, and an assessment.

In plain words
What is it for?
Use it to read one or more PDF papers, summarise or review them, make research notes, analyse methods and results, or compare studies.
Why use it?
It removes the need to manually organise findings while reading papers. It also helps compare several papers in a literature review, which is a structured summary of existing research.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/me/papers/attention.pdf」.

Part of the content-skills plugin — 10 skills shipped together

Good fit Use it to read one or more PDF papers, summarise or review them, make research notes, analyse methods and results, or compare studies.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add wpsnote/wpsnote-skills
Claude Code
/plugin install content-skills

Made for: Claude Code.

Or install content-skills, the plugin that ships this one along with the rest of its 10 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for literature-reader

README.md
[![agentmods](https://agentmods.dev/badge/skills/wpsnote/wpsnote-skills/literature-reader/github.svg)](https://agentmods.dev/skills/wpsnote/wpsnote-skills/literature-reader)
Your own site
<a href="https://agentmods.dev/skills/wpsnote/wpsnote-skills/literature-reader"><img src="https://agentmods.dev/badge/skills/wpsnote/wpsnote-skills/literature-reader/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for literature-reader

Your own site · 80×15
<a href="https://agentmods.dev/skills/wpsnote/wpsnote-skills/literature-reader"><img src="https://agentmods.dev/badge/skills/wpsnote/wpsnote-skills/literature-reader.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 174 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,627 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00174 $0.01627
Opus 5.5 $0.00070 $0.00651
Sonnet 5.5 $0.00035 $0.00325
Haiku 4.5 $0.00017 $0.00163

Measured 1mo ago against content hash 871af3c7682d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

literature-reader scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/extract_pdf.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/literature-reader/SKILL.md · 143 lines

How it starts

The opening of the file, as written. The whole thing — 143 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Literature Reader — 文献阅读与概要生成

指令

Step 1: 获取 PDF 内容

首选方式: 使用 Cursor 内置 Read 工具直接读取 PDF 文件。

Read tool → path: "/path/to/paper.pdf"

Read 工具会自动将 PDF 转换为文本。如果 PDF 过大被截断,分段读取:

Read tool → path: "/path/to/paper.pdf", offset: 1, limit: 200
Read tool → path: "/path/to/paper.pdf", offset: 201, limit: 200

备选方式: 若 Read 工具无法读取 PDF(返回空内容、乱码、严重截断),或遇到扫描件、复杂排版等情况,请查阅 PDF 文本提取指南 使用备选提取脚本。

快速使用:

pip3 install pdfplumber  # 首次使用需安装
python3 ~/.cursor/skills/literature-reader/scripts/extract_pdf.py "/path/to/paper.pdf" --output /tmp/paper_text.txt

预期输出:终端显示 Extracted text saved to: /tmp/paper_text.txt,随后用 Read 工具读取该文件。完整参数说明、判断标准和故障排查见 references/pdf-extract.md。

Step 2: 内容分析

按以下维度逐一分析提取到的文本:

  1. 元信息提取 — 标题、作者、机构、发表年份、期刊/会议
  2. 研究问题识别 — 论文试图回答什么问题,解决什么痛点
  3. 方法论梳理 — 使用了什么研究方法、技术路线、实验设计
  4. 核心贡献归纳 — 论文的主要创新点和学术贡献(通常在 Introduction 末尾或 Abstract 中明确列出)
  5. 实验与结果 — 关键实验设置、数据集、指标、定量结果
  6. 局限性与未来方向 — 作者承认的不足、提出的后续工作

Step 3: 生成文献概要

使用模板生成结构化输出。模板见 summary-template.md。

输出格式为 Markdown 文件,文件名建议:[第一作者姓氏]_[年份]_[关键词缩写].md

Step 4: 质量检查

生成概要后进行自查:

  • 元信息(标题、作者、年份)是否准确
  • 研究问题是否清晰表述
  • 方法描述是否抓住了核心技术路线而非细枝末节
  • 核心贡献是否与论文 Abstract/Introduction 一致
  • 关键数据和结论是否有具体数值支撑
  • 个人评价是否客观且有理有据

特殊场景处理

批量文献阅读

当用户提供多篇论文时:

  1. 逐篇按上述流程处理
  2. 在最后额外输出一份 横向对比表,包含:标题、年份、方法、数据集、核心指标、主要贡献
  3. 简要说明各论文之间的关系(互补/竞争/递进)

横向对比表模板见 summary-template.md 底部。

特定章节深读

当用户只关心论文某一部分(如方法论、实验结果)时:

  1. 仅展开该部分的详细分析
  2. 其余部分保持一句话概述
  3. 对关键公式、算法伪代码进行解读

中文论文

中文论文使用中文输出概要。对中文论文中引用的英文术语,保留原文并在括号内标注,如:注意力机制(Attention Mechanism)。

输出规范

  • 文献概要长度:1000–2000 字(视论文复杂度调整)
  • 语言:与论文语言一致,或遵从用户指定语言
  • 格式:Markdown,使用清晰的层级标题
  • 关键术语首次出现时标注英文原文
  • 数据和结论必须标注出处章节(如 "见 Table 3" "Section 4.2")

示例

示例 1:单篇论文精读

用户说:「帮我读一下这篇论文 /Users/me/papers/attention.pdf」 操作:

  1. 使用 Read 工具读取 PDF 内容
  2. 按 Step 2 维度逐一分析
  3. 按模板生成完整文献概要 结果:输出结构化的 Markdown 概要文件

Read the full file on GitHub · 143 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 143 lines · 174 tokens per session scan A 871af3c7682d

Subscribe to this mod's changes

literature-reader is a skill published in the GitHub repository wpsnote/wpsnote-skills (183 stars, last pushed yesterday), licensed MIT. It adds 174 tokens to every session and 1,627 once invoked, about $0.0007 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories