kai-slide-creator

Category: Data & AI | Uploader: kaisersong | Downloads: 0 | Version: v1.0（Latest）

Use when someone wants to CREATE or BUILD a slide deck, presentation, or 幻灯片/PPT/演示文稿 — from scratch, from notes, from a Word/PPTX file, or from an approved outline. Handles Chinese and English equally. Covers pitch decks, product launches, team standups, conference talks, capstone presentations, style previews, and converting existing files to web slides. Use for --plan (outline) and --generate (HTML from plan) flags. Does NOT apply to exporting finished HTML to PPTX/PNG (use kai-html-export), writing speeches, or non-slide documents.

Changelog: Source: GitHub https://github.com/kaisersong/slide-creator

Directory Structure

Current level: tree/main/

📁 demos/
- 📁 screenshots/
  - 📄 aurora-mesh.png 280.6 KB
  - 📄 blue-sky.png 794.0 KB
  - 📄 bold-signal.png 49.6 KB
  - 📄 chinese-chan.png 40.4 KB
  - 📄 creative-voltage.png 37.7 KB
  - 📄 dark-botanical.png 81.1 KB
  - 📄 data-story.png 44.3 KB
  - 📄 electric-studio.png 34.7 KB
  - 📄 enterprise-dark.png 51.6 KB
  - 📄 glassmorphism.png 333.2 KB
  - 📄 japanese-zen.png 40.4 KB
  - 📄 modern-newspaper.png 36.9 KB
  - 📄 neo-brutalism.png 60.5 KB
  - 📄 neo-retro-dev.png 23.4 KB
  - 📄 neon-cyber.png 96.0 KB
  - 📄 notebook-tabs.png 44.3 KB
  - 📄 paper-ink.png 43.0 KB
  - 📄 pastel-geometry.png 42.0 KB
  - 📄 split-pastel.png 51.0 KB
  - 📄 swiss-modern.png 29.7 KB
  - 📄 terminal-green.png 49.1 KB
  - 📄 vintage-editorial.png 55.6 KB
- 📄 .DS_Store 6.0 KB
- 📄 aurora-mesh-en.html 25.8 KB
- 📄 aurora-mesh-zh.html 25.8 KB
- 📄 blue-sky-en.html 68.9 KB
- 📄 blue-sky-zh.html 68.7 KB
- 📄 bold-signal-en.html 30.0 KB
- 📄 bold-signal-zh.html 30.1 KB
- 📄 chinese-chan-en.html 23.2 KB
- 📄 chinese-chan-zh.html 23.3 KB
- 📄 creative-voltage-en.html 31.7 KB
- 📄 creative-voltage-zh.html 31.6 KB
- 📄 dark-botanical-en.html 22.2 KB
- 📄 dark-botanical-zh.html 22.1 KB
- 📄 data-story-en.html 32.0 KB
- 📄 data-story-zh.html 31.4 KB
- 📄 electric-studio-en.html 32.0 KB
- 📄 electric-studio-zh.html 32.1 KB
- 📄 enterprise-dark-en.html 28.1 KB
- 📄 enterprise-dark-zh.html 28.0 KB
- 📄 glassmorphism-en.html 29.7 KB
- 📄 glassmorphism-zh.html 29.4 KB
- 📄 modern-newspaper-en.html 38.4 KB
- 📄 modern-newspaper-zh.html 38.1 KB
- 📄 neo-brutalism-en.html 21.6 KB
- 📄 neo-brutalism-zh.html 21.7 KB
- 📄 neo-retro-dev-en.html 41.0 KB
- 📄 neo-retro-dev-zh.html 40.8 KB
- 📄 neon-cyber-en.html 28.9 KB
- 📄 neon-cyber-zh.html 28.9 KB
- 📄 notebook-tabs-en.html 27.1 KB
- 📄 notebook-tabs-zh.html 27.2 KB
- 📄 paper-ink-en.html 21.7 KB
- 📄 paper-ink-zh.html 21.5 KB
- 📄 pastel-geometry-en.html 25.6 KB
- 📄 pastel-geometry-zh.html 25.7 KB
- 📄 split-pastel-en.html 23.5 KB
- 📄 split-pastel-zh.html 23.6 KB
- 📄 swiss-modern-en.html 21.6 KB
- 📄 swiss-modern-zh.html 21.7 KB
- 📄 terminal-green-en.html 22.2 KB
- 📄 terminal-green-zh.html 22.3 KB
- 📄 vintage-editorial-en.html 27.5 KB
- 📄 vintage-editorial-zh.html 27.7 KB
📁 references/
- 📄 aurora-mesh.md 4.5 KB
- 📄 base-css.md 4.7 KB
- 📄 blue-sky-starter.html 33.7 KB
- 📄 chinese-chan.md 5.2 KB
- 📄 data-story.md 7.2 KB
- 📄 design-quality.md 7.5 KB
- 📄 design-system.md 3.9 KB
- 📄 diagram-patterns.md 10.2 KB
- 📄 enterprise-dark.md 4.9 KB
- 📄 glassmorphism.md 4.9 KB
- 📄 html-template.md 36.6 KB
- 📄 neo-brutalism.md 4.8 KB
- 📄 planning-template.md 2.7 KB
- 📄 pptx-extraction.md 2.7 KB
- 📄 style-index.md 3.3 KB
- 📄 workflow.md 9.2 KB
📁 scripts/
- 📄 screenshot-demos.py 3.8 KB
📁 tests/
- 📄 conftest.py 165 B
- 📄 run_tests.py 2.1 KB
- 📄 test_demo_quality.py 16.6 KB
- 📄 test_export_integration.py 7.8 KB
- 📄 test_workflow_polish.py 1.5 KB
- 📄 validate.py 10.1 KB
📁 themes/
- 📁 _example-coral-dawn/
  - 📄 reference.md 6.8 KB
  - 📄 starter.html 41.1 KB
