Agent skill

Ljg Paper

by lijigang in lijigang/ljg-skills

Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish.

MITAuto-check passedResearch & Science

Install Ljg Paper

skills CLI
$ npx skills add lijigang/ljg-skills --skill ljg-paper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lijigang/ljg-skills ljg-paper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lijigang/ljg-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ljg-paper .claude/skills/ljg-paper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ljg-paper
GitHub stars
7.5k
Token cost
~798 tokens
SKILL.md length
88 words
Files
9 (incl. scripts, references)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish.

  • The user shares an arXiv link
  • SKILL.md covers Workflow Routing, 解读要达到的三个目标, 容易出错的地方 and 示例, plus 1 more section
  • Runs TypeScript scripts from its folder; calls bun
  • Understand a paper

What it does

Ljg Paper is an agent skill from lijigang/ljg-skills. Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish. USE WHEN the user shares an arXiv link, paper URL, PDF, local paper, or paper title, or asks to read, explain, analyze, or understand a paper. Defaults to a saved Org note. NOT FOR reproduction, formal peer review, benchmark tables, or literature surveys.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `ReadingGuide.md`, `evals/evals.json` and `evals/plain-language-pair.json`).

It sits in Research & Science, covering Academic paper search and Query optimization. It works with arXiv. The licence is MIT.

When your agent uses it

  • The user shares an arXiv link
  • Understand a paper

Example prompts

  • “/ljg-paper”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 9e75497. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ljg Paper loads about 798 tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 88 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~798
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from lijigang/ljg-skills at commit 9e75497, republished under its MIT licence (© lijigang). 88 words, ~798 tokens.

Download SKILL.mdSave it as .claude/skills/ljg-paper/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
ljg-paper
description
Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish. USE WHEN the user shares an arXiv link, paper URL, PDF, local paper, or paper title, or asks to read, explain, analyze, or understand a paper. Defaults to a saved Org note. NOT FOR reproduction, formal peer review, benchmark tables, or literature surveys.

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

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

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

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

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

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

Workflow Routing

输入必读材料输出
arXiv、PDF、论文链接、本地论文ReadingGuide.md、references/template.org、references/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 指出需要回读、补背景或自行补画面的地方;有图时核对图意,不能只凭能复述就判易读。

示例

方法论文: 用一个小任务说明旧做法卡在哪里,再解释新方法如何处理输入、经过哪些关键步骤、得到什么结果。中心实验说明比较条件与动作差异,结尾交代改善发生在哪一步,以及哪些情况仍未验证。

评测论文: 两个系统在旧指标上表现相近,新评测发现了原先没有区分的差异。解释新评测测量什么、代表性对照显示了什么,以及这些差异能支持哪些判断。不要把测量结果直接写成现实中的因果结论。

保存与检查

具体写法见 ReadingGuide.md。正文使用 references/template.org,研究与取舍记录使用 references/paper-map.md。新记录使用格式版本 3;验证脚本兼容旧版本 1、2,旧记录不必为了本次升级批量改写。

写入后运行:

sh
bun {skill_dir}/scripts/validate_note.ts /absolute/path/to/note.org \
  --map /absolute/path/to/paper-map.md

用真实 Emacs 读回 identifier、文件名、目录索引、consult-notes 与 org-lint。再按指南完成独立阅读检查,记录全文复述、研究问题与贡献、认识变化、结果解释四项结果。全部通过后重新运行脚本,确认最终文件与检查记录一致。

验证脚本接受尚未填写阅读检查结果的记录用于诊断,但会返回失败;不能先写 PASS 再请人检查。验证器或独立评估不可用时,明确报告哪项尚未完成。

© lijigang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (scripts, references) in skills/ljg-paper of lijigang/ljg-skills.

  • SKILL.md
  • ReadingGuide.md
  • evals/evals.json
  • evals/plain-language-pair.json
  • references/paper-map.md
  • references/template.org
  • scripts/paper_map_compat.ts
  • scripts/validate_note.test.ts
  • scripts/validate_note.ts

Open the folder on GitHubat commit 9e75497

Compare with similar skills

Ljg Paper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ljg Paper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ljg Paper this skilllijigang/ljg-skills7.5k—~798Automated safety check: PassMIT
Paper Interpretationdigoal/blog8.6k—~1.5kAutomated safety check: PassGPL-2.0
Read arXiv Paperkarpathy/nanochat59k1 repos~494Automated safety check: PassMIT
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Openalex Databaseneflibata-feng/MyArxiv-Agent12612 repos~3kAutomated safety check: PassCustom licence
Citation ManagementK-Dense-AI/claude-scientific-writer2.4k2 repos~3.9kAutomated safety check: NotesMIT

