ljg-paper

ljg-paper is a skill for Claude Code from lijigang/ljg-skills. It costs 96 tokens per session (1,745 once invoked), scanned A, original, MIT.

A guide for understanding research papers, including papers on arXiv, a website where researchers share scientific manuscripts. It explains the research problem, what the authors built or contributed, the evidence, the mechanism, and where the conclusions stop applying.

In plain words
What is it for?
Use it to read a paper or PDF, identify the old gap and the authors’ contribution, rebuild the main experiment or process, and save the resulting guide in the specified notes format.
Why use it?
It turns a paper into an explanation that a non-specialist can follow and reconstruct, instead of only listing its results. It also prevents examples or numbers from replacing the paper’s central contribution and evidence limits.

Skill for Claude Code

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

Part of the ljg-skills plugin — 22 skills shipped together

Good fit Use it to read a paper or PDF, identify the old gap and the authors’ contribution, rebuild the main experiment or process, and save the resulting guide in the specified notes format.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/lijigang/ljg-skills/ljg-paper
About the project

ljg-skills is a collection of custom Codex skills for tasks such as learning, writing, reading, relationship analysis, image creation, and investment analysis. Codex users install selected skills or the whole collection through a skills command-line interface. The catalogue entries are the collection's individual skills, plugin, and instruction.

lijigang/ljg-skills · 7,340 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add lijigang/ljg-skills --skill ljg-paper
Clone the repo
git clone --depth 1 https://github.com/lijigang/ljg-skills

Made for: Claude Code.

Or install ljg-skills, the plugin that ships this one along with the rest of its 22 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 ljg-paper

