paper-deck

npx skills add zsyggg/paper-craft-skills --skill paper-deck --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Paper Deck — Visual Slide Director 把论文/知识内容做成**看起来真的被设计过**的幻灯片。 核心路线不是用 PPT 对象硬摆版式，而是： 1. 先理解内容，做出 deck brief 和逐页叙事。 2. 为每一页写清楚“这页要让观众看到什么、感到什么、记住什么”。 3. 用生图模型生成 16:9 slide image。 4. 合成 PPTX/PDF，并保留 prompts 作为可返修的源文件。 ## 不可绕过的生图要求 Paper Deck 的 V1 是 **raster-first AIGC slide image** 工作流。除非用户明确要求“不要生图”“用代码画图”“只要可编辑 PPT”或“使用 HTML/SVG/Canvas 生成”，否则必须调用真实的 raster image generation backend 为每一页生成图片。 严格禁止把以下产物冒充为本 skill 的“生图页”： - 用 Python/Pillow、SVG、HTML/CSS、Canvas、Mermaid、matplotlib、PPT shapes 或任何本地绘图代码直接画出的整页图片 - 用模板、纯排版脚本、截图、占位图或手工组合元素替代生图后端输出 - 先本地画整页，再仅做轻微滤镜/后处理后当作 AIGC slide image 允许的本地处理仅限： - 移动、复制、重命名生图后端输出文件 - 必要的格式转换、压缩、尺寸校验、PPTX/PDF 合成 - 用户明确选择混合方案时，在生图背景上叠加少量可编辑文字层；此时必须在 `deck-brief.md` 和交付说明中明确记录“混合文字层”，不能声称整页文字都由生图模型完成 如果当前环境没有可用的 raster image generation backend，必须停止并说明缺少生图后端；不要退化成本地绘图替代方案。 ## 何时使用 适合： - 论文组会、答辩、reading group、技术分享 - 需要“一眼不像模板 PPT”的视觉汇报 - 用户愿意接受每页是高质感图片，优先追求整体观感和传播效果 - 需要逐页返修：重做第 N 页、换风格、加真实感、减少 AI 味 不适合： - 需要多人在 PowerPoint 里精细编辑每个文本框 - 大量表格、财务报表、合规材料 - 需要准确复制已有企业 PPT 母版 如果用户需要完全可编辑的 PPT，说明本 skill 的 V1 是 raster-first；可改用常规 PPTX 工具，或生成“图片背景 + 可编辑文字层”的混合方案。 ## 工作流 ### Step 1: 输入分析 接受： - arXiv / DOI / 网页链接 - PDF 路径 - Markdown / 文本 / 文章 - 已有大纲 - 参考图片或参考 PPT 截图 如

python3 <SKILL_ROOT>/scripts/merge_deck.py paper-deck/{topic-slug}