用途
humanize-ppt 是一个用于智能体制作演示文稿的规划与检查技能。它的核心思路是把一份演示文稿当作“观众状态迁移”的载体，而不是单纯的信息容器。它不直接渲染幻灯片，而是负责故事线与质量检查，视觉呈现交给下游渲染器完成。
主要能力
- 从笔记、转录、文档或链接等原始素材出发，生成演示简报（deck brief）。
- 生成 AST 大纲（audience state transfer outline，观众状态迁移大纲）。
- 生成逐页幻灯片计划，并为每一页做出媒体决策：照片、系统示意图、短流程片段，或什么都不放。
- 输出演讲者意图（speaker intent）。
- 输出供下一个智能体使用的风格简报（style brief）。
- 在下游技能渲染完成后执行检查（checkup）：将每一渲染页与其大纲页对照，标记那些“只能看、不能讲”的页面，并写出修改指令，最多进行三轮，然后交回人工。
使用方式
该技能需要在渲染之前以 brief 模式运行一次，并在渲染之后以渲染好的演示文稿作为输入再运行一次（checkup 模式）。
安装前先判断是否已安装：
全局检查：
f=~/.agents/skills/humanize-ppt/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
项目检查：
f=.agents/skills/humanize-ppt/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
若结果为 installed，说明技能已以 humanize-ppt 名称安装，直接调用即可；若为 pointer，则进入安装步骤。
检测安装范围：
[ -e ~/.agents/skills/humanize-ppt ] && echo "global" || echo "project"
全局安装：
npx skills add LearnPrompt/humanize-ppt --skill humanize-ppt -g -y
项目安装：
npx skills add LearnPrompt/humanize-ppt --skill humanize-ppt -y
在 Claude Code 中，可以发送以 ! 开头的聊天消息作为命令，无需离开对话即可运行。
安装后调用：技能名称为 humanize-ppt。触发短语包括："humanize ppt"、"presentation outline director"、"audience state transfer outline"、"presentation checkup"。
适用场景
- 需要为智能体生成的演示文稿建立清晰叙事结构时。
- 需要从零散素材（笔记、转录、文档、链接）整理出演示大纲与逐页计划时。
- 需要在渲染后检查幻灯片是否“可讲”而非仅“可看”时。
限制与依赖
- 该技能本身从不渲染幻灯片，必须依赖下游渲染器技能：中文演示文稿使用 guizang-ppt-skill，英文 HTML 演示文稿使用 frontend-slides。
- 许可证为 MIT（有 LICENSE 文件；GitHub 报告为非标准）。
- 下载体积约 40 MB。
- 不适用的情况：只想要一个好看的模板页面、不需要大纲或检查时，应直接使用渲染器，如 html-ppt、frontend-slides、kami 或 guizang-ppt；Markdown 驱动的开发者演示文稿应使用 slidev-skill 或 marp-slides；对 Marp 演示文稿做幻灯片质量检查应使用 marp-slide-quality。