Repolode
Submit
op7418

op7418/guizang-ppt-skill

An AI agent Skill that generates single-file HTML slide decks, presentation images, and social media covers with built-in presenter mode.

Open-source alternative to:PowerPointKeynote

View on GitHub
Stars
29,389
Forks
2,014
Open issues
53
Last commit
8 days ago

What is it?

Guizang PPT Skill is an agent Skill for Claude Code and Codex that turns an article, Markdown file, or set of notes into a horizontal-swipe HTML slide deck. Each deck is a single HTML file that opens in a browser without a build step or server, so it can be presented, shared, or screenshotted directly.

The Skill ships two visual systems: an editorial magazine style inspired by Monocle, with a set of layout skeletons and five color themes, and a stricter Swiss international style built on a 16-column grid, 22 named layouts, and four accent colors. A validator script checks Swiss decks for layout violations and image slot misuse.

It also covers adjacent visual work. In Codex it can prompt image generation for photos, infographics, flow diagrams, and UI scenes sized to slide placements, and it generates covers for WeChat, Xiaohongshu, and video platforms. The built-in presenter mode provides a dual-window audience screen, current and next slide previews, speaker notes, timing and rehearsal logging, and laser pointer and annotation tools, all running locally in the browser.

Key features

  • 01Generates single-file HTML slide decks that open in any browser with no build or server.
  • 02Offers an editorial magazine style and a Swiss grid style with named, locked layouts.
  • 03Provides five color themes for the magazine style and four accent palettes for the Swiss style.
  • 04Includes a presenter mode with audience window sync, speaker notes, rehearsal timing, and laser pointer.
  • 05Includes a validator for Swiss decks and presenter-mode notes and timing.

Use cases

  • Turning a long article into a six-to-ten-slide talk deck with a chosen visual style.
  • Making product analysis or methodology slides with a strict, grid-based Swiss layout.
  • Creating matching covers for WeChat, Xiaohongshu, or video platforms from the same deck content.
  • Rehearsing a talk with timed slides and speaker notes before an event.

Quick start

  1. 1

    Install the skill with npx

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

    Ask your AI agent to make a deck, for example a Swiss-style PPT from an article

  3. 3

    Open the generated single HTML file in a browser and press P for presenter mode

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires derivative works to be shared under the same terms.
  • Needs an AI agent with file system and shell access; a plain chatbot without these is not recommended.
  • The core output is HTML, so PPTX export is not part of the main workflow.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI coding assistants & agentsAI image generators & Stable Diffusion tools

Topics

#ai-agent#presentation#html-slides#slide-deck#image-generation#claude-code#codex#swiss-design#html-deck#ppt

FAQ

What is guizang-ppt-skill?
An AI agent Skill that generates single-file HTML slide decks, presentation images, and social media covers with built-in presenter mode. Guizang PPT Skill is an agent Skill for Claude Code and Codex that turns an article, Markdown file, or set of notes into a horizontal-swipe HTML slide deck. Each deck is a single HTML file that opens in a browser without a build step or server, so it can be presented, shared, or screenshotted directly.
Is guizang-ppt-skill free to use? What license does it have?
guizang-ppt-skill is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is guizang-ppt-skill still maintained?
Actively maintained. The last commit to guizang-ppt-skill was on Oct 30, 2026.
What can I use guizang-ppt-skill for?
Turning a long article into a six-to-ten-slide talk deck with a chosen visual style. Making product analysis or methodology slides with a strict, grid-based Swiss layout. Creating matching covers for WeChat, Xiaohongshu, or video platforms from the same deck content. Rehearsing a talk with timed slides and speaker notes before an event.
How do I install guizang-ppt-skill?
Install the skill with npx: npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill Ask your AI agent to make a deck, for example a Swiss-style PPT from an article Open the generated single HTML file in a browser and press P for presenter mode
Where can I get guizang-ppt-skill?
The source code and installation instructions are on GitHub: https://github.com/op7418/guizang-ppt-skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects