Guizang PPT Skill 是适配 Claude/Codex/Cursor 的开源 Agent 技能，依托两套成熟设计规范，一键生成单文件 HTML 演示稿，兼具 PPT 制作、配图、社交封面全链路能力。

一、核心功能

Guizang PPT Skill 是面向 AI 编程生态的专业化幻灯片生成插件，核心落地形式为单文件 HTML 演示文档，全内容内嵌于单个文件，无需依赖服务、打包工具与外部资源，浏览器双击即可放映，整套功能沉淀开发者十年平面设计经验，划分为五大核心模块。

第一，双成熟视觉版式体系，内置 Style A 电子杂志墨水风、Style B 瑞士国际主义风两套规范。杂志风复刻《Monocle》刊物排版，墨色封面搭配衬线字体、纸张质感正文，适配观点分享、叙事类内容；瑞士风遵循国际网格设计法则，16 列固定栅格、直角元素、1px 发丝分割线、无渐变无圆角，锁定 22 套合规版式，配备脚本校验工具，杜绝随意排版，提供克莱因蓝、柠檬黄等四套品牌主题色一键切换。同时预置封面、时间线、数据大字报、图文混排、多栏对比等 10 种通用页面骨架，AI 仅需填充内容，大幅降低设计出错概率。

第二，全链路 AI 配图与封面生成，联动多模态图像模型，根据页面正文语义自动生成配图，同步输出公众号、小红书、视频号等多比例社交封面，自动裁切画面规避主体裁剪问题，接入 Pexels、Unsplash 等三类免费商用图库，无版权风险。用户可自定义图片目录，以01-cover.jpg命名替换素材，无需修改 HTML 源码即可更新画面。

第三，WebGL 轻量化演示运行环境，HTML 内置原生翻页引擎，支持键盘左右键、鼠标滚轮、触屏滑动三种翻页逻辑，ESC 一键呼出全页缩略导航，内置低功耗渲染内核，低配笔记本、平板离线流畅播放，自带流体动效、页面过渡动画，全程不加载第三方 JS、CSS 资源。

第四，Markdown 全兼容解析，原生支持 Obsidian 风味 Markdown 语法，包含折叠区块、标注提示、嵌套标签、代码块等格式，AI 可直接读取用户整理的 MD 文稿一键排版，省去格式二次调整步骤。

第五，多 Agent 生态适配与规范校验，原生接入 Claude Code、Codex、Cursor 三大主流 AI 工具，通过 SKILL.md 约束 AI 生成逻辑；内置分级质检清单，从版式合规、配色规范、图文比例三层校验，瑞士风配套validate-swiss-deck.mjs校验脚本，一键筛查违规排版，保证输出成品统一专业。

二、技术栈

项目整体轻量化设计，摒弃 React、Vite 等重型前端框架，以原生前端技术 + OpenClaw Skill 规范为底座，全栈开发语言以 HTML 为主，辅助少量 Node 脚本用于校验，整体架构极简无冗余依赖。

1. 前端渲染层

采用原生 HTML+CSS3 + 原生 JavaScript，全部样式、交互、WebGL 动效内嵌单个 HTML 文件，CSS 变量统一管控全局主题色，仅修改 6 行变量即可全局换肤；WebGL 模块原生编写流体背景渲染代码，不引入 Three.js 等第三方图形库，实现低资源占用动效渲染，保障文件轻量化与离线可用性。

2. Agent 技能规范层

遵循 OpenClaw 标准化 Skill 协议，配套 SKILL.md 定义 AI 调用规则、生成约束、需求澄清逻辑，适配 Claude、Codex、Cursor 插件调度规范，AI 读取规范后自动按版式约束生成内容，是项目和各类 AI 编程工具的对接核心。

3. 辅助脚本层

基于 Node.js 开发轻量化校验脚本，瑞士风专用版式检查工具、批量图片预处理脚本、主题批量替换脚本，仅用于本地校验，非运行依赖，用户不执行校验时无需安装 Node 环境即可正常使用成品 HTML。

4. 资源与目录规范