Similar skills

  • 从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…

    8.6k GitHub stars~1.5k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    59k GitHub starsUsed in 1 repo~494 tokens
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 12 repos~3k tokens
    Research & ScienceAuto-check passed
  • Citation Management

    K-Dense-AI/claude-scientific-writer

    Finds papers in OpenAlex, PubMed and Google Scholar, turns DOIs, PMIDs and arXiv IDs into clean BibTeX, and validates citations for a manuscript or thesis.

    2.4k GitHub starsUsed in 2 repos~3.9k tokens
    Research & ScienceAuto-check: notes
  • Citation Management

    neflibata-feng/MyArxiv-Agent

    Comprehensive citation management for academic research. An agent skill from neflibata-feng/MyArxiv-Agent.

    126 GitHub starsUsed in 19 repos~8.1k tokens
    Research & ScienceAuto-check: notes

More from lijigang/ljg-skills

All 26 skills in this repo
  • Whole-Book Explainer Notes

    lijigang/ljg-skills

    Explains a whole book to someone who has not read it, keeping its specific content and showing how its threads connect, and saves the result as an Org note.

    7.5k GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Text to PNG Card Caster

    lijigang/ljg-skills

    Turns text, URLs or local files into tall PNG cards through HTML typography, with four modes: long reading card, full-text layout, comic and whiteboard.

    7.5k GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed
  • Turns a named classical Chinese chapter, such as one from the Tao Te Ching or the Analects, into a single annotated PNG image with notes and commentary.

    7.5k GitHub stars~551 tokensUpdated 2 days ago
    Auto-check passed
  • Constraint Engine

    lijigang/ljg-skills

    Finds the handful of constraints that truly define a domain, role, product or debate, grades each by hardness, and explains the behavior those constraints produce.

    7.5k GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed
  • Offline HTML Talk Decks

    lijigang/ljg-skills

    Builds single-file offline HTML talk decks from Org or Markdown outlines, with faithful layout or editorial condensing and keyboard navigation.

    7.5k GitHub stars~506 tokensUpdated 2 days ago
    Auto-check passed
  • Turns an article, paper or book into a directed chain of sharp questions and four-part answers that retraces the author's reasoning, saved as an org-mode note.

    7.5k GitHub stars~590 tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Ljg Paper

What does Ljg Paper do?

Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish. Ljg Paper is an agent skill from lijigang/ljg-skills. Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish.

When should I use Ljg Paper?

Ljg Paper fits situations like: the user shares an arXiv link; understand a paper.

How do I install Ljg Paper in Claude Code?

Run `npx skills add lijigang/ljg-skills --skill ljg-paper -a claude-code`. Or copy the skill folder (skills/ljg-paper in lijigang/ljg-skills) into .claude/skills/ljg-paper in your project. Claude Code loads it when a task matches its description.

How do I install Ljg Paper in Codex?

Run `npx skills add lijigang/ljg-skills --skill ljg-paper -a codex`. Or copy the skill folder (skills/ljg-paper in lijigang/ljg-skills) into .agents/skills/ljg-paper in your project. Codex loads it when a task matches its description.

Can I use Ljg Paper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lijigang/ljg-skills --skill ljg-paper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ljg-paper, .gemini/skills/ljg-paper, .github/skills/ljg-paper and .opencode/skills/ljg-paper in your project.

What does Ljg Paper need to run?

Going by SKILL.md and its folder, Ljg Paper needs TypeScript for the scripts in its folder and the command-line tools its instructions call (bun). Our summary lists: Node.js.

Does Ljg Paper access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ljg Paper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ljg Paper use?

Ljg Paper is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ljg Paper use?

About 798 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.8k tokens, read only when the agent opens those files.

What are the alternatives to Ljg Paper?

Skills that share tags, products or a category with Ljg Paper: Paper Interpretation (digoal/blog, 8.6k stars), Read arXiv Paper (karpathy/nanochat, 59k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars) and Openalex Database (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ljg Paper?

lijigang (a GitHub user) maintains it in lijigang/ljg-skills, which has 7,481 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 8, 2026.

Source: lijigang/ljg-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.