guizang-ppt-skill is an AI-agent Skill, licensed AGPL-3.0, that turns articles, Markdown, or raw ideas into single-file HTML slide decks with editorial-magazine or Swiss layouts, matching images, and social covers — built for people who present: conference speakers, product teams at launch and demo days, and anyone who wants a strongly personal visual style rather than a corporate template.

What it is

guizang-ppt-skill is an agent Skill for Claude Code, Codex, and other agent environments that generate presentations. It produces single-file HTML decks that flip horizontally, plus accompanying images and multi-platform covers, and it ships with a complete rehearsal and speaker mode. Its two built-in visual systems are Style A, an electronic-magazine look fused with e-ink aesthetics for narrative and opinion, and Style B, Swiss International typography with grid-first composition, a single high-saturation anchor colour, right angles, hairline rules, and extreme type-scale contrast for facts, products, and analysis. The author distilled it from offline talks such as "一人公司:被 AI 折叠的组织" and "一种新的工作方式"; every pitfall encountered along the way is recorded in checklist.md.

The concrete problem it solves is the gap between an AI agent that can write prose and the delivery format a live audience expects. Instead of exporting to a slide tool, hand-fixing the layout, and then re-exporting images, the Skill replaces that loop with locked templates and a generated deck you can present directly from the browser. It lives in the AI-agent skill ecosystem, distributed through npx skills and skill stores, and it replaces the manual slide-building and image-preparation step in a normal presentation workflow with a single agent request.

Key capabilities

• Two visual systems with distinct jobs: Style A for narrative and Style B for factual, product, or methodology content.
• Style A ships 10 layouts covering cover, section divider, big-number data posters, image-and-text, image grids, Pipeline, and comparison.
• Style B ships 22 locked layouts including Cover, Statement, KPI Tower, Loop Diagram, Duo Compare, Image Hero, and Closing Manifesto.
• Theme presets: 5 e-ink themes for Style A and 4 Swiss high-saturation anchor colours for Style B.
• Horizontal paging controlled by keyboard arrow keys, scroll wheel, touch swipe, bottom dots, and an ESC index.
• Optional Codex image pipeline using GPT-Image 2.0 or GPT-M 2.0 to generate documentary photographs, infographics, flowcharts, system-relationship diagrams, and UI scenario images, inserted at template ratio.
• Covers for multiple platforms from one visual rule set: WeChat 21:9 header, WeChat 1:1 share card, Xiaohongshu 3:4, and landscape Video Account formats.
• Speaker mode with a dual-window audience screen, current-page and next-page 16:9 preview, speaker notes, timed rehearsal, auto-advance, laser pointer, circle selection, and live failure recovery.
• Low-power static mode: pressing B disables WebGL and canvas animation so animated content falls back to static backgrounds.

Who uses it and how

• Conference and offline-sharing speakers who want an editorial or Swiss-styled deck generated from a long article, typically reduced to a 6-10 page rhythm.
• AI product teams building launch decks and demo-day presentations, using Style B locked layouts with a 21:9 hero image.
• Individual creators producing personal-style talks, who convert a Markdown file into a magazine-style presentation.
• Social media operators deriving a WeChat 21:9 header image or a Xiaohongshu 3:4 cover from the core argument of an existing deck.
• Presenters who rehearse in speaker mode, filling in speaker notes and per-page planned durations, then practising with the timer and audience screen.

Getting started

Install with npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill, or clone the repository into ~/.claude/skills/guizang-ppt-skill and confirm that SKILL.md, assets/, and references/ are present. Updates are a git pull inside that directory.

How it compares

The facts provided name no paid products that guizang-ppt-skill replaces, and no direct alternatives either, so on the evidence given it stands alone in this registry. What can be said is structural: it is AGPL-3.0 licensed and distributed as an agent Skill through npx skills and third-party skill stores such as Kimi work and Cola Skill, and the output is a single-file HTML deck with no build step and no server required, which keeps the deck and its assets under the presenter's own control.

When to use it — and when not to

Choose it for offline sharing, internal industry talks, private salons, AI product launches, demo day, and any presentation carrying a strong personal style, where no build step and no server are needed to open the result. Do not choose it for decks built on large tables of data, for training courseware where the information density is too low, or for anything requiring multi-person collaborative editing, because the output is static HTML. Treat presenters who need a shared editing surface or spreadsheet-grade density as out of scope, and note that the deck's speaker-mode features depend on a browser session rather than on the authoring agent.

npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill

帮我安装 guizang-ppt-skill。请把 https://github.com/op7418/guizang-ppt-skill 克隆到 ~/.claude/skills/guizang-ppt-skill,安装完成后检查 SKILL.md、assets/、references/ 是否存在。

帮我更新 guizang-ppt-skill。请进入 ~/.claude/skills/guizang-ppt-skill 执行 git pull,然后告诉我当前最新 commit。

帮我基于这篇文章做一份瑞士风 PPT,控制在 7 页左右,需要 2-3 张配图。

帮我把这份 Markdown 做成杂志风演讲 PPT。
基于这份 PPT 的核心观点,生成一张公众号 21:9 头图。
把这张产品截图重新设计成适合 PPT 的 16:10 配图。
给这份 PPT 补齐演讲备注和每页计划时长,然后用演讲者模式帮我排练。

npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill

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

根据这份大纲给每一页补齐演讲目的、讲述要点、转场和计划时长。没有提供的互动或现场信息不要猜,然后运行演讲模式校验器。

node scripts/validate-presenter-mode.mjs path/to/index.html
node scripts/validate-presenter-mode.mjs path/to/index.html --target-minutes 30

node scripts/validate-swiss-deck.mjs path/to/index.html