Skip to content
Back to search

html-ppt

SkillWorks with Claude CodeGitHub

HTML PPT Studio — author professional static HTML presentations in many styles, layouts, and animations, all driven by templates. Use when the user asks for a presentation, PPT, slides, keynote, deck, slideshow, "幻灯片", "演讲稿", "做一份 PPT", "做一份 slides", a reveal-style HTML deck, a 小红书 图文, or any kind of multi-slide pitch/report/sharing document that should look tasteful and be usable with keyboard navigation. Triggers include keywords like "presentation", "ppt", "slides", "deck", "keynote", "reveal", "slideshow", "幻灯片", "演讲稿", "分享稿", "小红书图文", "talk slides", "pitch deck", "tech sharing", "technical presentation".

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lewislulu-html-ppt-skill/badge.svg)](/listings/lewislulu-html-ppt-skill)

HTML

<a href="/listings/lewislulu-html-ppt-skill"><img src="/api/listings/lewislulu-html-ppt-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add https://github.com/lewislulu/html-ppt-skill

That registers the skill with your agent runtime. After install, any agent that supports AgentSkills can author presentations by asking things like:

> "做一份 8 页的技术分享 slides,用 cyberpunk 主题" > "turn this outline into a pitch deck" > "做一个小红书图文,9 张,白底柔和风"

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 325 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: html-ppt
  3. description: HTML PPT Studio — author professional static HTML presentations in many styles, layouts, and animations, all driven by templates. Use when the user asks for a presentation, PPT, slides, keynote, deck, slideshow, "幻灯片", "演讲稿", "做一份 PPT", "做一份 slides", a reveal-style HTML deck, a 小红书 图文, or any kind of multi-slide pitch/report/sharing document that should look tasteful and be usable with keyboard navigation. Triggers include keywords like "presentation", "ppt", "slides", "deck", "keynote", "reveal", "slideshow", "幻灯片", "演讲稿", "分享稿", "小红书图文", "talk slides", "pitch deck", "tech sharing", "technical presentation".
  4. ---
  5. # html-ppt — HTML PPT Studio
  6. Author professional HTML presentations as static files. One theme file = one
  7. look. One layout file = one page type. One animation class = one entry effect.
  8. All pages share a token-based design system in `assets/base.css`.
  9. ## Install
  10. ```bash
  11. npx skills add https://github.com/lewislulu/html-ppt-skill
  12. ```
  13. One command, no build. Pure static HTML/CSS/JS with only CDN webfonts.
  14. No network on the target machine? Point the CLI at a local copy
  15. (`npx skills add ./html-ppt-skill`), or just copy this folder into your agent's
  16. skills directory — `~/.claude/skills/html-ppt/` for Claude Code. Decks render
  17. offline; only the webfonts fall back to the system stack. See
  18. [README.md](README.md#offline--manual-install).
  19. ## What the skill gives you
  20. - **36 themes** (`assets/themes/*.css`) — minimal-white, editorial-serif, soft-pastel, sharp-mono, arctic-cool, sunset-warm, catppuccin-latte/mocha, dracula, tokyo-night, nord, solarized-light, gruvbox-dark, rose-pine, neo-brutalism, glassmorphism, bauhaus, swiss-grid, terminal-green, xiaohongshu-white, rainbow-gradient, aurora, blueprint, memphis-pop, cyberpunk-neon, y2k-chrome, retro-tv, japanese-minimal, vaporwave, midcentury, corporate-clean, academic-paper, news-broadcast, pitch-deck-vc, magazine-bold, engineering-whiteprint
  21. - **15 full-deck templates** (`templates/full-decks/<name>/`) — complete multi-slide decks with scoped `.tpl-<name>` CSS. 8 extracted from real-world decks (xhs-white-editorial, graphify-dark-graph, knowledge-arch-blueprint, hermes-cyber-terminal, obsidian-claude-gradient, testing-safety-alert, xhs-pastel-card, dir-key-nav-minimal), 7 scenario scaffolds (pitch-deck, product-launch, tech-sharing, weekly-report, xhs-post 3:4, course-module, **presenter-mode-reveal** — 演讲者模式专用)
  22. - **36 layouts** (`templates/single-page/*.html`) with realistic demo data, including **5 real-image layouts** (single / full-bleed / image+text / gallery / before-after)
  23. - **27 CSS animations** (`assets/animations/animations.css`) via `data-anim`
  24. - **20 canvas FX animations** (`assets/animations/fx/*.js`) via `data-fx` — particle-burst, confetti-cannon, firework, starfield, matrix-rain, knowledge-graph (force-directed), neural-net (pulses), constellation, orbit-ring, galaxy-swirl, word-cascade, letter-explode, chain-react, magnetic-field, data-stream, gradient-blob, sparkle-trail, shockwave, typewriter-multi, counter-explosion
  25. - **Keyboard runtime** (`assets/runtime.js`) — arrows, T (theme), A (anim), F/O, **S (presenter mode: magnetic-card popup with CURRENT / NEXT / SCRIPT / TIMER cards)**, N (notes drawer), R (reset timer in presenter)
  26. - **Touch navigation** — swipe left/right to change slides on phones and tablets
  27. - **FX runtime** (`assets/animations/fx-runtime.js`) — auto-inits `[data-fx]` on slide enter, cleans up on leave
  28. - **Showcase decks** for themes / layouts / animations / full-decks gallery
  29. - **Headless Chrome render script** for PNG export
  30. ## When to use
  31. Use when the user asks for any kind of slide-based output or wants to turn
  32. text/notes into a presentable deck. Prefer this over building from scratch.
  33. ### 🎤 Presenter Mode (演讲者模式 + 逐字稿)
  34. If the user mentions any of: **演讲 / 分享 / 讲稿 / 逐字稿 / speaker notes / presenter view / 演讲者视图 / 提词器**, or says things like "我要去给团队讲 xxx", "要做一场技术分享", "怕讲不流畅", "想要一份带逐字稿的 PPT" — **use the `presenter-mode-reveal` full-deck template** and write 150–300 words of 逐字稿 in each slide's `<aside class="notes">`.
  35. See [references/presenter-mode.md](references/presenter-mode.md) for the full authoring guide including the 3 rules of speaker script writing:
  36. 1. **不是讲稿,是提示信号** — 加粗核心词 + 过渡句独立成段
  37. 2. **每页 150–300 字** — 2–3 分钟/页的节奏
  38. 3. **用口语,不用书面语** — "因此"→"所以","该方案"→"这个方案"
  39. All full-deck templates support the S key presenter mode (it's built into `runtime.js`). **S opens a new popup window with 4 magnetic cards**:
  40. - 🔵 **CURRENT** — pixel-perfect iframe preview of the current slide
  41. - 🟣 **NEXT** — pixel-perfect iframe preview of the next slide
  42. - 🟠 **SPEAKER SCRIPT** — large-font 逐字稿 (scrollable)
  43. - 🟢 **TIMER** — elapsed time + slide counter + prev/next/reset buttons
  44. Each card is **draggable by its header** and **resizable by the bottom-right corner handle**. Card positions/sizes persist to `localStorage` per deck. A "Reset layout" button restores the default arrangement.
  45. **Why the previews are pixel-perfect**: each preview is an `<iframe>` that loads the actual deck HTML with a `?preview=N` query param; `runtime.js` detects this and renders only slide N with no chrome. So the preview uses the **same CSS, theme, fonts, and viewport as the audience view** — colors and layout are guaranteed identical.
  46. **Smooth navigation**: on slide change, the presenter window sends `postMessage({type:'preview-goto', idx:N})` to each iframe. The iframe just toggles `.is-active` between slides — **no reload, no flicker**. The two windows also stay in sync via `BroadcastChannel`.
  47. Only `presenter-mode-reveal` is designed from the ground up around the feature with proper example 逐字稿 on every slide.
  48. Keyboard in presenter window: `← →` navigate (syncs audience) · `R` reset timer · `Esc` close popup.
  49. Keyboard in audience window: `S` open presenter · `T` cycle theme · `← →` navigate (syncs presenter) · `F` fullscreen · `O` overview.
  50. ## Before you author anything — ALWAYS ask or recommend
  51. **Do not start writing slides until you understand three things.** Either ask
  52. the user directly, or — if they already handed you rich content — propose a
  53. tasteful default and confirm.
  54. 1. **Content & audience.** What's the deck about, how many slides, who's
  55. watching (engineers / execs / 小红书读者 / 学生 / VC)?
  56. 2. **Style / theme.** Which of the 36 themes fits? If unsure, recommend 2-3
  57. candidates based on tone:
  58. - Business / investor pitch → `pitch-deck-vc`, `corporate-clean`, `swiss-grid`
  59. - Tech sharing / engineering → `tokyo-night`, `dracula`, `catppuccin-mocha`,
  60. `terminal-green`, `blueprint`
  61. - 小红书图文 → `xiaohongshu-white`, `soft-pastel`, `rainbow-gradient`,
  62. `magazine-bold`
  63. - Academic / report → `academic-paper`, `editorial-serif`, `minimal-white`
  64. - Edgy / cyber / launch → `cyberpunk-neon`, `vaporwave`, `y2k-chrome`,
  65. `neo-brutalism`
  66. 3. **Starting point.** One of the 15 full-deck templates, or scratch? Point
  67. to the closest `templates/full-decks/<name>/` and ask if it fits. If the
  68. user's content suggests something obvious (e.g. "我要做产品发布会" →
  69. `product-launch`), propose it confidently instead of asking blindly.
  70. A good opening message looks like:
  71. > 我可以给你做这份 PPT!先确认三件事:
  72. > 1. 大致内容 / 页数 / 观众是谁?
  73. > 2. 风格偏好?我建议从这 3 个主题里选一个:`tokyo-night`(技术分享默认好看)、`xiaohongshu-white`(小红书风)、`corporate-clean`(正式汇报)。
  74. > 3. 要不要用我现成的 `tech-sharing` 全 deck 模板打底?
  75. Only after those are clear, scaffold the deck and start writing.
  76. ## Quick start
  77. 1. **Scaffold a new deck.** From the repo root:
  78. ```bash
  79. ./scripts/new-deck.sh my-talk
  80. open examples/my-talk/index.html
  81. ```
  82. 2. **Pick a theme.** Open the deck and press `T` to cycle. Or hard-code it
  83. (`../assets/` here is a placeholder — use whatever prefix the rest of the
  84. file already uses; `new-deck.sh` has set it to the right depth):
  85. ```html
  86. <link rel="stylesheet" id="theme-link" href="../assets/themes/aurora.css">
  87. ```
  88. Catalog in [references/themes.md](references/themes.md).
  89. 3. **Pick layouts.** Copy `<section class="slide">...</section>` blocks out of
  90. files in `templates/single-page/` into your deck. Replace the demo data.
  91. Catalog in [references/layouts.md](references/layouts.md).
  92. 4. **Add animations.** Put `data-anim="fade-up"` (or `class="anim-fade-up"`) on
  93. any element. On `<ul>`/grids, use `anim-stagger-list` for sequenced reveals.
  94. For canvas FX, use `<div data-fx="knowledge-graph">...</div>` and include
  95. `<script src="../assets/animations/fx-runtime.js"></script>`.
  96. Catalog in [references/animations.md](references/animations.md).
  97. 5. **Use a full-deck template.** Scaffold from it, don't copy it by hand —
  98. the template's `../../../assets/` is relative to *its own* location, so a
  99. manual copy lands the paths at the wrong depth:
  100. ```bash
  101. ./scripts/new-deck.sh my-talk -t pitch-deck
  102. ```
  103. Each folder is self-contained with scoped CSS. Catalog in
  104. [references/full-decks.md](references/full-decks.md) and gallery at
  105. `templates/full-decks-index.html`.
  106. 6. **Render to PNG.**
  107. ```bash
  108. ./scripts/render.sh templates/theme-showcase.html # one shot
  109. ./scripts/render.sh examples/my-talk/index.html 12 # 12 slides
  110. ```
  111. ## Authoring rules (important)
  112. - **Always start from a template.** Don't author slides from scratch — copy the
  113. closest layout from `templates/single-page/` first, then replace content.
  114. - **Use tokens, not literal colors.** Every color, radius, shadow should come
  115. from CSS variables defined in `assets/base.css` and overridden by a theme.
  116. Good: `color: var(--text-1)`. Bad: `color: #111`.
  117. Text on top of an `--accent` fill is the one people get wrong: it needs
  118. `color: var(--accent-ink)`, because accents here run from `#ffffff` to
  119. `#000000` and no literal ink is readable on all of them.
  120. - **Don't invent new layout files.** Prefer composing existing ones. Only add
  121. a new `templates/single-page/*.html` if none of the 36 fit.
  122. - **Putting images on a slide?** Start from one of the five `image-*` layouts and
  123. use `.img-frame` — see *Images* below. Never drop a bare `<img>` into a slide:
  124. an unframed image ignores the slide's height and pushes the rest off the page.
  125. - **Respect chrome slots.** `.deck-header`, `.deck-footer`, `.slide-number`
  126. and the progress bar are provided by `assets/base.css` + `runtime.js`.
  127. - **Add a logo declaratively, once.** Put `data-logo` on `<body>` — don't paste
  128. an `<img>` into every slide. See *Custom logo* below.
  129. - **Keyboard-first.** Always include the runtime, e.g.
  130. `<script src="../assets/runtime.js"></script>`, so the deck supports
  131. ← → / T / A / F / S / O / hash deep-links.
  132. - **Never hand-edit the `../` depth in asset paths.** Every `assets/` reference
  133. is relative to the file that holds it: `templates/deck.html` uses
  134. `../assets/`, `templates/single-page/*.html` use `../../assets/`, and
  135. `templates/full-decks/*/index.html` use `../../../assets/`. Copying a file to
  136. a new depth silently breaks all of them. Scaffold with
  137. `./scripts/new-deck.sh <name> [parent] [-t <template>]`, which computes the
  138. prefix for wherever the deck lands and verifies every reference resolves.
  139. - **One `.slide` per logical page.** `runtime.js` makes `.slide.is-active`
  140. visible; all others are hidden.
  141. - **Supply notes.** Wrap speaker notes in `<div class="notes">…</div>` inside
  142. each slide. Press S to open the overlay.
  143. - **NEVER put presenter-only text on the slide itself.** Descriptive text like
  144. "这一页展示了……" or "Speaker: 这里可以补充……" or small explanatory captions
  145. aimed at the presenter MUST go inside `<div class="notes">`, NOT as visible
  146. `<p>` / `<span>` elements on the slide. The `.notes` class is `display:none`
  147. by default — it only appears in the S overlay. Slides should contain ONLY
  148. audience-facing content (titles, bullet points, data, charts, images).
  149. ## Images
  150. Five layouts in `templates/single-page/` take real images. Pick by how many
  151. images the page has to carry:
  152. | I have… | Use | Why |
  153. |---|---|---|
  154. | one screenshot / diagram / chart | `image-single.html` | `.img-frame.contain` — letterboxed, **never cropped** |
  155. | one photo that should carry the page | `image-full-bleed.html` | fills the slide, gradient scrim keeps the title readable |
  156. | one image plus an argument | `image-text-split.html` | 50/50; add `flip` to `.split` to move the image right |
  157. | 3–6 images | `image-gallery.html` | uniform grid; mixed source ratios are normalised by the frame |
  158. | a before and an after | `image-compare.html` | both sides identical size, conclusion under each |
  159. `image-grid.html` and `image-hero.html` are **not** in this list: they are
  160. gradient-placeholder layouts with no `<img>` at all. Reach for them when you
  161. want the shape of a bento wall without supplying pictures.
  162. All five are built on one primitive from `assets/base.css`:
  163. ```html
  164. <figure class="img-frame"><img src="shot.png" alt=""></figure>
  165. <figure class="img-frame contain" style="--img-ratio:4/3"><img src="diagram.svg" alt=""></figure>
  166. ```
  167. - `.img-frame` owns the **aspect ratio and the crop**; the `<img>` fills it with
  168. `object-fit: cover`. That's what lets a user swap in a photo of any shape
  169. without the layout breaking.
  170. - `.img-frame.contain` letterboxes instead of cropping — **always use it for
  171. screenshots, diagrams and logos.**
  172. - `--img-ratio` (default `16/10`) and `--img-pos` (`object-position`) tune it.
  173. - `.img-scrim` / `.img-cap` / `.img-tag` are the scrim, caption and corner pill.
  174. - Images referenced from a deck are resolved relative to the deck's own
  175. `index.html` — keep them in the deck folder, e.g. `examples/my-talk/shot.png`.
  176. - `assets/demo-images/` holds the placeholder artwork used by these layouts:
  177. hand-written SVG, ~1 KB each, **no network needed**.
  178. ## Custom logo
  179. To brand a deck with a company / product logo, declare it once on `<body>`:
  180. ```html
  181. <body data-logo="logo.svg"
  182. data-logo-position="bottom-right"
  183. data-logo-size="40px">
  184. ```
  185. | Attribute | Default | Notes |
  186. |---|---|---|
  187. | `data-logo` | — | Image URL, relative to the deck's own HTML file. Required. |
  188. | `data-logo-position` | `top-right` | `top-left` / `top-right` / `bottom-left` / `bottom-right` |
  189. | `data-logo-size` | `44px` | Any CSS length; sets the logo's **height**, width follows the aspect ratio |
  190. | `data-logo-opacity` | `.9` | `1` for full strength |
  191. | `data-logo-alt` | `""` | Alt text |
  192. - **Skip it on one slide** with `<section class="slide" data-no-logo>` — usually
  193. the cover and any full-bleed image slide that carries its own branding.
  194. - **Fine-tune the inset** with `--logo-inset-x` / `--logo-inset-y` on `.deck-logo`.
  195. - **Place it by hand** instead, if you want it inside the chrome slots or in a
  196. spot the four presets don't cover:
  197. ```html
  198. <div class="deck">
  199. <img class="deck-logo" data-pos="bottom-left" src="logo.svg" alt="">
  200. ```
  201. This path needs no JS at all — `base.css` styles both the same way.
  202. - The logo shows in the **presenter preview**, and on **every page of a
  203. print/PDF export** (unlike the header/footer/progress chrome, which print
  204. hides). `data-no-logo` slides are skipped there too. Per-page printing is
  205. painted by `runtime.js` + `@media print`; a deck that omits the runtime still
  206. gets the logo on screen, but only on one page of a PDF.
  207. ## Writing guide
  208. See [references/authoring-guide.md](references/authoring-guide.md) for a
  209. step-by-step walkthrough: file structure, naming, how to transform an outline
  210. into a deck, how to choose layouts and themes per audience, how to do a
  211. Chinese + English deck, and how to export.
  212. ## Catalogs (load when needed)
  213. - [references/themes.md](references/themes.md) — all 36 themes with when-to-use.
  214. - [references/layouts.md](references/layouts.md) — all 36 layout types.
  215. - [references/animations.md](references/animations.md) — 27 CSS + 20 canvas FX animations.
  216. - [references/full-decks.md](references/full-decks.md) — all 15 full-deck templates.
  217. - [references/presenter-mode.md](references/presenter-mode.md) — **演讲者模式 + 逐字稿编写指南(技术分享/演讲必看)**.
  218. - [references/authoring-guide.md](references/authoring-guide.md) — full workflow.
  219. ## File structure
  220. ```
  221. html-ppt/
  222. ├── SKILL.md (this file)
  223. ├── references/ (detailed catalogs, load as needed)
  224. ├── assets/
  225. │ ├── base.css (tokens + primitives — do not edit per deck)
  226. │ ├── demo-images/*.svg (tiny offline placeholders for the image-* layouts)
  227. │ ├── fonts.css (webfont imports)
  228. │ ├── runtime.js (keyboard + presenter + overview + theme cycle)
  229. │ ├── themes/*.css (36 token overrides, one per theme)
  230. │ └── animations/
  231. │ ├── animations.css (27 named CSS entry animations)
  232. │ ├── fx-runtime.js (auto-init [data-fx] on slide enter)
  233. │ └── fx/*.js (20 canvas FX modules: particles/graph/fireworks…)
  234. ├── templates/
  235. │ ├── deck.html (minimal 6-slide starter)
  236. │ ├── theme-showcase.html (36 slides, iframe-isolated per theme)
  237. │ ├── layout-showcase.html (iframe tour of all 36 layouts)
  238. │ ├── animation-showcase.html (20 FX + 27 CSS animation slides)
  239. │ ├── full-decks-index.html (gallery of all 15 full-deck templates)
  240. │ ├── full-decks/<name>/ (15 scoped multi-slide deck templates)
  241. │ └── single-page/*.html (36 layout files with demo data)
  242. ├── scripts/
  243. │ ├── new-deck.sh (scaffold a deck from deck.html)
  244. │ └── render.sh (headless Chrome → PNG)
  245. └── examples/demo-deck/ (complete working deck)
  246. ```
  247. ## Rendering to PNG
  248. `scripts/render.sh` wraps headless Chrome at
  249. `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`. For multi-slide
  250. capture, runtime.js exposes `#/N` deep-links, and render.sh iterates 1..N.
  251. ```bash
  252. ./scripts/render.sh templates/single-page/kpi-grid.html # single page
  253. ./scripts/render.sh examples/demo-deck/index.html 8 out-dir # 8 slides, custom dir
  254. ```
  255. ## Keyboard cheat sheet
  256. ```
  257. ← → Space PgUp PgDn Home End navigate
  258. swipe left / right (touch) navigate — phones and tablets, no keyboard needed
  259. F fullscreen
  260. S open presenter window (magnetic cards: current/next/script/timer)
  261. N quick notes drawer (bottom overlay)
  262. R reset timer (in presenter window)
  263. ?preview=N URL param — force preview-only mode (single slide, no chrome)
  264. O slide overview grid
  265. T cycle themes (reads data-themes attr)
  266. A cycle demo animation on current slide
  267. #/N in URL deep-link to slide N
  268. Esc close all overlays
  269. ```
  270. ## License & author
  271. MIT. Copyright (c) 2026 lewis &lt;sudolewis@gmail.com&gt;.
README.md · README · 343 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # html-ppt — HTML PPT Studio
  2. > A world-class AgentSkill for producing professional HTML presentations in
  3. > **36 themes**, **15 full-deck templates**, **36 page layouts**,
  4. > **47 animations** (27 CSS + 20 canvas FX), and a **true presenter mode**
  5. > with pixel-perfect previews + speaker script + timer — all pure static
  6. > HTML/CSS/JS, no build step.
  7. **Author:** lewis &lt;sudolewis@gmail.com&gt;
  8. **License:** MIT
  9. **中文文档:** [README.zh-CN.md](README.zh-CN.md)
  10. ![html-ppt — cover with live previews](docs/readme/hero.gif)
  11. > One command installs **36 themes × 20 canvas FX × 36 layouts × 15 full decks + presenter mode**. Every preview above is a live iframe of a real template file rendering inside the deck — no screenshots, no mock-ups.
  12. ## 🎤 Presenter Mode (new!)
  13. Press `S` on any deck to pop open a dedicated presenter window with four
  14. draggable, resizable **magnetic cards**: current slide, next slide preview,
  15. speaker script (逐字稿), and timer. Two windows stay in sync via
  16. `BroadcastChannel`.
  17. ![Presenter mode with 4 magnetic cards](docs/readme/presenter-mode.png)
  18. **Why previews are pixel-perfect:** each card is an `<iframe>` that loads the
  19. same deck HTML with a `?preview=N` query param. The runtime detects this and
  20. renders only slide N with no chrome — so the preview uses the **same CSS,
  21. theme, fonts and viewport** as the audience view. Colors and layout are
  22. guaranteed identical.
  23. **Smooth (no-reload) navigation:** on slide change, the presenter window
  24. sends `postMessage({type:'preview-goto', idx:N})` to each iframe. The iframe
  25. just toggles `.is-active` between slides — **no reload, no flicker**.
  26. **Speaker script rules (3 golden):**
  27. 1. **Prompt signals, not lines to read** — bold the keywords, separate
  28. transition sentences into their own paragraphs
  29. 2. **150–300 words per slide** — that's the ~2–3 min/page pace
  30. 3. **Write it like you speak** — conversational, not written prose
  31. See [`references/presenter-mode.md`](references/presenter-mode.md) for the
  32. full authoring guide, or copy the ready-made template at
  33. `templates/full-decks/presenter-mode-reveal/` which ships with full 150-300
  34. word speaker scripts on every slide.
  35. ## Install (one command)
  36. ```bash
  37. npx skills add https://github.com/lewislulu/html-ppt-skill
  38. ```
  39. That registers the skill with your agent runtime. After install, any agent
  40. that supports AgentSkills can author presentations by asking things like:
  41. > "做一份 8 页的技术分享 slides,用 cyberpunk 主题"
  42. > "turn this outline into a pitch deck"
  43. > "做一个小红书图文,9 张,白底柔和风"
  44. ## Offline / manual install
  45. `npx skills add <url>` needs network on the target machine. Three alternatives,
  46. in decreasing order of how much network they need.
  47. **1. Install from a local copy.** Fetch the repo anywhere, move the folder over
  48. (git, zip, USB), then point the CLI at the directory instead of the URL:
  49. ```bash
  50. git clone https://github.com/lewislulu/html-ppt-skill
  51. npx skills add ./html-ppt-skill
  52. ```
  53. `npx` still downloads the `skills` package itself once. For a fully air-gapped
  54. machine, run `npm i -g skills` on a connected one first, or use method 2.
  55. **2. Copy it in by hand — no Node, no CLI.** A skill is just a folder with
  56. `SKILL.md` at its root. Drop it in the directory your agent scans:
  57. | Agent | Project scope | Global scope |
  58. |---|---|---|
  59. | Claude Code | `.claude/skills/html-ppt/` | `~/.claude/skills/html-ppt/` |
  60. | Codex | `.agents/skills/html-ppt/` | `~/.codex/skills/html-ppt/` |
  61. | Cursor | `.agents/skills/html-ppt/` | `~/.cursor/skills/html-ppt/` |
  62. | OpenCode | `.agents/skills/html-ppt/` | `~/.config/opencode/skills/html-ppt/` |
  63. | Gemini CLI | `.agents/skills/html-ppt/` | `~/.gemini/skills/html-ppt/` |
  64. | Windsurf | `.windsurf/skills/html-ppt/` | `~/.codeium/windsurf/skills/html-ppt/` |
  65. ```bash
  66. mkdir -p ~/.claude/skills
  67. cp -R html-ppt-skill ~/.claude/skills/html-ppt
  68. ls ~/.claude/skills/html-ppt/SKILL.md # must exist
  69. ```
  70. Only `SKILL.md`, `assets/`, `templates/`, `references/` and `scripts/` are
  71. needed at runtime. `docs/` is ~4.6 MB of README artwork and can be dropped from
  72. an offline copy.
  73. **3. No agent at all.** The templates are plain static files — usable directly:
  74. ```bash
  75. ./scripts/new-deck.sh my-talk
  76. open examples/my-talk/index.html
  77. ```
  78. ### Does it run without a network?
  79. Yes, with one caveat. Themes, layouts, animations, presenter mode and PNG
  80. rendering are all local static HTML/CSS/JS with no build step and no runtime
  81. fetches. The single remote dependency is `assets/fonts.css`, which `@import`s
  82. Google Fonts.
  83. Offline, those imports simply fail and the browser falls back to the system
  84. stack already declared in `assets/base.css` (`-apple-system` / Helvetica /
  85. Georgia / Menlo), so decks render correctly — just in different typefaces. To
  86. pin typography offline, replace `assets/fonts.css` with `@font-face` rules
  87. pointing at font files you ship yourself, or delete the imports and accept the
  88. system stack.
  89. ## What's in the box
  90. | | Count | Where |
  91. |---|---|---|
  92. | 🎤 **Presenter mode** | **NEW** | `S` key / `?preview=N` |
  93. | 🎨 **Themes** | **36** | `assets/themes/*.css` |
  94. | 📑 **Full-deck templates** | **15** | `templates/full-decks/<name>/` |
  95. | 🧩 **Single-page layouts** | **36** | `templates/single-page/*.html` |
  96. | ✨ **CSS animations** | **27** | `assets/animations/animations.css` |
  97. | 💥 **Canvas FX animations** | **20** | `assets/animations/fx/*.js` |
  98. | 🖼️ **Showcase decks** | 4 | `templates/*-showcase.html` |
  99. | 📸 **Verification screenshots** | 56 | `scripts/verify-output/` |
  100. ### 36 Themes
  101. `minimal-white`, `editorial-serif`, `soft-pastel`, `sharp-mono`, `arctic-cool`,
  102. `sunset-warm`, `catppuccin-latte`, `catppuccin-mocha`, `dracula`, `tokyo-night`,
  103. `nord`, `solarized-light`, `gruvbox-dark`, `rose-pine`, `neo-brutalism`,
  104. `glassmorphism`, `bauhaus`, `swiss-grid`, `terminal-green`, `xiaohongshu-white`,
  105. `rainbow-gradient`, `aurora`, `blueprint`, `memphis-pop`, `cyberpunk-neon`,
  106. `y2k-chrome`, `retro-tv`, `japanese-minimal`, `vaporwave`, `midcentury`,
  107. `corporate-clean`, `academic-paper`, `news-broadcast`, `pitch-deck-vc`,
  108. `magazine-bold`, `engineering-whiteprint`.
  109. ![36 themes · 8 of them](docs/readme/themes.png)
  110. Each is a pure CSS-tokens file — swap one `<link>` to reskin the entire deck.
  111. Browse them all in `templates/theme-showcase.html` (each slide rendered in an
  112. isolated iframe so theme ≠ theme is visually guaranteed).
  113. ![15 full-deck templates](docs/readme/templates.png)
  114. ### 15 Full-deck templates
  115. Eight extracted from real-world decks, seven generic scenario scaffolds:
  116. **Extracted looks**
  117. - `xhs-white-editorial` — 小红书白底杂志风
  118. - `graphify-dark-graph` — 暗底 + 力导向知识图谱
  119. - `knowledge-arch-blueprint` — 蓝图 / 架构图风
  120. - `hermes-cyber-terminal` — 终端 cyberpunk
  121. - `obsidian-claude-gradient` — 紫色渐变卡
  122. - `testing-safety-alert` — 红 / 琥珀警示风
  123. - `xhs-pastel-card` — 柔和马卡龙图文
  124. - `dir-key-nav-minimal` — 方向键极简
  125. **Scenario decks**
  126. - `pitch-deck`, `product-launch`, `tech-sharing`, `weekly-report`,
  127. `xhs-post` (9-slide 3:4), `course-module`,
  128. **`presenter-mode-reveal`** 🎤 — complete talk template with full 150-300
  129. word speaker scripts on every slide, designed around the `S` key presenter mode
  130. Each is a self-contained folder with scoped `.tpl-<name>` CSS so multiple
  131. decks can be previewed side-by-side without collisions. Browse the full
  132. gallery in `templates/full-decks-index.html`.
  133. ![31 single-page layouts](docs/readme/layouts.png)
  134. ### 36 Single-page layouts
  135. cover · toc · section-divider · bullets · two-column · three-column ·
  136. big-quote · stat-highlight · kpi-grid · table · code · diff · terminal ·
  137. flow-diagram · timeline · roadmap · mindmap · comparison · pros-cons ·
  138. todo-checklist · gantt · image-hero · image-grid · chart-bar · chart-line ·
  139. chart-pie · chart-radar · arch-diagram · process-steps · cta · thanks
  140. Every layout ships with realistic demo data so you can drop it into a deck
  141. and immediately see it render.
  142. ![36 layouts auto-cycling through real template files](docs/readme/layouts-live.gif)
  143. *The big iframe is loading `templates/single-page/<name>.html` directly and cycling through all 36 layouts every 2.8 seconds.*
  144. ![47 animations — 27 CSS + 20 canvas FX](docs/readme/animations.png)
  145. ### 27 CSS animations + 20 Canvas FX
  146. **CSS (lightweight)** — directional fades, `rise-in`, `zoom-pop`, `blur-in`,
  147. `glitch-in`, `typewriter`, `neon-glow`, `shimmer-sweep`, `gradient-flow`,
  148. `stagger-list`, `counter-up`, `path-draw`, `morph-shape`, `parallax-tilt`,
  149. `card-flip-3d`, `cube-rotate-3d`, `page-turn-3d`, `perspective-zoom`,
  150. `marquee-scroll`, `kenburns`, `ripple-reveal`, `spotlight`, …
  151. **Canvas FX (cinematic)** — `particle-burst`, `confetti-cannon`, `firework`,
  152. `starfield`, `matrix-rain`, `knowledge-graph` (force-directed physics),
  153. `neural-net` (signal pulses), `constellation`, `orbit-ring`, `galaxy-swirl`,
  154. `word-cascade`, `letter-explode`, `chain-react`, `magnetic-field`,
  155. `data-stream`, `gradient-blob`, `sparkle-trail`, `shockwave`,
  156. `typewriter-multi`, `counter-explosion`. Each is a real hand-rolled canvas
  157. module auto-initialised on slide enter via `fx-runtime.js`.
  158. ## Quick start (manual, after install or git clone)
  159. ```bash
  160. # Scaffold a new deck from the base template
  161. ./scripts/new-deck.sh my-talk
  162. # ...or from a full-deck template, into any directory you like.
  163. # Asset paths are computed for wherever the deck lands, then verified.
  164. ./scripts/new-deck.sh my-talk ~/decks -t pitch-deck
  165. # Browse everything
  166. open templates/theme-showcase.html # all 36 themes (iframe-isolated)
  167. open templates/layout-showcase.html # all 36 layouts
  168. open templates/animation-showcase.html # all 47 animations
  169. open templates/full-decks-index.html # all 15 full decks
  170. # Render any template to PNG via headless Chrome
  171. ./scripts/render.sh templates/theme-showcase.html
  172. ./scripts/render.sh examples/my-talk/index.html 12
  173. ```
  174. ## Images on a slide
  175. Five layouts take real images — pick by how many the page has to carry:
  176. | I have… | Layout |
  177. |---|---|
  178. | one screenshot / diagram / chart | `image-single.html` — letterboxed, never cropped |
  179. | one photo that should carry the page | `image-full-bleed.html` — fills the slide, scrim keeps the title readable |
  180. | one image plus an argument | `image-text-split.html` — 50/50, `flip` to swap sides |
  181. | 3–6 images | `image-gallery.html` — uniform grid, one caption each |
  182. | a before and an after | `image-compare.html` — both sides identical size |
  183. They share one primitive from `assets/base.css`:
  184. ```html
  185. <figure class="img-frame"><img src="shot.png" alt=""></figure> <!-- crops to fill -->
  186. <figure class="img-frame contain"><img src="diagram.svg" alt=""></figure> <!-- letterboxed -->
  187. ```
  188. The frame owns the aspect ratio (`--img-ratio`) and the crop, so you can drop in
  189. a portrait, square or ultrawide image without touching the layout. Placeholder
  190. artwork in `assets/demo-images/` is hand-written SVG (~1 KB each) so every
  191. layout renders **offline**.
  192. ## Custom logo
  193. Brand a deck with one attribute — no per-slide `<img>` copy-paste:
  194. ```html
  195. <body data-logo="logo.svg" data-logo-position="bottom-right" data-logo-size="40px">
  196. ```
  197. `data-logo-position` takes `top-left` / `top-right` / `bottom-left` /
  198. `bottom-right` (default `top-right`); `data-logo-size` sets the height.
  199. Skip it on a single slide with `<section class="slide" data-no-logo>` — handy
  200. for the cover. The logo also shows in the presenter preview, and on **every
  201. page** of a PDF export (skipping the `data-no-logo` ones).
  202. Prefer to place it yourself? `<img class="deck-logo" data-pos="top-left" src="logo.svg">`
  203. inside `.deck` works with no JS at all.
  204. ## Keyboard cheat sheet
  205. On a phone or tablet, **swipe left for the next slide, right for the previous
  206. one** — no keyboard needed. Pinch-zoom, vertical scrolling, the overview grid
  207. and the notes drawer are left alone.
  208. ```
  209. ← → Space PgUp PgDn Home End navigate
  210. swipe ← / → (touch) navigate
  211. F fullscreen
  212. S open presenter window (magnetic cards)
  213. N quick notes drawer (bottom)
  214. R reset timer (in presenter window)
  215. O slide overview grid
  216. T cycle themes (syncs to presenter)
  217. A cycle a demo animation on current slide
  218. #/N (URL) deep-link to slide N
  219. ?preview=N (URL) preview-only mode (single slide, no chrome)
  220. ```
  221. ## Project structure
  222. ```
  223. html-ppt-skill/
  224. ├── SKILL.md agent-facing dispatcher
  225. ├── README.md this file
  226. ├── references/ detailed catalogs
  227. │ ├── themes.md 36 themes with when-to-use
  228. │ ├── layouts.md 31 layout types
  229. │ ├── animations.md 27 CSS + 20 FX catalog
  230. │ ├── full-decks.md 15 full-deck templates
  231. │ └── authoring-guide.md full workflow
  232. ├── assets/
  233. │ ├── base.css shared tokens + primitives
  234. │ ├── fonts.css webfont imports
  235. │ ├── runtime.js keyboard + presenter + overview
  236. │ ├── themes/*.css 36 theme token files
  237. │ └── animations/
  238. │ ├── animations.css 27 named CSS animations
  239. │ ├── fx-runtime.js auto-init [data-fx] on slide enter
  240. │ └── fx/*.js 20 canvas FX modules
  241. ├── templates/
  242. │ ├── deck.html minimal starter
  243. │ ├── theme-showcase.html iframe-isolated theme tour
  244. │ ├── layout-showcase.html all 36 layouts
  245. │ ├── animation-showcase.html 47 animation slides
  246. │ ├── full-decks-index.html 15-deck gallery
  247. │ ├── full-decks/<name>/ 15 scoped multi-slide decks
  248. │ └── single-page/*.html 31 layout files with demo data
  249. ├── scripts/
  250. │ ├── new-deck.sh scaffold
  251. │ ├── render.sh headless Chrome → PNG
  252. │ └── verify-output/ 56 self-test screenshots
  253. └── examples/demo-deck/ complete working deck
  254. ```
  255. ## Philosophy
  256. - **Token-driven design system.** All color, radius, shadow, font decisions
  257. live in `assets/base.css` + the current theme file. Change one variable,
  258. the whole deck reflows tastefully.
  259. - **Iframe isolation for previews.** Theme / layout / full-deck showcases all
  260. use `<iframe>` per slide so each preview is a real, independent render.
  261. - **Zero build.** Pure static HTML/CSS/JS. CDN only for webfonts, highlight.js
  262. and chart.js (optional).
  263. - **Senior-designer defaults.** Opinionated type scale, spacing rhythm,
  264. gradients and card treatments — no "Corporate PowerPoint 2006" vibes.
  265. - **Chinese + English first-class.** Noto Sans SC / Noto Serif SC pre-imported.
  266. ## License
  267. MIT © 2026 lewis &lt;sudolewis@gmail.com&gt;.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.