README.md
[![agentmods](https://agentmods.dev/badge/skills/lijigang/ljg-skills/ljg-paper/github.svg)](https://agentmods.dev/skills/lijigang/ljg-skills/ljg-paper)
Your own site
<a href="https://agentmods.dev/skills/lijigang/ljg-skills/ljg-paper"><img src="https://agentmods.dev/badge/skills/lijigang/ljg-skills/ljg-paper/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 ljg-paper

Your own site · 80×15
<a href="https://agentmods.dev/skills/lijigang/ljg-skills/ljg-paper"><img src="https://agentmods.dev/badge/skills/lijigang/ljg-skills/ljg-paper.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 96 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,745 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. Third-party audits
  • Socket pass 5 May 2026
  • Snyk warn 5 May 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.00096 $0.01745
Opus 5 $0.00048 $0.00873
Sonnet 5 $0.00019 $0.00349
Haiku 4.5 $0.00010 $0.00175

Measured 3d ago against content hash 978f4d60c996, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

ljg-paper 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 3d ago.

The scan reads SKILL.md. This mod also ships 3 executable files (scripts/paper_map_compat.ts, scripts/validate_note.test.ts, scripts/validate_note.ts), 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/ljg-paper/SKILL.md · 68 lines

How it starts

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

ljg-paper:讲清论文,让读者理解结论是怎样得来的

默认读者有一般生活经验和理解能力,但不熟悉论文所属行业,也不知道该行业常用的对象、工具和工作方式。用户指定了读者背景时,以其指定为准。

从读者能够直接理解的事情出发,讲清谁在什么条件下做了什么、为什么遇到困难、作者改变了哪个环节,以及结果怎样变化。专业名称在有助于识别论文贡献时引入;读者在记住名称之前,应已理解它指向的事情。

读者最终既能用普通话解释论文的思想,也能说清作者实际研究了什么、做出了什么贡献。生活案例承担解释时,应明确对应论文中的角色与关系,并区分假想示例和真实实验。

全文应围绕清楚的问题展开,让读者跟着观察、疑问与检查理解研究怎样发生。具体对象和动作应持续承担解释;随着解释深入,可以更换案例或场景,但要交代它补充了什么。现场感来自与理解有关的细节,不靠虚构心理或夸大结论。

当关键关系需要读者在脑中自行拼装时,优先考虑 ASCII 图来呈现信息流向、前后状态或不同维度,再沿具体例子读图。是否用图、用几幅,由它能否减少理解负担决定,不固定故事或图数。

Workflow Routing

输入 必读材料 输出
arXiv、PDF、论文链接、本地论文 ReadingGuide.mdreferences/template.orgreferences/paper-map.md 一份 Org 解读笔记和一份 paper-map 研究记录
只有论文标题 找到可靠原文后,读同一组文件 Org 笔记和 paper-map
明确只要口头解释 ReadingGuide.md 直接解释,不保存文件;仍满足下面三个目标

Org 默认保存到 ~/Context/。文件名沿用 Denote:{YYYYMMDDTHHMMSS}--paper-{方法名或论文关键词}__paper.org;时间戳由 date +%Y%m%dT%H%M%S 生成。改写已有笔记时,保留原文件与 identifier,核对原文,不另建重复笔记。

解读要达到的三个目标

  • 说清论文做了什么。 读者能说出研究问题、作者的主要贡献、方法或关系如何起作用,以及关键证据的适用范围。读到前两节时,就应知道论文在研究什么、作者做了什么。论文中不可省略的研究问题也要有所交代。
  • 让读者理解为什么需要修正原有认识。 从具体问题出发,说明通常会怎样理解,再用论文证据展示这种理解哪里不够、作者补充了什么、判断因此发生了什么变化。变化可以是纠正,也可以是补充、区分或缩小适用范围,无须制造戏剧性的反转。
  • 让读者能够自己解释结果。 如果论文提出了能解释多个发现的机制,读者应能用它说明至少两个不同发现,并推想改变相关条件后会发生什么。区分论文验证过的结论与依据机制作出的预测。论文没有统一解释时,如实说明各项发现之间的关系和仍未解决的问题。

三个目标分别检查。讲得流畅、内容准确、能够解释结果,各有要求,不能相互替代。

容易出错的地方

  • 案例讲清了,论文仍可能没讲清。 读者说不出研究问题或主要贡献时,回到原文重新组织解释。只修句子无法补上缺失的内容。
  • 行业内的浅显说法,对外行仍可能陌生。 例子本身也要符合读者起点。把术语换成另一组行业词,或讲完例子立刻回到专业概述,都会让读者重新承担翻译的工作;应让具体动作继续解释后面的关系。
  • 不要强迫一个例子讲完整篇论文。 一个案例说明不了所有研究问题时,可以换例子,保持问题与解释的联系。
  • 贡献要说具体。 写出作者提出的方法、理论、评测、资源或系统具体增加了什么。评测发现差异,不等于已经解释差异的原因。
  • 重点突出,也要保留重要分支。 paper-map 记录每条必要研究主线及其证据;正文说明它们如何共同回答论文的问题,不能把整篇论文缩成一个中心实验。
  • 按信息作用取舍证据。 优先讲清最有代表性的结果。补充结果应提供不同信息、限制结论或解释例外;不按实验数量平均分配篇幅,也不强求全文只写一种结果。
  • 数字需要上下文。 交代实验在问什么、固定了什么、和谁比较,再说明结果改变了哪个判断。把数字拆成短段,或全部写成汉字,都不能代替解释。
  • 章节可以递进,也可以并列。 换序用于检查联系是否清楚。两个独立实验可以交换顺序,但应说明它们分别支持什么、为什么都需要。
  • 检查工具只能检查格式与记录。 它不能证明文章易懂。理解检查由未参与写作的新上下文完成,评估者只读最终笔记,并按 ReadingGuide.md 指出需要回读、补背景或自行补画面的地方;有图时核对图意,不能只凭能复述就判易读。

Read the full file on GitHub · 68 lines

Files

What ships with it

8 files 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. 3d ago Changed · -7 lines · -13 tokens per session 978f4d60c996
  2. 12d ago First seen · 75 lines · 109 tokens per session scan A 211173064552

Subscribe to this mod's changes

ljg-paper is a skill published in the GitHub repository lijigang/ljg-skills (7,340 stars, last pushed 3d ago), licensed MIT. It adds 96 tokens to every session and 1,745 once invoked, about $0.0005 per session on Opus 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

hr-onboarding

A new-hire onboarding plan as a single page — first week schedule, buddy + manager intro, learning track, equipment checklist, and "you're set when…" outcomes. Use when the brief mentions "onboarding", "new hire", "first week plan", or "入职".

nexu-io/open-design · 62 tokens

book-mirror

Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis. Each chapter is preserved in detail (The Chapter) and mirrored back to the reader's actual life (The Mirror) using brain context. The mirror observes and resonates — a friend pointing out parallels, NOT a consultant rearranging the reader's…

garrytan/gbrain · 138 tokens

miniapp

Build a tiny interactive HTML playground only when someone asks to see, play with, or step through a mechanism.

yc-software/qm · 25 tokens

eli5

Explain research, papers, or technical ideas in plain English with minimal jargon, concrete analogies, and clear takeaways. Use when the user says "ELI5 this", asks for a simple explanation of a paper or research result, wants jargon removed, or asks what something technically dense actually means.

companion-inc/feynman · 63 tokens

deck-course-module

A course or workshop slide template with persistent learning goals, teaching pages, multiple-choice self-tests, and a wrap-up.

nexu-io/html-anything · 25 tokens

master-yinguang

A reference-based assistant for questions about Yinguang and Pure Land Buddhism, a Buddhist tradition focused on faith, ethical living, and practice connected with rebirth in the Pure Land. It can answer in Yinguang’s historical teaching style.

xr843/Master-skill · 274 tokens