guizang-ppt-skill  by op7418

Create magazine-style HTML decks from prompts

Created 1 month ago
11,280 stars

Top 4.7% on SourcePulse

GitHubView on GitHub
Project Summary

A Claude Code Skill that transforms prompts into horizontal-swipe magazine-style HTML decks. It offers 10 distinct page layouts, 5 curated themes, and dynamic WebGL hero backgrounds, all packaged into a single, self-contained HTML file for effortless sharing and offline viewing. This tool is designed for users seeking to create visually striking presentations with a distinct 'electronic magazine x electronic ink' aesthetic, inspired by publications like Monocle.

How It Works

The skill generates single-file HTML presentations adopting an 'electronic magazine × electronic ink' visual style, reminiscent of Monocle magazine. It employs a structured approach with distinct typography (serif, sans-serif, monospace), optional WebGL fluid/dispersion backgrounds on hero pages, and intuitive horizontal navigation via keyboard, scroll, touch, or on-screen controls. Users select from 5 pre-defined themes and 10 page layout templates, ensuring a cohesive and visually appealing presentation without requiring external assets or build processes.

Quick Start & Requirements

Installation is streamlined via npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill or by instructing an AI agent with shell access to perform the setup. Manual installation involves a git clone command to ~/.claude/skills/guizang-ppt-skill. The primary requirement is an environment supporting Claude Code or similar AI agents capable of executing shell commands. The output is a single HTML file, eliminating the need for servers or build tools, making setup and deployment exceptionally straightforward.

Highlighted Details

  • Layouts: Features 10 distinct page layout templates, including covers, chapter breaks, data callouts, image-heavy designs, and comparison slides.
  • Themes: Offers 5 curated color themes (Ink Classic, Indigo Porcelain, Forest Ink, Parchment, Dune), each with a specific aesthetic purpose.
  • Visuals: Integrates WebGL fluid/dispersion effects for dynamic hero page backgrounds.
  • Output: Generates a single, self-contained HTML file that can be opened directly in any web browser.
  • Navigation: Supports horizontal page turning via keyboard (left/right arrows), mouse wheel, touch gestures, and an index view.

Maintenance & Community

Contributions are welcomed through GitHub Issues and Pull Requests. Developers are encouraged to add new classes to template.html and document any encountered issues in the checklist.md file. New themes should be added to themes.md with suggested use cases.

Licensing & Compatibility

The project is licensed under the MIT license. This permissive license allows for broad compatibility, including commercial use and integration within closed-source projects.

Limitations & Caveats

The skill is not suitable for presentations requiring extensive tabular data, high-information-density training materials, or collaborative editing due to its static HTML output. Furthermore, theme colors are pre-defined and cannot be customized with specific hex values, prioritizing aesthetic consistency over granular user control.

Health Check
Last Commit

4 days ago

Responsiveness

Inactive

Pull Requests (30d)
8
Issues (30d)
11
Star History
11,353 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.