# Slides — user guide

The Slides plugin turns a description into a finished, self-contained HTML slide deck. The output is one `deck.html` file — inline CSS and JavaScript, no build step, no dependencies beyond Google Fonts. Open it in any browser, navigate with arrow keys or swipe, and press `P` to export to PDF.

## When to use it

- You need a deck and want to describe what to say rather than format slides by hand.
- You have an existing `deck.html` and want to add slides, restyle it, or get a critique.
- You want a presentation that lives as plain text — version-controllable, diffable, and readable without a binary editor.

## The commands

- **`/slides`** — generate a complete deck from a description. Auto-detects the best storytelling format (talk, pitch, sales, board, product launch) and writes a single `deck.html`. You can pass the brief inline (`/slides "a 20-minute talk on AI-assisted development"`) or run it bare and describe in the follow-up.
- **`/slides-outline`** — draft just the structure (section-by-section) without producing HTML, so you can agree the narrative first.
- **`/add-slide`** — insert one or more slides into an existing deck, matching its theme and components.
- **`/slides-theme`** — restyle a deck. Three built-in themes: **Default** (warm, editorial), **Craft** (richer textures, art overlays), **Solid** (glass morphism, gradients). Any other argument is treated as a custom theme described in text or extracted from an attached image.
- **`/slides-review`** — critique the current deck on storytelling, design, and voice consistency.
- **`/slides-new-component`** — build a new reusable slide component aligned with the design system's tokens.
- **`/slides-claus`** — generate a deck using the Solid theme with the Claus storytelling structure.

## Storytelling formats

`/slides` routes to one of six narrative structures based on your brief: conference **talk** (TED-style), **Sequoia** investor pitch, McKinsey **SCR** (situation-complication-resolution), **product launch**, **board update**, and **sales**. Name the format in your brief to force one explicitly.

## What you get

A 25-component design system (title slides, metric cards, quotes, comparison tables, timelines, and more), responsive layout, and three interchangeable themes — all inside one portable file.

## Notes

This is a frozen, vendored copy of the open-source Slides™ framework (MIT). It ships installed and available on every account; enable it per session like any other plugin if it is not already active.