项目仓库标准化分层：assets/template.html为基础生成模板，references/目录收纳布局文档、配色手册、质检清单，图片资源遵循固定命名规则，方便批量替换，整套目录结构便于用户自定义扩展版式与配色。

5. 跨生态对接层

遵循 MCP 协议，可无缝集成 Open Design 等主流 AI 设计工具，作为内置 PPT 生成模块，支持跨 Skill 协同，可搭配图像生成类 Agent 联动完成文案→配图→PPT 全自动化产出。

开源协议宽松，允许个人商用、二次修改自定义模板，无版权束缚。

三、解决什么痛点

项目精准解决传统 PPT 制作、AI 生成演示文稿五大行业痛点，覆盖职场、创作者、学生全人群使用难题。

第一，传统 PPT 制作耗时费力，排版门槛高。普通用户缺乏平面设计功底，手动调整版式、配色、图文布局动辄数小时；Guizang PPT Skill 依托成熟设计规范，一句话下达需求，AI 自动完成排版配色，3 分钟生成成品，把数小时工作压缩至几分钟。

第二，AI 生成 PPT 版式杂乱、风格割裂。通用 AI 生成演示文稿无固定设计约束，页面排版混乱、配色突兀，每次生成风格随机；项目固化两套经过市场验证的设计体系与数十套固定版式，AI 在框架内填充内容，成品统一规整，告别随机翻车。

第三，常规 PPT 文件兼容性差，多设备变形。Office PPTX 文件在不同系统、软件打开出现字体缺失、排版错乱；项目输出单 HTML 文件，全平台浏览器通用，Windows、macOS、安卓、IOS 打开排版完全一致，无需安装办公软件即可放映。

第四，配图与封面制作割裂，多平台素材重复设计。做演示文稿还要单独找图、设计公众号封面，多平台物料需要多次制作；该工具生成 PPT 同步产出配套配图与多尺寸社交封面，一次生成满足演讲、新媒体配图双重需求。

第五，传统演示文稿动效臃肿、低配设备卡顿。带特效的 PPTX 文件体积大，老旧电脑放映卡顿、丢动画；HTML 内置轻量化 WebGL 动效，单文件体积可控，低功耗模式适配老旧设备离线演讲，无软件兼容故障。

第六，云端 PPT 工具隐私泄露、收费高昂。在线 PPT 工具需要上传文稿、开通会员解锁精美模板；该 Skill 本地生成 HTML，内容全程不对外上传，开源免费无订阅费用，模板全部内置永久免费使用。

四、应用场景

依托双风格差异化定位，覆盖职场办公、内容创作、产品发布、校园答辩、自媒体运营五大核心场景，适配不同内容表达需求。

1. 产品与商业发布会（瑞士风首选）

科技产品发布、行业分享、商业路演、融资 BP，采用瑞士网格版式，严谨规整的视觉提升专业度，克莱因蓝商务配色适配 AI、软件、科技类产品宣讲，生成的 HTML 可投屏现场放映，动效高级观感突出。

2. 自媒体与知识博主（杂志风 + 封面联动）

公众号推文配套宣讲 PPT、小红书干货分享、线下私域沙龙，杂志风文艺质感适配人文、财经、知识类内容，同步生成封面直接用于新媒体配图，一次生成搞定文稿配图与宣讲素材。

3. 职场日常汇报

部门周报、项目复盘、方案汇报，快速生成轻量化演示文稿，HTML 可直接发微信、钉钉，对方点开链接就能查看，不用发送大体积 PPT 附件，提升跨部门沟通效率。

4. 高校师生答辩与课程

毕业设计答辩 PPT、课堂课题汇报、课程分享，学生输入论文大纲一键排版，电子墨水风适配文科，瑞士风适配理工科数据汇报，免去熬夜排版烦恼。

5. 创作者个人分享

线下读书会、技术闭门分享、个人主题沙龙，精致杂志版式区别普通 Office PPT，屏幕展示氛围感更强，自带动效提升现场观感。

6. 企业内部培训

新员工培训、制度宣讲、技术内训，批量生成标准化演示文稿，统一企业视觉风格，HTML 可部署企业内网，全员在线浏览学习。

五、普通人应该怎么用

项目提供npx 一键安装、Git 手动克隆两种部署方案，零基础用户依托 AI 对话即可完成全流程，无需前端、代码基础。

方式一：一键命令安装（推荐新手）

1. 本机提前安装 Cursor/Claude Code 任意一款 AI 编程工具，终端执行安装指令：npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill
2. 安装完成后直接在 AI 对话框输入指令，例如「帮我制作瑞士风产品发布会 PPT，一共 8 页，内容为 XX 产品介绍」；AI 会主动确认配色方案、页数需求，完成内容梳理后自动生成 HTML 文件。

方式二：手动克隆部署（自定义模板用户）

git clone https://github.com/op7418/guizang-ppt-skill.git ~/.claude/skills/guizang-ppt-skill

克隆后进入目录修改assets/template.html自定义模板样式，修改后再次调用 AI 即可使用自定义版式生成文稿。

日常使用优化技巧

1. 商业、数据类内容优先选用瑞士风，人文、叙事内容选用电子杂志风；
2. 需要替换图片时，在生成文件同级新建 images 文件夹，按01-cover.jpg命名覆盖原图，不用改动 HTML；
3. 生成后如需校验瑞士风合规性，安装 Node 后运行node scripts/validate-swiss-deck.mjs 目标HTML路径一键排查排版错误；
4. 旧版本更新直接对 AI 发送指令「帮我更新 guizang-ppt-skill」，AI 自动拉取仓库最新代码。

六、未来发展方向

依托 GitHub 近 1.5 万 Star 社区热度，项目后续围绕风格扩容、格式拓展、多模态联动、企业定制四大方向持续迭代升级。

第一，持续扩充版式与主题库，新增国风、极简商务、科普卡通三类全新视觉体系，扩充 30 + 行业专属固定版式，覆盖医疗、教育、金融垂直行业演示需求，完善细分场景配色方案。

第二，拓展导出格式，在 HTML 基础上增加 PDF、PPTX 导出能力，兼顾线下 U 盘播放传统 Office 文件的用户需求，解决 HTML 无法直接导入 PPT 软件的短板。

第三，深化多模态全链路联动，打通短视频生成链路，由 PPT 内容一键生成演示短视频，依托 WebGL 引擎自动添加镜头运镜，实现文案→PPT→宣讲短视频一站式产出。

第四，完善团队协作能力，新增 HTML 在线批注、版本存档功能，支持多人协同修改演示文稿，适配企业团队集体修改方案场景。

第五，开放自定义模板 SDK，允许用户上传自有企业 VI 规范生成专属版式，个人与企业可快速封装专属 PPT 生成模板，进一步拓展生态边界。

第六，优化移动端预览，适配手机全屏演讲模式，完善竖版演示布局，满足移动端线下便携宣讲需求。

七、总结

Guizang PPT Skill 凭借双成熟设计体系 + 单文件 HTML 输出 + AI 一键生成三大核心优势，在 AI 演示文稿赛道脱颖而出，短时间收获海量开发者与内容创作者认可，成为 Claude 生态爆款 PPT 开源技能。项目跳出通用 AI 自由生成的粗放模式，以标准化设计规范约束 AI 输出，既利用 AI 高效生成内容，又依托十年设计经验保证成品专业美观，完美平衡效率与视觉品质。

它打破传统 PPT 软件收费、排版难、兼容性差的固有痛点，开源免费 + 本地生成的模式兼顾隐私安全与使用成本，从小学生答辩到企业产品发布全场景适配。在 AI 内容生产持续普及的趋势下，标准化、轻量化、隐私优先的演示生成工具已成刚需，该项目以 Skill 形态深度嵌入主流 AI 编程生态，后续随着版式、格式与多模态能力迭代，有望成为 AI 时代演示文稿制作的主流基础设施，持续降低全人群 PPT 制作门槛。

源代码：https://github.com/op7418/guizang-ppt-skill