/ Directory / Playground / Guizang PPT Skill
● Community op7418 ⚡ Instant

Guizang PPT Skill

by op7418 · op7418/guizang-ppt-skill

Generate magazine-style HTML slide decks from a prompt — single-file, horizontal swipe, 10 layouts, 5 curated themes, WebGL hero. Beat PowerPoint without opening it.

guizang-ppt-skill (op7418) turns a topic prompt into a polished, presentable HTML deck — single file, no build step. Designed for the 'I have 30 minutes before a talk' use case. Output runs in any browser, looks like a designer made it, and you can keep editing prose inline.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "guizang-ppt-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "guizang-ppt-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/op7418/guizang-ppt-skill",
          "~/.claude/skills/guizang-ppt"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

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

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Guizang PPT Skill

Turn a markdown outline into a presentable deck in 10 minutes

👤 Anyone who'd rather skip PowerPoint ⏱ ~30 min beginner

When to use: You have an outline; you need a deck for tomorrow.

Prerequisites
  • Skill installed — git clone https://github.com/op7418/guizang-ppt-skill ~/.claude/skills/guizang-ppt
  • Outline in markdown — Bullet list with section headers
Flow
  1. Pick theme
    guizang-ppt: read /talks/ai-strategy.md. Use the 'serif-light' theme for a 25-slide deck. Keep slide titles tight.✓ Copied
    → Single deck.html generated; opens in browser
  2. Refine slide-by-slide
    Slide 7 is too text-heavy. Convert to comparison layout (left vs right).✓ Copied
    → Slide 7 changed in place; rest untouched
  3. Add hero
    Add a subtle WebGL background to the title slide. Theme-matching colors only.✓ Copied
    → Title slide has tasteful WebGL behind text

Outcome: Polished deck in a single HTML file, ready to present.

Pitfalls
  • Too many words per slide — Target 25 words/slide; ask Claude to enforce a budget
Combine with: filesystem

Turn a paper into a 15-min talk

👤 Researchers / academics ⏱ ~60 min intermediate

When to use: You have a paper PDF and a conference slot in 2 days.

Prerequisites
  • Paper in markdown — Convert PDF to MD (Pandoc, etc.)
Flow
  1. Compress
    Read paper.md. Compress into 12 slides: motivation, method, key result, 2 figures, future work, refs. Use 'mono-dark' theme.✓ Copied
    → 12-slide deck; figures referenced as image paths
  2. Iterate
    Slide 5 'method' should show the architecture diagram, not text. Replace with image /paper/figs/arch.png.✓ Copied
    → Slide 5 reworks to image-focused

Outcome: Conference-ready deck.

Pitfalls
  • PDF figures not extracted — Run pdfimages first; reference paths in prompt
Combine with: dailypaper-skills

Weekly team update without 30 minutes in PPT

👤 Tech leads / EMs ⏱ ~10 min beginner

When to use: Friday afternoon: you need a deck for Monday all-hands.

Flow
  1. Compose
    8-slide team update: shipped / in flight / blocked / Q3 plan. 'playful' theme. Keep numbers prominent.✓ Copied
    → Deck generated with big-number layout for stats

Outcome: Update deck in 5 minutes.

Pitfalls
  • Too playful for a corporate audience — Switch to 'serif-light' or 'mono-dark'

Combinations

Pair with other MCPs for X10 leverage

guizang-ppt-skill + filesystem

Source content from local notes

Read /notes/q2.md, generate a 'mono-dark' deck. Save as /decks/q2.html.✓ Copied
guizang-ppt-skill + dailypaper-skills

Paper-to-talk pipeline

Daily paper: extract paper.md. guizang-ppt: turn into 12-slide deck.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
generate_deck outline, theme, slide_count First pass 0
edit_slide deck.html, slide_num, change Iterate on a single slide 0
add_webgl_hero deck.html, palette? Make the title slide pop 0
switch_theme deck.html, theme Wrong tone — swap theme 0

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
1000–6000 (HTML output is the big chunk)
Monetary
Free
Tip
Generate the structure first, then iterate slide-by-slide rather than regenerating the whole deck

Security

Permissions, secrets, blast radius

Minimum scopes: filesystem-write
Credential storage: None
Data egress: None (everything local; output is HTML)

Troubleshooting

Common errors and fixes

Slides overflow

Reduce word budget per slide; the layouts have set heights

WebGL hero crashes Safari

Disable WebGL or use the static fallback variant

Theme looks wrong on projector

Switch to 'mono-dark' for high-contrast venues

Alternatives

Guizang PPT Skill vs others

AlternativeWhen to use it insteadTradeoff
PowerPoint / KeynoteYou need precise pixel control or corporate templatesSlower iteration loop
Slidev / Reveal.jsYou like Markdown-first, command-line workflowMore setup; theming requires more work
MarpPure markdown decksLess polished output by default

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills