baoyu-slide-deck 把文章整理成逐页大纲，再生成每页图片并合并为 PPTX 或 PDF。适合阅读和分享的知识型幻灯片；导出的 PPTX 以整页图片为主。
安装与准备
在项目终端安装技能：
npx skills@latest add jimliu/baoyu-skills --skill baoyu-slide-deck --agent claude-code
准备文章或 Markdown、目标读者和页数。运行环境需要 Bun 或可通过 npx 调用 Bun，并有可用的图片生成工具。这里安装 Claude Code 文件版本；Codex 可改为 --agent codex，并在对话中使用 $baoyu-slide-deck。
第一次使用
以下内容发到 Agent 对话中，替换成自己的文件和目标：
/baoyu-slide-deck notes/agent-skills.md --style sketch-notes --audience beginners --slides 8 --lang zh --outline-only
先解释每页的重点和前后关系，面向刚接触 Agent Skills 的读者。
先确认内容顺序
第一次建议使用 --outline-only，在产生图片前检查结构。八页示例可以先解释 Skill 解决什么问题，再展示安装、调用、一个任务例子和常见误区。每页只承担一个主要目的，避免为了页数把同一观点反复拆开。
保存提示词，再选择生成方式
确认风格、语言和受众后，逐页提示词保存在 prompts/。可以用 --prompts-only 先检查所有提示，不产生图片。真正生成时需要当前 Agent 可用的图像后端；没有图像能力时，先停在大纲或提示词阶段更实用。
按页修正并合并
检查图片中的专有名词、数字和中文标题。某页内容有误时，修改该页提示词，再用 --regenerate 指定页码重做，例如 3 或 2,5。全部页面确认后才合并，保留大纲、提示词和图片，后续才容易调整。
交付前检查
分别打开 PDF 和 PPTX，检查页面顺序、清晰度、文字准确性与边缘裁切。需要分享的版本应在常见阅读尺寸下也能看懂，不能只看缩略图。
常见问题
为什么不能逐个编辑 PPTX 里的文字？ 这是图片式幻灯片流程，整页图像不是原生文字框；宝玉另一个 baoyu-design 项目采用不同路线。
文字错了能直接覆盖吗？ 优先修正提示并重生成该页，避免补丁破坏风格。
默认一次生成多少页？ 分组生成受后端能力和配置影响，先确认提示词再开始。
从一份培训讲义走到可放映版本
假设要把 3000 字的内部培训讲义做成面向新同事的十页课件。输入时明确读者、目标页数和结束时应该会做的事，先用 --outline-only 检查十页是否形成“问题—步骤—演示—检查”的顺序。若大纲把关键操作压成一页、却用三页重复背景，先改大纲，不要靠提示词生成阶段补救。选预设时，技术图解与管理汇报可以使用不同密度，风格不能代替信息结构。
确认后用 --prompts-only 检查每页文字和画面描述，特别是命令、图表标签与数字。图像生成前确认当前后端能处理参考图和中文；某页文字错误用 --regenerate 只重做指定页。交付时在投影比例与手机预览各看一遍，检查图片式 PPTX 的小字和裁切。若接收方需要编辑文字，事先说明整页主要是图片，并同时交付原讲义、大纲与提示文件；不能把可打开的 PPTX 误认为可逐字编辑的课件。