- name
SKILL.md
स्किल फ़ाइल पब्लिशर की रिपॉज़िटरी में ही रहती है।
कॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill paper-explainer -a cursor -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill paper-explainer -a claude-code -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill paper-explainer -a codex -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill paper-explainer -a grok -yकॉपी किया गया संदेश Grok Bot चैट में भेजें। Bot यह SKILL.md GitHub से लाता है और उसे उन स्किल में जोड़ देता है जो आपके सभी Bot साझा करते हैं।
Install this skill: https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/builtin/paper-explainerपब्लिशर से
把一篇论文讲成普通人/同行都爱看的视频号视频或图文。核心中间产物是一份 结构化 asset library(一次解析+提炼,视频与图文两条产线共用,不重复调 LLM)。 确定性 IO(拉论文/解析 PDF/骨架)走
scripts/paper_ingest.py;提炼与分镜脚本由你 LLM 完成——这是本 SKILL 的核心价值。
视频转图文(反向)见 video-to-article;纯格式转换见 doc-convert; 只做图表见 chart-visualization / infographic;发视频号见 skill-channels-upload。
outputs/论文简称/)article.md 图文版(知乎/公众号)
final.mp4 成片
assets/ paper.pdf / parsed/ / asset-library.json / script.md
slide-plan.json 结构化分页(页面唯一输入,口播与屏幕文字分离)
slides/ 稳定渲染的逐页 PNG + HTML + audit report
slides-contact-sheet.jpg 整套视觉复核图
脚本(相对项目根):paper_ingest.py(解析)+ render_slides.py(分页校验/渲染/审计)。
python skills/builtin/paper-explainer/scripts/paper_ingest.py check
(看 pdfplumber / MinerU token / 代理;缺 pdfplumber 则 pip install pdfplumber)。paper_ingest.py fetch --paper <id/url/本地pdf> -o outputs/论文简称/assets/paper.pdf。paper_ingest.py parse -i outputs/论文简称/assets/paper.pdf -o outputs/论文简称/assets/parsed/
(有 MINERU_API_TOKEN 走 MinerU 含公式/图表结构化,否则 pdfplumber 纯文本 + 尽力抽图)。paper_ingest.py skeleton -o outputs/论文简称/assets/asset-library.json。outputs/论文简称/assets/parsed/content.*,按 references/paper-distill-schema.md 填满 outputs/论文简称/assets/asset-library.json:
one_liner(一句话讲清干了啥)、problem/prior_gap、contributions(≤3 条)、
method(含通俗类比 analogy)、key_figures(挑 2–4 张关键图,每张写 plain 大白话解释)、
results(含关键数字)、limitations、takeaway、terms(术语通俗表)。
通俗化方法见 references/explain-methodology.md(公式/图表→大白话、类比法、避免堆术语)。references/video-storyboard.md 结构(钩子→问题→已有不足→贡献→方法一图讲清→结果→意义)把 asset-library 写成 outputs/论文简称/assets/script.md。
分镜/留存/口播节奏复用 video-script 的方法(喂论文语境)。可选双人问答口播(主持人提问+讲解者回答)比单人旁白更抓耳——用双人时把口播写成逐行 lines.json({speaker,text,emotion},speaker=主讲/提问)。outputs/论文简称/assets/parsed/figures/ 选用;复杂原图先裁关键区域,方法流程/结果图用 infographic / chart-visualization 重绘。封面/概念页缺图时,主动找或制作与主题直接相关的线稿、局部图或符号素材,不用随机机器人/blob 填空。图中文字在目标分辨率不可读就不得直接使用。references/slide-design.md,把 script 写成 outputs/论文简称/assets/slide-plan.json。把用户/Profile/参考图的原始风格意图原样写入 style,再分别选 base_style、treatment、theme、motif 和视觉素材来实现;不得把用户风格强行归为某个预设,也不得因没有同名预设而拒绝。迁移的是可观察特征(氛围、配色、线条、纹理、构图、角色/物件素材),不是穷举风格名。未指定风格时用 editorial,但默认也必须有明确的编辑网格、纸张层次、章节锚点和图片框法,不得交付“素底 + 字”。整套锁定一个设计立场,页面骨架与审计门保持稳定。运行:
python skills/builtin/paper-explainer/scripts/render_slides.py validate --plan outputs/<项目>/assets/slide-plan.json
python skills/builtin/paper-explainer/scripts/render_slides.py render --plan outputs/<项目>/assets/slide-plan.json --out-dir outputs/<项目>/assets/slides
python skills/builtin/paper-explainer/scripts/render_slides.py audit --plan outputs/<项目>/assets/slide-plan.json --slides-dir outputs/<项目>/assets/slides --contact-sheet outputs/<项目>/assets/slides-contact-sheet.jpg
任一非 0 退出必须改 plan 后重渲;validate 会按页面职能拦截“只有口号、缺少解释”的低信息页,并检查合并主题后所有正文色在实际背景上的对比度;明亮 accent 可继续用于装饰,文字会使用可读的语义前景色。render 会硬拦文字/元素越界、重叠、组内不对齐、卡内文字左边漂移与结构页过度空洞。脚本全过后当前 Agent 必须肉眼查看 contact sheet 和至少 3 张原尺寸 slide,检查暂停/静音时页面能否独立读懂、论文图可读、文字是否和所属元素对齐、留白是否有叙事作用、视觉素材是否相关、节奏是否重复;只过脚本不等于合格。不要把 narration 整段搬上屏。只有论文图本身承载主要信息时才可在该页设 density: visual,不得把它当作跳过内容提炼的开关。assets/slides/slide_*.png、配音和字幕写入 auto-short-video storyboard 后合成,必须设顶层 "image_motion": "static";slide/图表禁用 Ken Burns,不得缩放、平移或裁掉边缘。页面停留时长按对应 narration 音频/字幕分段,不均分整轨。不能只交静态图或无声视频。manifest.py meta 登记 final.mp4 或 article.md 为 deliverable;中间解析、slide 和音频只放 。article.md:标题(钩子)+ 用大白话讲清 problem→method→results→takeaway,配 outputs/论文简称/assets/ 的图。
平台适配见 references/platform-adapt.md(知乎逻辑链、公众号成文起承转合)。排版/长图交 doc-convert;发布交 skill-zhihu-publisher / skill-wechat-publisher。platforms.md 定主平台并给出形态/画幅/时长建议,但视频画幅仍须用户确认;audience.md 定受众深度(大众 vs 同行);style.md 定讲解调性;identity.md 定领域垂类(AI/生物/材料…影响类比取材)。见 EASEL-META.md。流程沉淀自 QuZhan51496/paper2anything(本身即 Claude Skills:parse_pdf/MinerU + 提炼方法论外置 references + 多形态扇出)、
showlab/Paper2Video(按内容块切段、字幕先行)、Paper2Poster(结构化 asset library 中间产物)、
Azzedde/paper_to_podcast(双人问答口播)、OpenDCAI/Paper2Any(一次解析扇出多形态)。
>
---name: paper-explainerdescription: >---# skills/builtin/paper-explainer/SKILL.mdFAQ
पब्लिशर से skills/builtin/paper-explainer/SKILL.md डाउनलोड करें, या पाथ कॉपी करके रिपॉज़िटरी खोलें। PlugMCP स्किल को सूचीबद्ध करता है, फ़ाइल होस्ट नहीं करता।
पब्लिशर इसे https://github.com/ZJU-REAL/Easel पर रखता है।
Claude, Cursor, Codex और Grok Build वह SKILL.md पढ़ सकते हैं जिसे आप पब्लिशर की रिपॉज़िटरी से जोड़ते हैं। जब आप चैट में स्किल के GitHub फ़ोल्डर का लिंक भेजते हैं, तो Grok Bot उसे इंस्टॉल कर देता है।
outputs/论文简称/assets/