
Ljg Paper
Turn intimidating ML/AI papers into Org-mode narrative notes non-academics can actually use for decisions and side projects.
Overview
ljg-paper is a journey-wide agent skill that turns AI/ML papers into structured Org-mode story notes for non-academic solo builders—usable whenever you need research translated before committing to build or content bets.
Install
npx skills add https://github.com/lijigang/ljg-skills --skill ljg-paperWhat is this skill?
- Fixed Org-mode skeleton: 问题 → 翻译 → 核心概念 → 洞见 → 博导审稿 → 启发
- 6-section narrative arc with one concrete example threaded through 问题 and 翻译
- Title rule: 6–15 character Chinese 思想骨句 with zero mixed EN/CN in the headline slot
- 博导审稿 block with explicit accept/reject verdict labels (strong accept through strong reject)
- Overview diagram slot via #+ATTR_ORG image link tied to paper identifier
- 6 major Org-mode sections in the narrative template
- 3 core concepts required in the 核心概念 section
- 6–15 character Chinese title rule for 思想骨句
Adoption & trust: 3.7k installs on skills.sh; 5.5k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You found a paper that might change your product bet but wall-of-text PDFs and jargon leave you without a decision-ready mental model.
Who is it for?
Indie builders and agent users who read English papers but want Chinese, example-driven synthesis tied to Org-mode and Zettel-style tags.
Skip if: Implementing code from papers, LaTeX bibliography management, or quick TL;DR bullets without the mandated six-section narrative.
When should I use this skill?
You need a non-academic, example-driven Org-mode synthesis of a research paper (frontmatter: Paper reader for non-academics).
What do I get? / Deliverables
You get a single Org-mode file with a threaded example, core concepts, advisor verdict, and personal 启发 you can file or link before scoping or writing.
- Tagged Org-mode paper note (#+filetags :paper:)
- Overview image placeholder path
- Advisor-style accept/reject verdict paragraph
Recommended Skills
Journey fit
Useful at every journey phase - explore requirements and options before committing to a direction.
Where it fits
Read a new RLHF paper with ljg-paper before picking a fine-tuning approach for your agent product.
Use the 博导审稿 verdict to decide whether a claimed benchmark justifies a two-week prototype.
Archive 核心概念 from a systems paper as internal onboarding notes for future-you when touching the codebase.
Mine the 洞见 and 启发 sections for a newsletter angle without re-reading the PDF.
Re-read 启发 when production metrics contradict an assumption you imported from last quarter’s paper stack.
How it compares
Structured paper storytelling template—not a citation manager or automated literature-review MCP.
Common Questions / FAQ
Who is ljg-paper for?
Non-academic solo builders who use agents to digest research papers into Org-mode notes they can revisit when scoping products or writing.
When should I use ljg-paper?
In Idea/research when exploring a field; in Validate when a paper should inform scope; in Grow when turning papers into content; anytime you need a rigorous narrative read before coding.
Is ljg-paper safe to install?
Review the Security Audits panel on this Prism page; the skill is prose/template only and does not require network by itself unless your agent fetches the paper URL you supply.
SKILL.md
READMESKILL.md - Ljg Paper
#+title: {6-15 字思想骨句——故事内核句,凝练如警句/篇名,零中英混杂;详见 SKILL.md「title 这一句怎么写」} #+subtitle: {论文原始标题,通常英文} #+date: [{YYYY-MM-DD Day HH:MM}] #+filetags: :paper: #+identifier: {YYYYMMDDTHHMMSS} #+source: {URL 或来源描述} #+authors: {作者列表} #+venue: {发表场所/年份} * 问题 {搭台。一个具象示例——主角是谁、面前撞着什么——把读者拉到困境现场。一两句话说完。} {三拍叙事,同一例子贯穿:(1) 亲历困境——主角 + 困境 (2) 旧路撞墙——前作在这例子上为什么走不通 (3) 转折预告——本论文作者看到了别人没看到的入口,只引方向不展开机制。} {末句给「翻译」节开口子——让读者已经隐约知道转折在哪里。} {无明显前作时跳过 (2),直接「亲历→转折预告」。} * 翻译 #+ATTR_ORG: :width 1200 [[file:images/{identifier}--paper-{简短标题}-overview.png]] {推进。不重述问题。沿用「问题」里那个具象例子,在它上面一步步打开论文的方法。} {开头立锚点——锚点是方法在那个例子上的样子(比如"在那个图灵奖问题上,方法像分诊台")。} {一步步揭开,让读者解锁迷雾。揭秘动词:"这时候你看……""于是发生了……""那这一步怎么办呢——他们想到……"——前一段说的事打开后一段的口子。} {覆盖(都在那个例子上):转折是什么、解法怎么动、结局长什么样(两三组数字)、理解全文的钥匙概念。子标题按内容需要组织。} {豁免:仅当机制细节同一例子撑不住时,引入"子例子"作为放大镜——保持父例子的问题域,不换地图。} {末句给「核心概念」开口子——让读者已经感觉到有几件道具在动。} * 核心概念 {故事道具。挑 3 个主角手里那几件不可少的东西——少了任一件,这故事就讲不通。逐个拆解,每个都回到「问题」那个例子上落地。} {每个道具:一句话说清是什么、在那个例子上长什么样(少了它在例子上会怎样)、为什么少了它就跟不上后面的内容。读者每解锁一个,迷雾就散一片,对例子的理解再深一层。} {末句给「洞见」开口子——读者已经准备好接故事的内核。} * 洞见 {内核。一句话:这个故事真正留下的那颗东西。} {脱离论文上下文,这句话本身还有没有力量?不要复述结论,要提炼听众走出门带走的那一句。没有就直说没有。} * 博导审稿 {故事评审。像带了二十年研究生的博导在办公室跟学生聊——这个故事讲得真不真、值不值得认真对待。} {选题眼光(困境真不真)、方法成熟度(找未被讨论的根本预设)、实验诚意(结局数字经不经得起追问)、写作功力。} {判决:strong accept / weak accept / borderline / weak reject / strong reject,一句话理由。} * 启发 {听众的故事。这个故事接到我的生活里——迁移 / 混搭 / 反转 三个视角试探,命中展开,全没命中说「没有」。落点在"你可以___",不在"值得思考___"。} --- name: ljg-paper description: "Paper reader for non-academics. Reads a paper and tells it back as one continuous story to someone who doesn't know the field — built on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核). The job is storytelling that makes the paper land, not academic critique. Use when user shares an arxiv link, paper URL, PDF, or asks to analyze a research paper. Trigger words: '读论文', '讲论文', '把这篇讲给我听', '分析论文', 'paper', or when user shares an academic paper." user_invocable: true version: "5.0.0" --- # ljg-paper: 把一篇论文当一个故事讲 读一篇论文,最难的不是看懂,是讲明白。讲给一个不懂这个领域的聪明人——讲到他能复述出来——你才算读完。 这是一个讲故事的活。一篇论文背后,有主角、有困境、有撞墙、有转折、有解法、有结局、有内核。把这副脊柱先立起来,再往上挂内容;不然写出来就是八份独立汇报拼成的合订本,读者翻两页就走神。 ## 总目标(先看这个) 让一个**不懂这个领域的聪明人**听完,能把这篇论文当一个故事再讲一遍——讲出: 1. 主角面前那个困境(具体到一个例子) 2. 作者怎么转过那个弯(机制 + 设计选择的理由) 3. 解出来世界变了什么样(含最反直觉的副发现——往往是这故事最有意思的那拍) 4. 听众走出门带走的那颗内核 任一拍让听众卡住 = 故事讲砸了。**凝练只在 title 上追求;正文该展开就展开**——目标不是短,是让人从听不懂走到能复述。 ## 故事骨架 把论文讲成故事,脊柱是这七拍。不是七个子标题,是节奏要求: 1. *主角* — 谁在这个故事里?这个领域的研究者、一个具体的模型、一个用户、一个系统、甚至论文要回答的那个问题本身。开场两句先把主角领上台。 2. *困境* — 主角面前撞着什么?解不了会怎样?把"利害"摆给读者——读者要看见值得为这件事坐下来听完。 3. *旧路* — 前人怎么试的?为什么没走通?让读者亲眼看一遍那堵墙。开创性问题没有前作,这一拍可以省。 4. *转折* — 作者看到了别人没看到的什么?整篇论文的"啊哈"在这一拍发生。这是故事的腰,整副脊柱靠它撑住。 5. *解法* — 带着新视角,主角怎么动手?机制、设计选择的理由——一步步把方法在那个例子上铺开,让读者跟着推。 6. *结局* — 解完了,世界长什么样?挑两三组最说明问题的数字让读者感受到差距。最反直觉的副发现单独留一拍呈现。 7. *内核* — 这个故事真正留下的那颗东西。不是论文结论的复述,是听众走出门带走的那一句话。 执行 9 步对应到故事弧上: | 故事拍 | 在执行哪一步 | |---------------------|--------------------| | 主角 + 困境 + 旧路 | 「问题」整段 | | 转折预告 → 转折登场 | 「问题」收尾 → 「翻译」开头 | | 解法 + 结局 | 「翻译」主体 | | 故事道具 | 「核心概念」 | | 内核 | 「洞见」 | | 故事评审 | 「博导审稿」 | | 听众的故事 | 「启发」 | **写完默读:这读起来像一个人在跟我讲一个故事,还是九段独立汇报?后者 → 重写。** ### 七拍落在一篇论文上长什么样 拿 LenVM(让模型一边写一边知道还要写多远)举例: - *主角*:一个写长答案的语言模型——它在写 GSM8K 的解题过程 - *困境*:模型不知道什么时候该收尾,结果要么没说完就停,要么啰嗦到 token 烧光 - *旧路*:之前的做法是直接训长度限制,硬卡;可一卡,推理质量就掉 - *转折*:作者看到——长度本来就是一种"剩余距离",可以建一个 value 头实时预测,让模型每写一字都知道还差多远 - *解法*:在 RL 训练里加一个 length value head,用 -1 constant reward 让它学到"少写一字省一字" - *结局*:在多个 benchmark 上推理长度降 30%,准确率不降反升;token 词云里 "wait/think" 让位给 "finalize/confirm" - *内核*:监督模型"知道止",比监督它"会答"更值 写出来不是七个段落,是一条线——把这七拍藏在「问题→翻译→核心概念→洞见」的连续叙述里,读者只感受到一个故事在走。 ## 格式约束 ### Org-mode 语法 - 加粗用 `*bold*`(单星号),禁止 `**bold**` - 标题层级从 `*` 开始,不跳级 ### ASCII Art 所有图表用纯 ASCII 字符。允许:`+ - | / \ > < v ^ * = ~ . : # [ ] ( ) _ , ; ! ' "` 和空格。禁止 Unicode 绘图符号。 ### 模板权威性 输出结构依据 `references/template.org`。禁止参考 `~/Documents/notes/` 中已有论文文件的章节结构——旧文件可能使用过期模板。 ##