- 📄 README.md 1.5 KB
- 📄 README.zh-CN.md 1.6 KB
📄 .gitignore 248 B
📄 README.md 23.3 KB
📄 README.zh-CN.md 23.4 KB
📄 SKILL.md 6.4 KB
📄 STYLE-DESC.md 61.7 KB

SKILL.md

---
name: kai-slide-creator
description: Use when someone wants to CREATE or BUILD a slide deck, presentation, or 幻灯片/PPT/演示文稿 — from scratch, from notes, from a Word/PPTX file, or from an approved outline. Handles Chinese and English equally. Covers pitch decks, product launches, team standups, conference talks, capstone presentations, style previews, and converting existing files to web slides. Use for --plan (outline) and --generate (HTML from plan) flags. Does NOT apply to exporting finished HTML to PPTX/PNG (use kai-html-export), writing speeches, or non-slide documents.
version: 2.7.0
metadata: {"openclaw":{"emoji":"🎞","os":["darwin","linux","windows"],"homepage":"https://github.com/kaisersong/slide-creator","requires":{"bins":["python3"]},"install":[]}}
---

# Slide Creator

Generate zero-dependency HTML presentations that run entirely in the browser.

## Core Philosophy

1. **Zero Dependencies** — Single HTML files with inline CSS/JS. No npm, no build tools.
2. **Show, Don't Tell** — Generate visual style previews; people can't articulate design preferences until they see options.
3. **Distinctive Design** — Avoid generic AI aesthetics (Inter font, purple gradients, predictable heroes).
4. **Viewport Fitting** — Slides fit exactly in the viewport. Overflowing content gets split, not squished.
5. **Plan Before Generate** — `--plan` creates an outline; `--generate` produces HTML from it.

---

## Generation Contract (Non-Negotiable)

**Every generated HTML file MUST include Presentation Mode.**

1. **Presentation Mode** - F5 / ▶ button, fullscreen scaling, `PresentMode` class (`body.presenting`, `#present-btn`, `#present-counter`)
2. **Edit Mode (default-on, optional)** - top-left hotzone, `✏ Edit` toggle, `contenteditable` on all text, notes panel (`#notes-panel`, `setupEditor()`). Include it by default and omit it only when the user explicitly chooses "No inline editing."

These are defined in `references/html-template.md`. **Read that file before writing any HTML**, regardless of how you entered the skill.

> Omitting Presentation Mode is a generation error. Omitting Edit Mode is allowed only when the user opted out.

---

## Command Routing

Parse the invocation first, then load only what that command needs:

