ZJU-REAL/Easel / skills/builtin/paper-explainer
paper-explainer
Verified科研论文解读:解析 arXiv/PDF 的公式与图表,提炼问题、贡献、方法、关键图和结论,再产出 B站/视频号解读视频或知乎/公众号图文。 当用户说“论文解读、讲论文、论文转视频/图文、科研科普、arXiv、学术视频”时使用。 本 SKILL 从论文做内容;video-to-article 从视频做图文,doc-convert 只转换文档格式。
| File | Kind | Size |
|---|---|---|
| EASEL-META.md | markdown | 2.1 KB |
| SKILL.md | skill md | 9.8 KB |
| references/explain-methodology.md | markdown | 3.2 KB |
| references/paper-distill-schema.md | markdown | 2.7 KB |
| references/platform-adapt.md | markdown | 2.3 KB |
| references/slide-design.md | markdown | 11.5 KB |
| references/slide-plan.example.json | config | 2.9 KB |
| references/slide-plan.style-transfer.example.json | config | 1.8 KB |
| references/video-storyboard.md | markdown | 3.1 KB |
| scripts/paper_ingest.py | script | 19.1 KB |
| scripts/render_slides.py | script | 48.5 KB |
references/explain-methodology.md
View on GitHub# 论文通俗化方法论(把公式/图表讲成人话)
> 论文解读能不能火,取决于**「让外行看懂、让内行觉得清楚」**。核心是降门槛不降准确度。
## 一、开场钩子(前 10 秒/前两句)
论文本身没有钩子,你要造一个。手法:
- **切身相关**:把论文和观众的生活/工作接上("你每天用的 XX,背后就是这篇论文的思路")。
- **反差/反直觉**:点出违反常识的结论("越大的模型反而在这件事上更笨")。
- **悬念/数字冲击**:抛一个惊人结果或问题("他们只用 1% 的算力做到了 SOTA,怎么做的?")。
- **忌**:一上来念标题作者机构、罗列一堆术语。
## 二、讲清「问题」比讲清「方法」更重要
- 观众先要知道**为什么该关心**,才会听方法。花足够篇幅讲 problem 和 prior_gap(以前的方法差在哪)。
- 用「痛点故事」而非定义:不说"本文研究 XX 优化问题",说"以前要做这件事得花三天,而且经常出错"。
## 三、公式 → 人话
- **不念公式**:绝大多数观众看到公式就划走。讲**公式在干什么**,不讲符号。
- 反例:读"L 等于 sigma 求和 ..."。正例:"这个式子就是在惩罚模型犯的每一个错,错得越离谱罚得越狠。"
- **保留一个直觉**:一篇论文最多留 1 个"关键的聪明点",用一句话点破它为什么 work。
- 同行向内容可保留关键公式,但仍要配一句直觉解释。
## 四、图表 → 人话
- **先说图在回答什么问题**,再说结论,最后才(可选)说怎么读轴。
- "这张图想说明我们的方法更快——横轴是数据量,纵轴是耗时,蓝线(我们)一直压在红线下面。"
- **重绘优先**:论文原图常密、小、不适合竖/横屏。关键图用 infographic/chart-visualization **重绘成简洁大字版**,只保留要传达的那一个结论。
- 一张图只讲一个点;要讲两个点就拆成两张。
## 五、类比法(降门槛的利器)
- 用观众熟悉的日常事物类比抽象方法(注意力机制→"开会时你只重点听和你相关的发言")。
- **类比三原则**:贴切(映射到核心机制)、不失真(别为了好懂扭曲原意)、点到为止(类比完拉回真实概念)。
- 类比写进 asset-library 的 `method.analogy`,视频/图文复用。
## 六、术语处理
- **最小化**:能用人话就不用术语。
- **必用则即时解释**:首次出现的术语,紧跟一句通俗解释(进 asset-library `terms`)。
- 不要制造"术语墙"——连续三个没解释的术语,外行就走了。
## 七、结构上的诚实
- **别夸大**:论文的局限、适用范围要提(`limitations`)。夸大结论会被同行打脸,损号。
- **区分「论文说的」和「我的解读」**:延伸观点要标明是你的推测,不是论文结论。
- **数字要准**:引用提升幅度/对比对象时对齐原文,别记错。
## 八、收尾(takeaway)
- 落到 so-what:这项工作对领域/对观众意味着什么、可能带来什么改变。
- 视频结尾给行动/思考钩子("如果这条路走通,未来 XX 可能会……你觉得呢?")引互动。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |