Create beautiful, zero-dependency HTML presentations that run entirely in the browser — no npm, no build tools. 21 curated style presets with named layout variations, visual style discovery with live previews, viewport-fitted slides, inline browser editing, Presenter Mode, and optional PPTX export. Content-type routing suggests the best style for pitch decks, dev docs, data reports, and more. Supports --plan (outline), --generate (HTML from plan), and --export pptx flags.
SKILL.md
Slide Creator
Generate zero-dependency HTML presentations that run entirely in the browser. This skill guides users from raw ideas to a polished, animated slide deck — using visual style discovery ("show, don't tell") to nail the aesthetic before writing a line of code.
Core Philosophy
Zero Dependencies — Single HTML files with inline CSS/JS. No npm, no build tools.
Show, Don't Tell — People can't articulate design preferences until they see options. Generate visual previews rather than asking abstract questions like "do you want minimalist or bold?"
Distinctive Design — Avoid generic AI aesthetics (Inter font, purple gradients, predictable heroes). Every deck should feel custom-crafted.
Viewport Fitting — Slides must fit exactly in the viewport with no scrolling. Content that overflows gets split across slides, not squished. A presentation that scrolls mid-slide is broken — this is why we enforce density limits.
Plan Before Generate — For complex decks, --plan creates a PLANNING.md outline first; --generate then produces HTML. Separating thinking from execution leads to better structure and less backtracking.
Command Flags
Parse the invocation to determine mode:
--plan [prompt] — Planning mode. Inspect resources/, analyze the prompt, create PLANNING.md. Stop — do NOT generate HTML.
--generate [instructions] — Generation mode. Read PLANNING.md if present (skip Phase 1/2 questions), then generate HTML.
Installs
1
--export pptx [--scale N] — Export the most recently modified HTML as PPTX via the bundled Python script. Requires Python 3 + pip install playwright python-pptx. No Node.js required.
No flag — Auto-detect mode (Phase 0).
Planning Mode (--plan)
Scan resources/ — read text/markdown files, note images. Tell the user what was found (or "Planning from prompt only" if empty).
Extract: topic, audience, tone, language, slide count, goals from the prompt.
The script uses Playwright with the user's existing system Chrome (--channel chrome flag, no Chromium download). It captures pixel-perfect screenshots of each slide and assembles them into a PPTX. Only pip install playwright python-pptx required — no Node.js, no 300MB browser download. If system Chrome is not found, the script will report an error and ask the user to install Chrome.
Phase 0: Detect Mode
Determine what the user wants:
Mode A — New Presentation: Check for PLANNING.md first. If it exists, read it as source of truth and jump directly to Phase 3 — skip Phase 1/2.
Mode B — PPT Conversion: User has a .ppt/.pptx file → go to Phase 4.
Mode C — Enhance Existing: Read the existing HTML, understand its structure, then enhance. When adding content, always check viewport fit — if adding would overflow a slide, split the content rather than cramming it in. Proactively split and inform the user.
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
Phase 1: Content Discovery
First, silently scan for a resources/ folder. If found, read text/markdown files and note images as background context. Don't ask the user to take any action.
Then gather everything in a single AskUserQuestion call with all 5 questions at once — collecting everything before submitting avoids back-and-forth.
Length (single select): Short 5-10 / Medium 10-20 / Long 20+
Content (single select): All content ready / Rough notes / Topic only
Images (single select): No images / ./assets / Other (user types path)
Inline Editing (single select): Yes — edit text in-browser, auto-save (Recommended) / No — presentation only
Default: Always include inline editing unless user explicitly selects "No". When --generate skips Phase 1, include inline editing by default.
If user has content, ask them to share it after submitting the form.
Language: Detect from the user's message — never default to a fixed language. Maintain the detected language throughout all slide text including labels, CTAs, and captions. English may appear as secondary annotation text only when the style calls for it.
Image Evaluation
Skip if user chose "No images." Text-only decks are fully first-class — CSS-generated gradients, shapes, and typography create compelling visuals without any images.
If images are provided:
ls the folder, then use Read (multimodal) to view each image.
For each image: mark USABLE or NOT USABLE (with reason: blurry, irrelevant, broken) + what it represents + dominant colors + shape.
Build a slide outline that co-designs text and images from the start. This is not "plan slides, then fit images in after." Example: 3 usable product screenshots → 3 feature slides anchored by those screenshots.
Present the evaluation and proposed outline, then confirm via AskUserQuestion (Looks good → Style B / Adjust images / Adjust outline).
Phase 2: Style Discovery
Most people can't articulate design preferences in words. Generate 3 mini visual previews and let them react — this is the "wow moment" of the skill.
Style Path
Ask via AskUserQuestion:
"Show me options" → ask mood question → generate 3 previews based on answer
"I know what I want" → show preset picker (Bold Signal / Blue Sky / Modern Newspaper / Neo-Retro Dev Deck — with "Other" option for all 21 presets)
Before showing presets, silently scan <skill-path>/themes/ for subdirectories.
Skip any directory whose name starts with _ (those are examples/templates, not real themes).
Each remaining subdirectory with a reference.md is a custom theme. Append them to the preset list as Custom: <folder-name> entries. If any custom themes exist, mention them first: "I also found N custom theme(s) in your themes/ folder."
Business reports, thought leadership, research summaries
Neo-Retro Dev Deck
Opinionated, technical, handmade
Dev tool launches, API docs, hackathon presentations
Mood → Preset mapping:
Mood
Style Options
Impressed/Confident
Bold Signal, Enterprise Dark, Neo-Brutalism
Excited/Energized
Creative Voltage, Neon Cyber, Aurora Mesh
Calm/Focused
Notebook Tabs, Paper & Ink, Chinese Chan
Inspired/Moved
Dark Botanical, Vintage Editorial, Glassmorphism
Clean/Enterprise
Blue Sky, Electric Studio, Enterprise Dark
Data-Driven
Data Story, Enterprise Dark, Swiss Modern
Playful/Creative
Split Pastel, Pastel Geometry, Neo-Brutalism
Developer-Focused
Terminal Green, Neon Cyber, Neo-Retro Dev Deck
Editorial/Organized
Notebook Tabs, Vintage Editorial, Modern Newspaper
Generate Previews
Create 3 mini HTML files in .claude-design/slide-previews/ (style-a/b/c.html). Each is a single title slide (~50-100 lines, self-contained) demonstrating typography, color palette, and animation style.
If a USABLE logo was found in Step 1.2, embed it (base64) into each preview — seeing their own brand in 3 different aesthetics makes the choice feel personal, not abstract.
Never use: Inter/Roboto/Arial as display fonts, generic purple-on-white gradients, predictable centered hero layouts.
Present the 3 files with a one-sentence description each, then ask via AskUserQuestion which they prefer (Style A / B / C / Mix elements).
Phase 3: Generate Presentation
Generate the presentation based on content from Phase 1 and style from Phase 2. If PLANNING.md exists, it's the source of truth — skip Phases 1 and 2.
If Blue Sky style is selected → use the starter template
All 10 signature visual elements (orbs, noise texture, grid, glassmorphism, spring-physics horizontal track, gradient text, cloud hero, pill dots, counter, entrance animation) are already implemented in that file. You only need to:
Set --slide-count in :root to your actual slide count
Replace the example slides in #track with your content, following the slide-type patterns in the comment block
Fill the orbPositions array in JS — one [l1,t1,s1, l2,t2,s2, l3,t3,s3] entry per slide
Do not rewrite the visual system CSS. Do not change the track/slide layout. Content goes inside .slide wrappers using the pre-built component classes: .g (glass card), .gt (gradient text), .pill, .stat, .divider, .cols2/3/4, .ctable, .co (amber callout), .warn (red warning), .info (blue info), .layer (org row), ul.bl (bullet list).
If a custom theme from themes/ is selected
Read the theme's reference.md for style constraints. If a starter.html exists in the theme folder, use it as the base (same as Blue Sky). Otherwise, follow the standard references below and apply the custom theme's colors, typography, and layout rules.
For all other styles → read the standard references
Read references/html-template.md — it contains the required HTML structure, JavaScript patterns, animation recipes, and edit button implementation.
IMPORTANT — MUST READ before writing any HTML. Do NOT implement the edit button or presenter button from memory. The correct pattern uses a hotzone <div> + JS mouseenter/mouseleave with a 400ms grace period. Using body:hover is a known mistake — it makes the button permanently visible. The exact implementation is in html-template.md; copy it directly.
Also read STYLE-DESC.md for viewport fitting CSS, responsive breakpoints, style preset details, and CSS gotchas (especially: never negate CSS functions directly — use calc(-1 * clamp(...)) not -clamp(...)).
Viewport Fitting
Each slide must equal exactly one viewport height (100vh / 100dvh). When content doesn't fit, split it across slides — never allow scrolling within a slide. This is what separates a polished presentation from a broken one.
Content density limits:
Slide Type
Maximum
Title slide
1 heading + 1 subtitle
Content slide
1 heading + 4-6 bullets
Feature grid
1 heading + 6 cards max (2×3 or 3×2)
Code slide
1 heading + 8-10 lines
Quote slide
1 quote (3 lines max) + attribution
Image slide
1 heading + 1 image (max 60vh height)
When in doubt → split the slide.
Visual Rhythm: Alternate between text-heavy and visual-heavy slides. Three or more consecutive slides with the same layout signal low effort. Vary between: headline-dominant → data/diagram → evidence list → quote or visual break → headline-dominant. Every 4–5 slides, one slide should be nearly empty (a single statement, a big number, or a quote).
Diagram Slides (when content calls for a visual relationship)
When a slide needs to show a process, comparison, hierarchy, timeline, or data — generate an inline SVG diagram instead of bullet points.
One diagram per slide, never combined with a bullet list
Use currentColor so diagrams inherit the slide's text color automatically
Apply --accent color to the most important element (first step, top bar, highlighted quadrant)
Never use Mermaid.js, Chart.js, or any external library — inline SVG only
Image Pipeline (skip if no images)
For each USABLE image from Step 1.2, determine processing needed (circular crop for logos, resize for large files, padding for screenshots needing breathing room) and run it with Pillow. Reference images with relative paths (assets/...) — don't base64 encode unless the user explicitly wants a fully self-contained file.
Rules:
Never repeat an image across slides (logos may bookend title + closing)
Always add style-matched CSS framing (border/glow matching the style's accent color) when image colors clash with the palette
Code Quality
Comment every section: what it does, why it exists, how to modify it
Semantic HTML (<section>, <nav>, <main>)
ARIA labels on nav elements and interactive controls
@media (prefers-reduced-motion: reduce) support
No markdown symbols (#, *, **, _) in slide text — use semantic HTML elements (<strong>, <em>, <h2>) for structure and emphasis
Run the extraction script to get slides_data (title, content, images, notes per slide)
Present extracted structure to user, confirm it looks right
Run Phase 2 (Style Discovery) with extracted content in mind
Generate HTML preserving all text, images (from assets/), and slide order. Put speaker notes in data-notes attributes on each .slide section (not HTML comments) so they work in Presenter Mode.
Phase 5: Delivery
Clean up: delete .claude-design/slide-previews/ if it exists.
Embed speaker notes in HTML — every .slide section must have a data-notes="..." attribute with 2-4 sentences (what to say, key emphasis, transition cue). These power the built-in Presenter Mode.
Generate PRESENTATION_SCRIPT.md if deck has 8+ slides or was created from PLANNING.md (same notes content, formatted as a readable document).
Open:open [filename].html
Summarize:
Your presentation is ready!
📁 File: [filename].html
🎨 Style: [Style Name]
📊 Slides: [count]
Navigation: Arrow keys or Space · Scroll or swipe · Click dots to jump
Presenter Mode: press P to open the presenter window (notes + timer + controls)
To customize: edit :root variables at the top of the CSS for colors, fonts, and spacing.
To export as PPTX: run `/slide-creator --export pptx` (requires Python 3 + playwright + python-pptx, no Node.js)
Always mention: hover the top-left corner or press E to enter edit mode (included by default unless user explicitly opted out).
Effect → Feeling Guide
Feeling
Techniques
Dramatic/Cinematic
Slow fade-ins 1-1.5s, dark backgrounds, full-bleed images, parallax