| Command | What to load | What to do |
|---------|-------------|------------|
| `--plan [prompt]` | `references/planning-template.md` | Create PLANNING.md. Stop — no HTML. |
| `--generate` | `references/html-template.md` + chosen style file + `references/base-css.md` + `references/design-quality.md` | Read PLANNING.md, generate HTML. |
| No flag (interactive) | `references/workflow.md` + **`references/html-template.md` before Phase 3** + `references/design-quality.md` before writing | Follow Phase 0-5. |
| Content + style given directly | `references/html-template.md` + style file + `references/base-css.md` | Generate immediately — no Phase 1/2 needed. |

**Progressive disclosure rule:** each command loads only its required files. `--plan` never touches CSS. This keeps context focused and fast.

---

## Phase 0: Detect Mode (No-flag entry point)

**Read `references/workflow.md` for the full interactive workflow (Phases 1-5).**

Quick routing before reading workflow.md:

- **PLANNING.md exists** → read it as source of truth, skip to Phase 3. Load `references/html-template.md` before generating.
- **User provides source content + style directly** (e.g. a .txt/.md file + style name) → skip Phase 1/2. Load `references/html-template.md` + style file + `references/base-css.md`, then generate immediately.
- **User has a `.ppt/.pptx` file** → Phase 4 (PPT conversion).
- **User wants to enhance existing HTML** → read it, then follow the Enhancement Mode guardrails in `references/workflow.md` before editing.
- **Everything else** → Phase 1 (Content Discovery).

**Content-type → Style hints** (use when user hasn't chosen a style):

| Content type | Suggested styles |
|---|---|
| Data report / KPI dashboard | Data Story, Enterprise Dark, Swiss Modern |
| Business pitch / VC deck | Bold Signal, Aurora Mesh, Enterprise Dark |
| Developer tool / API docs | Terminal Green, Neon Cyber, Neo-Retro Dev Deck |
| Research / thought leadership | Modern Newspaper, Paper & Ink, Swiss Modern |
| Creative / personal brand | Vintage Editorial, Split Pastel, Neo-Brutalism |
| Product launch / SaaS | Aurora Mesh, Glassmorphism, Electric Studio |
| Education / tutorial | Notebook Tabs, Paper & Ink, Pastel Geometry |
| Chinese content | Chinese Chan, Aurora Mesh, Blue Sky |
| Hackathon / indie dev | Neo-Retro Dev Deck, Neo-Brutalism, Terminal Green |

---

## Style Reference Files

Read only the file for the chosen style. Never load all styles into context.

| Style | File |
|-------|------|
| Blue Sky | `references/blue-sky-starter.html` (use as full base — do not rewrite visual CSS) |
| Aurora Mesh | `references/aurora-mesh.md` |
| Chinese Chan | `references/chinese-chan.md` |
| Data Story | `references/data-story.md` |
| Enterprise Dark | `references/enterprise-dark.md` |
| Glassmorphism | `references/glassmorphism.md` |
| Neo-Brutalism | `references/neo-brutalism.md` |
| All other styles | Relevant section in `STYLE-DESC.md` |
| Custom theme | `themes/<name>/reference.md` (use `starter.html` if it exists) |

**For style picker / mood mapping / effect guide** → read `references/style-index.md`.

**For viewport CSS, density limits, CSS gotchas** → read `references/base-css.md`.

**For design quality rules (density balance, column balance, anti-slop, pre-output self-check)** → read `references/design-quality.md` alongside the style file during `--generate` and Phase 3.

---

## For AI Agents & Skills

Other agents can call this skill programmatically:

```
# From a topic or notes
/slide-creator Make a pitch deck for [topic]

# From a plan file (skip interactive phases)
/slide-creator --generate  # reads PLANNING.md automatically

# Two-step (review the plan before generating)
/slide-creator --plan "Product launch deck for Acme v2"
# (edit PLANNING.md if needed)
/slide-creator --generate

# Export to PPTX after generation
/kai-html-export presentation.html                    # image mode (pixel-perfect, default)
/kai-html-export --mode native presentation.html      # native mode (editable text/shapes)
```

---

## Related Skills

- **report-creator** — For long-form scrollable HTML reports (not slides)
- **frontend-design** — For interactive pages that go beyond slides

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

kai-slide-creator

Directory Structure

SKILL.md

Report

Notice