安装 alphane-ai/guizang-ppt-skill-mod 前，需要明确它不是传统 PPTX 生成器。它的核心产物是单文件 HTML 横向翻页演示文稿，还能围绕同一套视觉规则做 PPT 配图和多平台封面；如果你要的是可在 PowerPoint 里逐个编辑文本框、形状和图表的文件，这条路一开始就不对。

这个 skill 的价值在于把杂志风和瑞士风两套版式系统放进 Agent 工作流里，并补了 Codex 本地适配、瑞士风版式校验和标题断行检查。第一个限制也要先摆出来：仓库不是一个 npm 项目，没有 package.json 让你构建应用；它更像一套模板、规则和检查脚本，成败取决于 index.html 是否按模板生成、能否在浏览器里稳定演示。

先弄清楚它交付的到底是什么

guizang-ppt-skill 生成的是横向翻页网页 PPT。生成后的 index.html 可以直接用浏览器打开，支持方向键、滚轮、触屏滑动、底部圆点和 ESC 索引；遇到性能一般的机器，还能用 B 进入低性能静态模式。

它内置两种风格：Style A 是电子杂志和电子墨水的叙事感，适合个人分享、行业观察、线下沙龙；Style B 是瑞士国际主义的网格系统，适合产品分析、方法论、技术汇报和数据表达。别把两套模板混着用，Style A 对应 assets/template.html，Style B 对应 assets/template-swiss.html。

适合它的场景很明确：线下分享、行业内部讲话、AI 新品展示、demo day、需要强视觉风格的观点表达。不适合的场景也同样明确：大段表格、信息密度很高的培训课件、需要多人协作编辑的 PowerPoint 文件。

安装时先把仓库地址选对

这个条目的关键词是 alphane-ai/guizang-ppt-skill-mod，当前 GitHub clone 地址应当用下面这一个。仓库 README 中的快速命令仍展示 weiyangzen/guizang-ppt-skill-mod，那是另一条上游安装路径；如果你要对齐当前这个镜像改版，就不要直接照抄成上游地址。

mkdir -p ~/.claude/skills
git clone https://github.com/alphane-ai/guizang-ppt-skill-mod.git 
  ~/.claude/skills/guizang-ppt-skill

装完后检查目录，再让它做正式演示。至少要能看到 SKILL.md、assets/、references/ 和 scripts/，这四类内容分别负责调用说明、HTML 模板、版式规则和本地检查。

ls ~/.claude/skills/guizang-ppt-skill/SKILL.md
ls ~/.claude/skills/guizang-ppt-skill/assets
ls ~/.claude/skills/guizang-ppt-skill/references
ls ~/.claude/skills/guizang-ppt-skill/scripts

如果你的 Agent 只扫描 ~/.codex/skills，把同一份目录放到 ~/.codex/skills/guizang-ppt-skill，或从 Codex skills 目录做软链接。真正重要的不是目录名字好看，而是运行环境能读到 SKILL.md，并能访问同级的 assets、references 和 scripts。

依赖不用先装一堆包

这个仓库没有前端构建步骤。HTML 模板本身已经包含页面结构、样式、翻页逻辑和必要的前端资源引用，所以第一次测试不需要先跑 npm install。你需要的是一个能读写文件的本地 Agent、一个现代浏览器，以及可选的图片生成能力。

Node 主要用在检查脚本上。Style B 瑞士风有 scripts/validate-swiss-deck.mjs，用来拦截未注册版式、居中标题、图片槽位缺失等问题；scripts/lint-title-breaks.mjs 用来检查长标题断行是否别扭。这两个脚本只依赖 Node 自带能力，适合作为最终检查的本地闸口。

第一次试跑别上正式分享

安装后先做一份 6 到 8 页的小稿，目标是确认 skill 能被识别、模板能复制、浏览器能打开、检查脚本能跑。第一次不要丢进去长报告，也不要同时要求封面、配图、长图、视频号横版全都生成。

请使用 guizang-ppt-skill，基于这份 Markdown 做一份 7 页左右的瑞士风 PPT。
需要 2 张配图，先生成 index.html，完成后告诉我该检查哪些文件。

如果想走杂志风，把“瑞士风”换成“电子杂志风”。如果已经知道要做公众号 21:9 封面或 1:1 分享卡，也可以在小稿跑通后再加，别在第一轮把所有输出混在一起。

跑通后看这几个信号

最小成功信号不是“对话里说完成了”，而是项目目录里真的有 index.html，浏览器打开后能左右翻页，页面没有明显的文字挤压、图片错位和底部控件遮挡。HTML 里每一页应当是 <section class="slide" data-layout="..."> 这样的结构，瑞士风正文页应从锁定版式里选。

node ~/.claude/skills/guizang-ppt-skill/scripts/validate-swiss-deck.mjs path/to/index.html
node ~/.claude/skills/guizang-ppt-skill/scripts/lint-title-breaks.mjs path/to/index.html

如果校验脚本报错，先按错误提示改 data-layout、图片槽位或标题位置，不要急着重做整份演示。Style B 的强约束本来就是为了挡住“看起来像瑞士风、实际上版式乱了”的半成品。

哪些情况别强行用它

alphane-ai/guizang-ppt-skill-mod 更适合做能直接演示和截图传播的 HTML deck。它不负责把页面元素保留成 PowerPoint 对象，不适合多人来回改同一个 .pptx，也不适合把几十列数据塞进一页。Style B 还要接受一套更硬的版式纪律：正文页用 S01 到 S22，锚点色四选一，图片要进入模板预留槽位。

把它用好，关键是三件事：安装时选对当前仓库地址，第一次只跑小稿确认 index.html，瑞士风最终检查跑两条脚本。只要这三关过了，它就是一套很适合本地 Agent 生成和迭代的网页 PPT 工作流；如果你要的是可协作编辑的传统 PPTX，就别在这里硬拧。