nice-html-slides
Lively HTML slide decks (speaker-led by default, reading-first on request) built on frontend-slides, with optional 3D props and mascots, auto-playing entrances, slide transitions, styled 2D charts, automated visual checks, and PDF/hybrid PPTX export on request. Use when the user wants an HTML presentation that feels animated and polished, wants 3D accents or props in slides, or asks for nice-html-slides by name.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/alvin-andrada--nice-html-slides)HTML
<a href="/listings/alvin-andrada--nice-html-slides"><img src="/api/listings/alvin-andrada--nice-html-slides/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Install the `frontend-slides` skill. 2. Clone this repo into your skills directory, for example:
git clone https://github.com/alvin-andrada/nice-html-slides.git ~/.claude/skills/nice-html-slides
3. Have Node.js and Python 3 installed. The agent runs the one-time setup (`python scripts/setup.py`) on first use, or run it yourself.
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 · 81 lines
- ---
- name: nice-html-slides
- description: Lively HTML slide decks (speaker-led by default, reading-first on request) built on frontend-slides, with optional 3D props and mascots, auto-playing entrances, slide transitions, styled 2D charts, automated visual checks, and PDF/hybrid PPTX export on request. Use when the user wants an HTML presentation that feels animated and polished, wants 3D accents or props in slides, or asks for nice-html-slides by name.
- ---
- # nice-html-slides
- An extension layer for the `frontend-slides` skill. frontend-slides owns content discovery, style discovery and the visual system. This skill adds props and mascots, motion, chart rendering, a build step that produces one self-contained HTML file, automated checks, and exports.
- Read `RULES.md` before generating. It is the full rule set; the summary below is the order of work.
- ## Requirements and first use
- - The `frontend-slides` skill must be installed next to this one. Load its SKILL.md at the start of every deck and follow its phases; this skill only changes the points listed below. If it is missing, tell the user to install it (https://github.com/zarazhangrui/frontend-slides) and stop.
- - Node.js and Python 3. When `node_modules/` is missing in this folder, run `python scripts/setup.py` yourself (npm packages, `playwright`, `pillow`, `python-pptx`, Chromium) before building.
- ## Workflow
- ### 1. Content (frontend-slides Phase 1, with one addition)
- - Ask frontend-slides' questions as written, including density: speaker-led (low density) or reading-first (high density). Recommend speaker-led for live talks and use it when the user does not answer. The choice sets the type scale in `RULES.md` and the font floor for the checks.
- - Add one question about accents, with these options described in plain words:
- - **None**: typography and charts carry the deck. Lightest file, most formal.
- - **Content props**: small objects tied to each slide's point (a trophy for the best model, a magnifier on an error). Adds about 550 KB when 3D.
- - **Mascot**: one recurring character that reacts to content, only when the topic suggests one.
- - **2D or 3D**: flat SVG sprites are lighter; 3D gives depth and characters that move between slides.
- ### 2. Style (frontend-slides Phase 2)
- - Generate the three previews exactly as frontend-slides prescribes, using its presets and its bold template pack (`selection-index.json` first, a candidate's `preview.md` for previews, the picked template's full `design.md` before generating). The style decides the look.
- - Where accents are wanted, give each preview a different accent option, so style and accent are chosen together.
- - Formal or public talks: pick styles by catalog metadata (formality, mood, tone). If none fit or the fitting ones were used, use the custom wildcard path in the same register.
- - Previews are single files with `<!--@BASE@-->` and `<!--@FIT@-->` markers; build them with `python build.py preview.html`.
- ### 3. Generate the deck
- Start from frontend-slides' HTML architecture, then apply this skill's conventions:
- - In `<style>`: `/*@FONTS:Display Font,Body Font@*/` (fonts are inlined from fontsource, installed on demand; static fonts take weights and italics in brackets, e.g. `Barlow[400 500 900]`, `Source Serif 4[italic]`; default 400 and 700) and `/*@NICE_CSS@*/`.
- - Before `</body>`: `<!--@STAGE3D@-->` when the deck uses props, mascots, charts or motion; then optionally `<script>window.NICE_MOTION = {...}</script>`; then `<!--@NICE_JS@-->` (navigation, auto builds, transitions, inline editing). Do not write a slide controller by hand.
- - Slide container: `<main class="deck-stage" id="deckStage">` with `<section class="slide">` children, as in frontend-slides.
- - Theme the accent layer from the style's tokens with CSS variables on `:root`: `--s3d-adelie`-style species/series colours are optional; the general ones are `--s3d-body`, `--s3d-outline`, `--s3d-outline-width`. Prop colours come from `--s3d-prop-main`, `--s3d-prop-dark`, `--s3d-prop-light`, `--s3d-prop-accent`; set them on `:root`, or per slide class when slide backgrounds alternate. Style 2D charts in the deck CSS (`.chart2d rect`, `.chart2d .v`, `.chart2d .tick`, ...).
- - Layout: content on a card lives inside that card, laid out with padding and grid/flex. Absolute positioning only for whole blocks.
- Data attributes:
- | Attribute | On | Meaning |
- |---|---|---|
- | `data-step="n"` | any element | plays in n groups after the slide enters (auto); click-driven only with `data-builds="click"` on the stage |
- | `data-chart="bars\|hbars\|matrix\|scatter"` | `.chart` | 2D SVG chart; also `data-values`, `data-colors`, `data-min`, `data-max`, `data-labels="values"`, `data-format="{v}%"`, `data-names`, `data-off`, `data-empty`, `data-axes`, `data-keys` (scatter fields; axis ranges fit the data) |
- | `data-depth="3d"` | `.chart` | 3D chart instead of 2D; only when the user asks |
- | `data-penguin="kind"` | `.p3d` anchor | mascot placed in the anchor box; `data-act` (idle, wave, jump, celebrate, confused), `data-face` (degrees), `data-on="i"` (stand on bar i), `data-z` (depth layer) |
- | `data-prop="name"` | `.prop` anchor | low-poly prop fitted to the anchor box; `data-anim="spin"` only for props that read well from every angle; `data-z` |
- | `data-overlap-ok` | `.prop` | a deliberate overlap the checks should allow |
- | class `inl` | `.p3d`/`.prop` | anchor that sits in the layout flow (inside flex rows) |
- The built-in mascot is a penguin (`adelie`, `chinstrap`, `gentoo`) and the props are `ruler`, `broom`, `pie`, `forest`, `trophy`, `magnifier`, `flag`, `iceberg`, `laptop`, `router`, `server`, `globe`, `packet` (`runtime/props.js`). For other topics, add a builder to `runtime/props.js` from primitives in the same style: toon materials from `mats(p)` so the palette applies, `userData.h` set. Props are centred and fitted to their anchor box automatically. Every new prop goes through the turntable check.
- ### 4. Build and check (every change)
- ```
- python build.py path/to/deck.html # -> path/to/dist/deck.html
- python scripts/qa.py path/to/dist/deck.html # must print "ok"; add --min 22 for reading-first decks
- python build.py qa/props.html && python scripts/turntable.py qa/dist/props.html turntable.png # after any prop change
- python scripts/sheet.py path/to/dist/deck.html sheet.png # look at it
- python scripts/sheet.py path/to/dist/deck.html film.png --film 8 # when motion changed
- ```
- Fix what the checks report, rerun until clean, then look at the sheet. A visible problem the checks missed becomes a new check in `scripts/qa.py` that flags the old build, before fixing the deck.
- Token discipline: never open `node_modules/`, `.build/`, `dist/` HTML, or inlined base64. Edit the source deck and runtime files only.
- ### 5. Iterate
- Edit the HTML source only. Do not export while iterating.
- ### 6. Export (only when the deck is final or the user asks)
- ```
- python scripts/export.py path/to/dist/deck.html --pdf deck.pdf --pptx deck.pptx --notes
- ```
- PDF: one image per slide at final state. PPTX (hybrid): native text boxes, native charts and tables, decor and 3D as an image layer. Use `--charts image` to keep charts as pictures. After exporting, render the PPTX once and check it.
- ## Examples
- Syntax references only. Never copy an example's style, wording, mascot or props into a new deck; the style comes from frontend-slides and the props come from the new deck's content.
- - `examples/palmer-penguins/deck.html`: mascots, props, all four chart types.
- - `examples/web-request/deck.html`: props only, per-slide prop palettes on alternating backgrounds.
- - `examples/supply-chain-review/deck.html`: no 3D; charts, builds and transitions only.
README.md · README · 57 lines
- # nice-html-slides
- Lively, speaker-led HTML presentations: one self-contained HTML file per deck, with smooth slide transitions, auto-playing entrances, charts that draw themselves in, and optional low-poly 3D props and mascots that react to each slide's content.
- Built as an agent skill on top of [frontend-slides](https://github.com/zarazhangrui/frontend-slides), which provides the design system (presets, bold templates, the fixed 16:9 stage). This layer adds the accents, motion, checks and exports.
- **Live demos:** https://alvin-andrada.github.io/nice-html-slides/ shows three decks in three styles: playful with mascots, bold with props only, and formal with no 3D.
- ## Features
- - **Design stays with the style.** Colours, fonts and outlines of the 3D layer and charts are read from the chosen style's CSS variables.
- - **Accents that fit the content.** Props change per slide (a trophy for the best model, a magnifier on the one error). Mascots only when the topic calls for one.
- - **Motion without clicking.** Each slide's parts play in automatically; slides transition with lift-away exits and split-text headings; mascots walk between slides. Click builds are available as an opt-in.
- - **2D charts by default** (bars, horizontal bars, confusion matrix, scatter), styled by the deck. 3D charts on request.
- - **One file.** Libraries, fonts and runtime are inlined by `build.py`; the deck works offline.
- - **Automated visual checks.** Text size, contrast, spacing inside cards, overlaps, 3D objects leaving their card or intersecting each other, checked both instantly and after the real animations. Props are rendered from four angles.
- - **Exports on request.** PDF, and a hybrid PPTX with editable text, native charts and tables.
- ## Install
- 1. Install the `frontend-slides` skill.
- 2. Clone this repo into your skills directory, for example:
- ```
- git clone https://github.com/alvin-andrada/nice-html-slides.git ~/.claude/skills/nice-html-slides
- ```
- 3. Have Node.js and Python 3 installed. The agent runs the one-time setup (`python scripts/setup.py`) on first use, or run it yourself.
- ## Usage
- Ask your agent for a presentation and mention nice-html-slides, or let the skill trigger on requests for lively or animated HTML slides. It asks about content, density and accents, shows three style previews, builds the deck, runs the checks, and only exports when you say the deck is final.
- Manual commands:
- ```
- python build.py examples/palmer-penguins/deck.html
- python scripts/qa.py examples/palmer-penguins/dist/deck.html
- python scripts/sheet.py examples/palmer-penguins/dist/deck.html sheet.png
- python scripts/export.py examples/palmer-penguins/dist/deck.html --pdf deck.pdf --pptx deck.pptx
- ```
- ## Layout
- ```
- SKILL.md agent instructions
- RULES.md full rule set (design, layout, motion, checks)
- build.py source deck -> single HTML
- runtime/ stage3d (3D layer), charts2d, props, controller, layer CSS
- scripts/ qa, turntable, sheet (contact sheets), export (PDF/PPTX), site (rebuilds docs/)
- qa/ turntable pages for props and mascots
- examples/ example decks (penguins, web request, supply chain review)
- site/ demo gallery page source
- docs/ built gallery and demos for GitHub Pages
- ```
- ## Credits
- See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.