Slides Skill for reveal.js

Overview

This skill guides AI to create and update reveal.js slides quickly and reliably. Prefer documented reveal.js capabilities over guessed APIs, config keys, or plugin behavior.

When to Use

Creating a reveal.js presentation from scratch.
Migrating existing content into reveal.js slides (HTML or Markdown).
Enabling advanced behaviors like Fragments, Auto-Animate, Speaker View, Math, Code Highlight, PDF export, or Scroll View.
Integrating reveal.js into npm/ESM or React projects.

Core Workflow

Analyze the content first and state a content-informed design approach before writing code (topic, tone, audience, branding, and palette rationale).
Choose the integration mode: Static HTML (fastest) or npm/ESM (engineering).
If converting from an existing doc, inventory all source sections/items first and map each item to at least one slide.
Build the minimal deck structure: .reveal > .slides > section.
Register only required plugins (Markdown, Highlight, Notes, Math, Search, Zoom, etc.).
Author content and interactions: horizontal/vertical slides, fragments, backgrounds, transitions, media.
Configure runtime behavior: navigation, keyboard, hash, slideNumber, autoSlide, view: 'scroll'.
Validate and ship: local preview, Speaker View, print/PDF export, and optional API control code.

Implementation Templates

1) Static HTML (UMD)

<html>
  <head>ex
    <link rel="stylesheet" href="dist/reveal.css" />
    <link rel="stylesheet" href="dist/theme/solarized.css" />
    <link rel="stylesheet" href="plugin/highlight/zenburn.css" />
  </head>
  <body>
    <div class="reveal">
      <div class="slides">
        <section>Slide 1</section>
        <section>
          <section>Vertical 1</section>
          <section>Vertical 2</section>
        </section>
      </div>
    </div>

    <script src="dist/reveal.js"></script>
    <script src="plugin/markdown/markdown.js"></script>
    <script src="plugin/highlight/highlight.js"></script>
    <script src="plugin/notes/notes.js"></script>
    <script>
      Reveal.initialize({
        hash: true,
        slideNumber: 'c/t',
        plugins: [RevealMarkdown, RevealHighlight, RevealNotes],
      });
    </script>
  </body>
</html>

2) npm/ESM

import Reveal from 'reveal.js';
import Markdown from 'reveal.js/plugin/markdown/markdown.esm.js';
import Highlight from 'reveal.js/plugin/highlight/highlight.esm.js';
import Notes from 'reveal.js/plugin/notes/notes.esm.js';
import 'reveal.js/dist/reveal.css';
import 'reveal.js/dist/theme/white.css';

const deck = new Reveal({
  hash: true,
  slideNumber: 'c/t',
  plugins: [Markdown, Highlight, Notes],
});

await deck.initialize();

3) Markdown Slide Block

<section data-markdown>
  <textarea data-template>
    ## Slide 1
    ---
    ## Slide 2
  </textarea>
</section>

Feature Playbook

Markdown: Enable the Markdown plugin; external markdown requires a local web server.
Code: Enable Highlight and use data-line-numbers plus step highlights via |.
Math: Use RevealMath.KaTeX by default (or MathJax when required).
Speaker Notes: Enable Notes and press S for presenter view.
Auto-Animate: Use adjacent <section data-auto-animate> and data-id for precise matching.
Backgrounds: Use data-background-* (color/image/video/iframe).
Architecture diagrams: Prefer Mermaid for system/process/flow slides to increase clarity and visual consistency.
Scroll View: Use view: 'scroll' with optional scrollSnap and scrollLayout.
PDF: Use ?print-pdf then browser print to PDF.

Reveal.js Tips

The items below should be preferred in this skill.

Design Principles (CRITICAL)

Before creating any presentation, analyze the content and choose design elements intentionally:

Consider the subject matter: what is this presentation about, and what tone/industry/mood does it suggest?
Check for branding: if the user mentions a company or organization, align with likely brand identity and colors.
Match palette to content: choose colors that reflect the topic, audience, and communication goal.
State your approach first: explain your design choices before writing slide code.

Required behavior:

State the content-informed design approach before writing code.
Use web-safe fonts (Arial, Helvetica, Georgia, Verdana, etc.) or Google Fonts via @import.
Create clear visual hierarchy through size, weight, and color.
Ensure readability with strong contrast, appropriately sized text, and clean alignment.
Keep visual consistency across slides: repeated spacing, component patterns, and color language.
Always use pt units for font sizes in slide CSS/inline styles. Never use em, rem, or px for font-size values.

Color Palette Selection

Choose colors creatively based on the actual content:

Think beyond defaults: avoid autopilot palettes.
Consider multiple angles: topic, industry, mood, energy level, audience, and mentioned brand identity.
Be adventurous when useful: healthcare is not required to be green; finance is not required to be navy.
Build a 3-5 color system: dominant colors, supporting tones, and accent colors.
Always verify text/background contrast for readability.

Palette references (adapt freely or create your own):

Classic Blue: deep navy #1C2833, slate gray #2E4053, silver #AAB7B8, off-white #F4F6F6
Teal and Coral: teal #5EA8A7, deep teal #277884, coral #FE4447, white #FFFFFF
Bold Red: red #C0392B, bright red #E74C3C, orange #F39C12, yellow #F1C40F, green #2ECC71
Warm Blush: mauve #A49393, blush #EED6D3, rose #E8B4B8, cream #FAF7F2
Burgundy Luxury: burgundy #5D1D2E, crimson #951233, rust #C15937, gold #997929
Deep Purple and Emerald: purple #B165FB, dark blue #181B24, emerald #40695B, white #FFFFFF
Cream and Forest Green: cream #FFE1C7, forest green #40695B, white #FCFCFC
Pink and Purple: pink #F8275B, coral #FF574A, rose #FF737D, purple #3D2F68
Lime and Plum: lime #C5DE82, plum #7C3A5F, coral #FD8C6E, blue-gray #98ACB5
Black and Gold: gold #BF9A4A, black #000000, cream #F4F6F6
Sage and Terracotta: sage #87A96B, terracotta #E07A5F, cream #F4F1DE, charcoal #2C2C2C
Charcoal and Red: charcoal #292929, red #E33737, light gray #CCCBCB
Vibrant Orange: orange #F96D00, light gray #F2F2F2, charcoal #222831
Forest Green: black #191A19, green #4E9F3D, dark green #1E5128, white #FFFFFF
Retro Rainbow: purple #722880, pink #D72D51, orange #EB5C18, amber #F08800, gold #DEB600
Vintage Earthy: mustard #E3B448, sage #CBD18F, forest green #3A6B35, cream #F4F1DE
Coastal Rose: old rose #AD7670, beaver #B49886, eggshell #F3ECDC, ash gray #BFD5BE
Orange and Turquoise: light orange #FC993E, grayish turquoise #667C6F, white #FCFCFC

Slide Content Principles

Even when slides share similar content types, avoid repeating the same visual pattern.

Vary layout patterns across neighboring slides (columns, stacked blocks, cards, split hero, quote-led).
Mix container styles (plain text, styled panels, blockquotes, icon-led callouts).
Build hierarchy actively (<strong>, color emphasis, type scale, spacing rhythm).
Break up long list sequences with visual elements and structural transitions.
Do not repeat identical layout structures on consecutive slides.
Keep slides scannable: short bullets, one main idea per slide where possible.
Use icons (for example Font Awesome) when they improve clarity and pacing.
When a slide has less content, increase scale and composition impact instead of leaving sparse tiny text.

30-Second Design Review Checklist

Run this before considering a deck "done":

Deck defaults to a light tone unless explicitly requested otherwise (prefer official reveal solarized theme).
Aesthetic direction is explicit and consistent (not mixed styles).
Typography has clear hierarchy (display vs body) and readable line lengths.
Palette has one dominant tone and one intentional accent color.
At least one memorable visual motif exists (layout move, background treatment, or motion sequence).
Motion supports narrative pacing (not scattered decorative effects).
Architecture/process slides use Mermaid when applicable instead of ad-hoc ASCII bullets.
Slides stay readable on both desktop and mobile widths.

1) Title slide with custom background

Use an explicit first <section> as a title slide and style it with reveal data attributes.

<section
  id="title-slide"
  data-background-image="./img/background.jpg"
  data-background-size="cover"
  data-background-opacity="0.9"
>
  <h1>My Slide Show</h1>
</section>

2) Move/resize a logo after leaving title slide

Use CSS classes plus the slidechanged event. Add a persistent logo element in your HTML, e.g. <img class="slide-logo" src="./images/my-logo.svg" alt="Logo" />.

.reveal .slide-logo {
  position: fixed;
  display: block;
  max-width: none !important;
}

.reveal .slide-logo-bottom-right {
  right: 12px !important;
  bottom: 0 !important;
  left: auto !important;
  max-height: 2.2rem !important;
}

.slide-logo-max-size {
  top: 5px;
  left: 12px;
  right: auto !important;
  bottom: auto !important;
  height: 100px !important;
  max-height: none !important;
}

function syncLogoForSlide(currentSlide) {
  const logos = document.querySelectorAll('.slide-logo');
  const onTitle = currentSlide && currentSlide.id === 'title-slide';
  logos.forEach((el) => {
    el.classList.toggle('slide-logo-max-size', onTitle);
    el.classList.toggle('slide-logo-bottom-right', !onTitle);
  });
}

Reveal.on('ready', (event) => syncLogoForSlide(event.currentSlide));
Reveal.on('slidechanged', (event) => syncLogoForSlide(event.currentSlide));

3) Background image sizing (`cover` vs `contain`)

cover fills the slide and may crop. contain preserves the entire image.

<section data-background-image="images/2024.jpg" data-background-size="cover"></section>
<section data-background-image="images/2024.jpg" data-background-size="contain"></section>

4) Slide structure control (replacement for Quarto `slide-level`)

Pure reveal.js does not use Pandoc slide-level. Control structure explicitly:

HTML mode: one <section> per slide, nested <section> for vertical slides.
Markdown mode: use configured separators (---, --) to split slides.

5) Emoji support

Quarto's from: markdown+emoji is not a reveal.js feature. In reveal.js:

Use native Unicode emoji directly.
Or render emoji through your markdown/HTML pipeline before reveal initializes.

6) Fit large text and stretch media

r-fit-text and r-stretch are reveal classes and work directly.

<section>
  <div class="r-fit-text">Big Text</div>
</section>

<section>
  <p>Here is an image:</p>
  <img class="r-stretch" src="image.webp" alt="Demo image" />
  <p>Some text after the image.</p>
</section>

7) Reveal content on key press with fragments

<section>
  <h2>It's a candy dog</h2>
  <p style="font-size: 44pt; color: #75aadb;">Would you like to see a candy dog?</p>
  <img class="fragment fade-up" src="./images/dog.webp" alt="Candy dog" />
</section>

8) Two-column and 4-quadrant layouts

Quarto ::: columns is not native reveal syntax. Use HTML/CSS layout wrappers.

<section>
  <div class="cols">
    <div class="col col-70"><img src="./images/image_1.webp" alt="Left" /></div>
    <div class="col col-30">
      <img src="./images/image_2.webp" alt="Right top" />
      <img src="./images/image_3.webp" alt="Right bottom" />
    </div>
  </div>
</section>

.reveal .cols {
  display: flex;
  gap: 1.5rem;
  align-items: flex-start;
}

.reveal .col-70 { flex: 0 0 70%; }
.reveal .col-30 { flex: 0 0 30%; }

For 4 quadrants, use a 2x2 CSS grid and reveal each cell with fragment classes (fade-in-then-semi-out or similar).

9) Custom inline short-code transform (`==text==` -> `<mark>text</mark>`)

function convertMarkedTextInSlide(slide) {
  if (!slide) return;
  slide.innerHTML = slide.innerHTML.replace(/==([^=]+)==/g, '<mark>$1</mark>');
}

Reveal.on('ready', (event) => convertMarkedTextInSlide(event.currentSlide));
Reveal.on('slidechanged', (event) => convertMarkedTextInSlide(event.currentSlide));

10) Inline style and custom CSS

In reveal markdown, use inline HTML for precise text styling:

<p>
  Make this <span style="color: red;">red</span> and this
  <span style="background: yellow;">highlighted</span>.
</p>

Load custom CSS in static HTML:

<link rel="stylesheet" href="./assets/custom.css" />

Or import it in ESM:

import './assets/custom.css';

11) Hide captions and style callouts when your theme emits them

Reveal core does not auto-generate Quarto callouts/captions, but many pipelines output similar markup:

.reveal p.caption,
.reveal figcaption {
  display: none;
}

.reveal .callout-title {
  display: none;
}

12) Vertical flow, slide IDs, menu labels, numbering, and notes

Vertical chapters: nest sections (<section><section>Child</section></section>).
Navigation behavior: use navigationMode: 'default' | 'linear' | 'grid'.
Stable slide URL names: set section id and enable hash: true.
Menu labels (when using the menu plugin): set data-menu-title.
Slide number with total: slideNumber: 'c/t'.
Speaker notes: <aside class="notes">...</aside> and press S.
Overview mode shortcut: Esc.

<section id="intro" data-menu-title="Introduction">
  <h2>Intro</h2>
  <aside class="notes">Presenter-only notes</aside>
</section>

Reveal.initialize({
  hash: true,
  slideNumber: 'c/t',
  navigationMode: 'default',
  plugins: [RevealNotes],
});

13) Choose one bold aesthetic direction before styling

Do not start from random colors and utility classes. Define a single visual direction (for example: editorial, brutalist, retro-futuristic, luxury minimal, playful) and keep every design decision aligned with it.

Practical rule:

One deck, one dominant visual idea.
Keep typography, palette, motion, and background treatment coherent with that idea.

14) Use deck-level design tokens (CSS variables)

Create a token layer first, then style components/slides with those tokens.

:root {
  --deck-bg: #f6f3ea;
  --deck-surface: rgba(255, 255, 255, 0.72);
  --deck-text: #1b1a18;
  --deck-accent: #c0392b;
  --deck-muted: #6f6a61;
  --deck-shadow: 0 20px 50px rgba(20, 16, 10, 0.18);
  --deck-radius: 18px;
  --deck-gap: 1.2rem;
}

.reveal {
  color: var(--deck-text);
  background:
    radial-gradient(circle at 12% 18%, rgba(192, 57, 43, 0.12), transparent 45%),
    radial-gradient(circle at 88% 82%, rgba(27, 26, 24, 0.1), transparent 42%),
    var(--deck-bg);
}

15) Build typography hierarchy intentionally

Use a distinctive display face for headings and a separate body face for text-heavy slides. Define consistent scale and line length.

@import url('https://fonts.googleapis.com/css2?family=DM+Serif+Display:[email protected]&family=Manrope:wght@400;500;700;800&display=swap');

.reveal {
  font-family: 'Manrope', 'Helvetica Neue', Arial, sans-serif;
}

.reveal h1,
.reveal h2,
.reveal h3 {
  font-family: 'DM Serif Display', Georgia, 'Times New Roman', serif;
  letter-spacing: 0.01em;
  line-height: 1.05;
}

.reveal p,
.reveal li {
  line-height: 1.45;
  max-width: 58ch;
}

16) Prefer dominant palette + sharp accent over evenly mixed colors

A strong deck usually has:

One dominant background family.
One primary text color.
One high-contrast accent for emphasis, links, and key annotations.

.reveal a,
.reveal strong,
.reveal mark {
  color: var(--deck-accent);
}

.reveal mark {
  background: transparent;
  border-bottom: 0.2em solid color-mix(in srgb, var(--deck-accent) 35%, transparent);
  padding: 0 0.08em;
}

17) Compose slides with atmosphere (not flat backgrounds)

Avoid plain single-color canvases by default. Add depth with subtle gradients, textures, overlays, or layered shadows that match the chosen aesthetic.

.reveal .panel {
  background: var(--deck-surface);
  border: 1px solid rgba(255, 255, 255, 0.5);
  border-radius: var(--deck-radius);
  box-shadow: var(--deck-shadow);
  backdrop-filter: blur(6px);
  padding: calc(var(--deck-gap) * 1.2);
}

18) Use motion as choreography, not decoration

In reveal.js, prioritize:

One meaningful entry sequence per slide (fade-up, fade-in, zoom-in fragments with stagger).
Smooth global transition settings.
Minimal micro-animations elsewhere.

Reveal.initialize({
  transition: 'slide',
  backgroundTransition: 'fade',
  autoAnimateEasing: 'ease-out',
  autoAnimateDuration: 0.6,
});

<section>
  <h2 class="fragment fade-in">Problem</h2>
  <p class="fragment fade-up">Constraint</p>
  <p class="fragment fade-up">Decision</p>
  <p class="fragment fade-up">Outcome</p>
</section>

19) Break predictable layouts with controlled asymmetry

Avoid centering everything. Mix alignment, width, overlap, and whitespace intentionally.

.reveal .asym {
  display: grid;
  grid-template-columns: 1.2fr 0.8fr;
  gap: 2rem;
  align-items: end;
}

.reveal .asym .media {
  transform: translateY(1rem);
}

20) Final anti-generic design pass

Before shipping, quickly verify:

Font choice is intentional and not default/generic.
Color system has a dominant tone plus a clear accent.
At least one memorable visual motif exists (background treatment, type lockup, layout move, or motion sequence).
Slide density is controlled; no wall-of-text pages.
Mobile viewport still preserves hierarchy and readability.

21) Prefer Mermaid for architecture and flow communication

For system overviews, sequence explanations, data flow, and decision logic, use Mermaid slides first. This usually communicates structure faster than dense bullet lists.

<section>
  <h2>Architecture</h2>
  <pre class="mermaid">
flowchart LR
  Client["Client"] -->|HTTPS| API["API Gateway"]
  API --> Service["Application Service"]
  Service --> DB["PostgreSQL"]
  Service --> Queue["Background Queue"]
  Queue --> Worker["Worker"]
  </pre>
</section>

If Mermaid plugin setup is needed:

Reveal.initialize({
  hash: true,
  plugins: [RevealMermaid],
});

Use this decision rule:

Use Mermaid for complex graphs (branching/cycles/cross-links, usually 8+ nodes).
For simple linear pipelines (A -> B -> C -> D), prefer HTML/CSS step cards because they fill slide space better and are easier to style at presentation scale.
Never leave a tiny Mermaid graph alone in large empty space; pair it with supporting content or switch to a split layout.

22) Convert source documents with full coverage (no silent drops)

When turning a plan/spec/review into slides:

Inventory every source item first (sections, tables, cards, decisions, details).
Map each item to slide(s) before writing markup.
Verify coverage at the end: no major section from source should be missing in the deck.

If one source section has high density, split into multiple slides instead of compressing into unreadable bullets.

23) Use slide archetypes to control pacing

Build deck rhythm with explicit slide roles, not repeated generic content slides:

Title for opening tone.
Divider between major topics.
Content for explanation.
Split for comparison (before/after, text+diagram, problem/solution).
Diagram for structure/flow.
Dashboard for metrics/KPIs.
Table for compact factual comparison.
Code for implementation detail.
Quote for emphasis.
Full-bleed for key visual moments.

Avoid long runs of the same archetype.

24) Enforce compositional variety across consecutive slides

Alternate spatial compositions through the sequence:

centered
left-heavy
right-heavy
split
edge-aligned
full-bleed

Rule of thumb: do not use 3 consecutive slides with the same composition pattern.

25) Keep presentation density within slide limits

Use these limits by default:

Content slide: 1 heading + up to 5-6 bullets (max ~2 lines each).
Diagram slide: one primary diagram, usually up to 8-10 nodes at presentation size.
Table slide: up to ~8 rows; overflow moves to next slide.
Code slide: up to ~10 lines focused on one point.
Quote slide: short quote only; long quotes become content slides.

If limits are exceeded, split into additional slides instead of shrinking text.

26) Use presentation-scale typography baselines

Slides are not documents; scale text for screen-share/projector readability:

Display/title: roughly 48-120px
Heading: roughly 28-48px
Body/bullets: roughly 16-24px
Labels/captions: roughly 10-14px

Always prioritize readability from distance over document-like density.

Guardrails

Do not invent reveal.js config keys; only use documented options.
Do not use plugin syntax before registering the corresponding plugin (Markdown/Math/Notes/Highlight, etc.).
For multi-instance pages, prefer new Reveal(rootEl, config) with embedded: true.
In React, avoid duplicate initialization and call destroy() on unmount.
Treat Quarto/Pandoc-only syntax as source material, not runtime reveal.js syntax (::: columns, ::: notes, slide-level, markdown+emoji, callout blocks).
When migrating from Quarto to reveal.js, preserve behavior first (fragment timing, navigation flow, note visibility), then adjust visual styling.
Do not ship visually generic decks. Each deck must have a deliberate aesthetic direction, typography system, palette strategy, and motion intent.
Prefer reveal official solarized theme for default/light-tone decks unless user requirements explicitly call for another theme.
Minimize new custom CSS. First use built-in reveal classes/options; add CSS only when necessary.
When adding CSS, scope selectors to .reveal or a slide-level class and verify impact scope (what selectors will match, which slides/components are affected).
Do not reimplement slide engines (scroll-snap containers, custom nav chrome, custom keyboard routers) when using reveal.js. Use reveal built-ins unless there is a concrete gap.
When borrowing HTML-slide design systems, translate the design language to reveal primitives (section, fragments, built-in navigation) instead of copying unrelated runtime architecture.

Delivery Checklist

First slide renders correctly with no obvious console errors.
Plugin registration matches the content syntax used (Markdown/Notes/Math/Highlight/etc.).
Navigation and interactions match requirements (keyboard, hash, slideNumber, autoSlide, touch).
Theme defaults to official reveal solarized unless requirements explicitly override it.
If custom CSS was added, selector scope and impact were reviewed (which slides/components each rule can affect).
Architecture/process-heavy content uses Mermaid diagrams when appropriate.
Source-to-slide coverage check was completed for conversion tasks (no major source section dropped).
Composition rhythm was reviewed (no 3 consecutive slides with the same layout pattern).
Density limits were respected or split across additional slides.
If export is requested, verify print/PDF workflow end-to-end.

References

External Recipe Source

Some tips and tricks for Quarto when rendering as a reveal.js slideshow (extract reveal.js-applicable patterns; ignore Quarto-only syntax)
Anthropic frontend-design skill (aesthetic direction, typography, color, motion, composition discipline)
visual-explainer slide-patterns (slide archetypes, pacing, density limits, presentation readability)

Getting Started

| Topic | Description | Reference | | ------------ | ----------------------------------------------------------------------------------------- | -------------------------------------------- | | Home | Entry page for reveal.js docs, covering core concepts and navigation to all major guides. | Home | | Course | A structured tutorial path that teaches reveal.js basics step by step. | Course | | Installation | Explains how to install reveal.js in different environments and project setups. | Installation |

Content

| Topic | Description | Reference | | ---------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------- | | Markup | Shows the core HTML slide structure and how nested sections define navigation. | Markup | | Markdown | Describes writing slides in Markdown and configuring the Markdown plugin. | Markdown | | Backgrounds | Documents slide background options such as color, image, video, and iframe. | Backgrounds | | Media | Covers embedding and controlling media content inside slides. | Media | | Lightbox | Explains how to present media in an enlarged lightbox-style experience. | Lightbox | | Code | Introduces code block rendering and syntax highlighting patterns for slides. | Code | | Math | Shows how to render mathematical formulas with KaTeX or MathJax integrations. | Math | | Fragments | Describes progressive reveal effects to show slide elements in sequence. | Fragments | | Links | Explains internal and external linking behavior in reveal.js presentations. | Links | | Layout | Covers layout techniques to organize content cleanly within each slide. | Layout | | Slide Visibility | Describes controls for showing, hiding, or excluding specific slides. | Slide Visibility |

Customization

| Topic | Description | Reference | | ----------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------ | | Themes | Explains built-in themes and how to style presentations with custom theming. | Themes | | Transitions | Documents slide and element transition effects and their configuration. | Transitions | | Config Options | Full reference for initialization and runtime configuration settings. | Config Options | | Presentation Size | Shows how to control deck dimensions, scaling behavior, and responsive sizing. | Presentation Size |

Features

| Topic | Description | Reference | | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------- | | Vertical Slides | Explains vertical stacks for subtopics under a horizontal slide flow. | Vertical Slides | | Auto Animate | Describes automatic tweening between similar elements across adjacent slides. | Auto Animate | | Auto Slide | Covers timed autoplay behavior and controls for automatic slide progression. | Auto Slide | | Speaker View | Shows presenter tools, notes view, and speaker-screen workflow. | Speaker View | | Scroll View | Explains continuous scroll-based presentation mode and related settings. | Scroll View | | Slide Numbers | Documents numbering formats and display options for slide counters. | Slide Numbers | | Jump to Slide | Shows how to quickly navigate to a specific slide during presentation. | Jump to Slide | | Touch Navigation | Describes gesture and touch interactions on mobile and touch devices. | Touch Navigation | | PDF Export | Explains the print-to-PDF workflow and export-specific adjustments. | PDF Export | | Overview Mode | Documents the zoomed overview interface for fast deck navigation. | Overview Mode | | Fullscreen Mode | Covers fullscreen presentation behavior and toggling options. | Fullscreen Mode |

API

| Topic | Description | Reference | | ------------------ | ---------------------------------------------------------------------------- | -------------------------------------------------------- | | Initialization | Explains deck bootstrapping, config injection, and startup lifecycle. | Initialization | | API Methods | Reference for imperative methods used to control reveal.js programmatically. | API Methods | | Events | Lists emitted events and shows how to listen for deck state changes. | Events | | Keyboard | Documents keyboard shortcuts and custom key-binding configuration. | Keyboard | | Presentation State | Explains capturing, restoring, and sharing presentation state data. | Presentation State | | PostMessage | Describes cross-window communication using the postMessage interface. | PostMessage |

Initialization

| Topic | Description | Reference | | ---------------- | ------------------------------------------------------------------------ | ---------------------------------------------------- | | Using Plugins | Shows how to register and configure official or third-party plugins. | Using Plugins | | Creating Plugins | Guide to authoring custom reveal.js plugins and integrating them safely. | Creating Plugins | | Multiplex | Explains synchronized multi-client presentations for remote audiences. | Multiplex |

Plugins

| Topic | Description | Reference | | ------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | | Animate | Adds SVG.js-based slide animations that can be coordinated with reveal.js flow. | Animate | | Chart | Integrates Chart.js so presentations can render configurable data charts. | Chart | | Fullscreen | Provides fullscreen layout behavior to maximize available slide space. | Fullscreen | | D3 (reveald3) | Embeds JavaScript visualizations (including D3-based content) with fragment-aware transitions. | Reveal.js-d3 (reveald3) | | Mermaid | Adds Mermaid diagram rendering support directly inside reveal.js slides. | reveal.js-mermaid-plugin |

Other

| Topic | Description | Reference | | ---------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | React Framework | Covers integration patterns and usage details for reveal.js in React apps. | React Framework | | Upgrading Instructions | Migration notes for updating reveal.js versions without breaking decks. | Upgrading Instructions |

Slides Skill for reveal.js

Overview

This skill guides AI to create and update reveal.js slides quickly and reliably. Prefer documented reveal.js capabilities over guessed APIs, config keys, or plugin behavior.

When to Use

Creating a reveal.js presentation from scratch.
Migrating existing content into reveal.js slides (HTML or Markdown).
Enabling advanced behaviors like Fragments, Auto-Animate, Speaker View, Math, Code Highlight, PDF export, or Scroll View.
Integrating reveal.js into npm/ESM or React projects.

Core Workflow

Analyze the content first and state a content-informed design approach before writing code (topic, tone, audience, branding, and palette rationale).
Choose the integration mode: Static HTML (fastest) or npm/ESM (engineering).
If converting from an existing doc, inventory all source sections/items first and map each item to at least one slide.
Build the minimal deck structure: .reveal > .slides > section.
Register only required plugins (Markdown, Highlight, Notes, Math, Search, Zoom, etc.).
Author content and interactions: horizontal/vertical slides, fragments, backgrounds, transitions, media.
Configure runtime behavior: navigation, keyboard, hash, slideNumber, autoSlide, view: 'scroll'.
Validate and ship: local preview, Speaker View, print/PDF export, and optional API control code.

Implementation Templates

1) Static HTML (UMD)

<html>
  <head>ex
    <link rel="stylesheet" href="dist/reveal.css" />
    <link rel="stylesheet" href="dist/theme/solarized.css" />
    <link rel="stylesheet" href="plugin/highlight/zenburn.css" />
  </head>
  <body>
    <div class="reveal">
      <div class="slides">
        <section>Slide 1</section>
        <section>
          <section>Vertical 1</section>
          <section>Vertical 2</section>
        </section>
      </div>
    </div>

    <script src="dist/reveal.js"></script>
    <script src="plugin/markdown/markdown.js"></script>
    <script src="plugin/highlight/highlight.js"></script>
    <script src="plugin/notes/notes.js"></script>
    <script>
      Reveal.initialize({
        hash: true,
        slideNumber: 'c/t',
        plugins: [RevealMarkdown, RevealHighlight, RevealNotes],
      });
    </script>
  </body>
</html>

2) npm/ESM

import Reveal from 'reveal.js';
import Markdown from 'reveal.js/plugin/markdown/markdown.esm.js';
import Highlight from 'reveal.js/plugin/highlight/highlight.esm.js';
import Notes from 'reveal.js/plugin/notes/notes.esm.js';
import 'reveal.js/dist/reveal.css';
import 'reveal.js/dist/theme/white.css';

const deck = new Reveal({
  hash: true,
  slideNumber: 'c/t',
  plugins: [Markdown, Highlight, Notes],
});

await deck.initialize();

3) Markdown Slide Block

<section data-markdown>
  <textarea data-template>
    ## Slide 1
    ---
    ## Slide 2
  </textarea>
</section>

Feature Playbook

Markdown: Enable the Markdown plugin; external markdown requires a local web server.
Code: Enable Highlight and use data-line-numbers plus step highlights via |.
Math: Use RevealMath.KaTeX by default (or MathJax when required).
Speaker Notes: Enable Notes and press S for presenter view.
Auto-Animate: Use adjacent <section data-auto-animate> and data-id for precise matching.
Backgrounds: Use data-background-* (color/image/video/iframe).
Architecture diagrams: Prefer Mermaid for system/process/flow slides to increase clarity and visual consistency.
Scroll View: Use view: 'scroll' with optional scrollSnap and scrollLayout.
PDF: Use ?print-pdf then browser print to PDF.

Reveal.js Tips

The items below should be preferred in this skill.

Design Principles (CRITICAL)

Before creating any presentation, analyze the content and choose design elements intentionally:

Consider the subject matter: what is this presentation about, and what tone/industry/mood does it suggest?
Check for branding: if the user mentions a company or organization, align with likely brand identity and colors.
Match palette to content: choose colors that reflect the topic, audience, and communication goal.
State your approach first: explain your design choices before writing slide code.

Required behavior:

State the content-informed design approach before writing code.
Use web-safe fonts (Arial, Helvetica, Georgia, Verdana, etc.) or Google Fonts via @import.
Create clear visual hierarchy through size, weight, and color.
Ensure readability with strong contrast, appropriately sized text, and clean alignment.
Keep visual consistency across slides: repeated spacing, component patterns, and color language.
Always use pt units for font sizes in slide CSS/inline styles. Never use em, rem, or px for font-size values.

Color Palette Selection

Choose colors creatively based on the actual content:

Think beyond defaults: avoid autopilot palettes.
Consider multiple angles: topic, industry, mood, energy level, audience, and mentioned brand identity.
Be adventurous when useful: healthcare is not required to be green; finance is not required to be navy.
Build a 3-5 color system: dominant colors, supporting tones, and accent colors.
Always verify text/background contrast for readability.

Palette references (adapt freely or create your own):

Classic Blue: deep navy #1C2833, slate gray #2E4053, silver #AAB7B8, off-white #F4F6F6
Teal and Coral: teal #5EA8A7, deep teal #277884, coral #FE4447, white #FFFFFF
Bold Red: red #C0392B, bright red #E74C3C, orange #F39C12, yellow #F1C40F, green #2ECC71
Warm Blush: mauve #A49393, blush #EED6D3, rose #E8B4B8, cream #FAF7F2
Burgundy Luxury: burgundy #5D1D2E, crimson #951233, rust #C15937, gold #997929
Deep Purple and Emerald: purple #B165FB, dark blue #181B24, emerald #40695B, white #FFFFFF
Cream and Forest Green: cream #FFE1C7, forest green #40695B, white #FCFCFC
Pink and Purple: pink #F8275B, coral #FF574A, rose #FF737D, purple #3D2F68
Lime and Plum: lime #C5DE82, plum #7C3A5F, coral #FD8C6E, blue-gray #98ACB5
Black and Gold: gold #BF9A4A, black #000000, cream #F4F6F6
Sage and Terracotta: sage #87A96B, terracotta #E07A5F, cream #F4F1DE, charcoal #2C2C2C
Charcoal and Red: charcoal #292929, red #E33737, light gray #CCCBCB
Vibrant Orange: orange #F96D00, light gray #F2F2F2, charcoal #222831
Forest Green: black #191A19, green #4E9F3D, dark green #1E5128, white #FFFFFF
Retro Rainbow: purple #722880, pink #D72D51, orange #EB5C18, amber #F08800, gold #DEB600
Vintage Earthy: mustard #E3B448, sage #CBD18F, forest green #3A6B35, cream #F4F1DE
Coastal Rose: old rose #AD7670, beaver #B49886, eggshell #F3ECDC, ash gray #BFD5BE
Orange and Turquoise: light orange #FC993E, grayish turquoise #667C6F, white #FCFCFC

Slide Content Principles

Even when slides share similar content types, avoid repeating the same visual pattern.

Vary layout patterns across neighboring slides (columns, stacked blocks, cards, split hero, quote-led).
Mix container styles (plain text, styled panels, blockquotes, icon-led callouts).
Build hierarchy actively (<strong>, color emphasis, type scale, spacing rhythm).
Break up long list sequences with visual elements and structural transitions.
Do not repeat identical layout structures on consecutive slides.
Keep slides scannable: short bullets, one main idea per slide where possible.
Use icons (for example Font Awesome) when they improve clarity and pacing.
When a slide has less content, increase scale and composition impact instead of leaving sparse tiny text.

30-Second Design Review Checklist

Run this before considering a deck "done":

Deck defaults to a light tone unless explicitly requested otherwise (prefer official reveal solarized theme).
Aesthetic direction is explicit and consistent (not mixed styles).
Typography has clear hierarchy (display vs body) and readable line lengths.
Palette has one dominant tone and one intentional accent color.
At least one memorable visual motif exists (layout move, background treatment, or motion sequence).
Motion supports narrative pacing (not scattered decorative effects).
Architecture/process slides use Mermaid when applicable instead of ad-hoc ASCII bullets.
Slides stay readable on both desktop and mobile widths.

1) Title slide with custom background

Use an explicit first <section> as a title slide and style it with reveal data attributes.

<section
  id="title-slide"
  data-background-image="./img/background.jpg"
  data-background-size="cover"
  data-background-opacity="0.9"
>
  <h1>My Slide Show</h1>
</section>

2) Move/resize a logo after leaving title slide

Use CSS classes plus the slidechanged event. Add a persistent logo element in your HTML, e.g. <img class="slide-logo" src="./images/my-logo.svg" alt="Logo" />.

.reveal .slide-logo {
  position: fixed;
  display: block;
  max-width: none !important;
}

.reveal .slide-logo-bottom-right {
  right: 12px !important;
  bottom: 0 !important;
  left: auto !important;
  max-height: 2.2rem !important;
}

.slide-logo-max-size {
  top: 5px;
  left: 12px;
  right: auto !important;
  bottom: auto !important;
  height: 100px !important;
  max-height: none !important;
}

function syncLogoForSlide(currentSlide) {
  const logos = document.querySelectorAll('.slide-logo');
  const onTitle = currentSlide && currentSlide.id === 'title-slide';
  logos.forEach((el) => {
    el.classList.toggle('slide-logo-max-size', onTitle);
    el.classList.toggle('slide-logo-bottom-right', !onTitle);
  });
}

Reveal.on('ready', (event) => syncLogoForSlide(event.currentSlide));
Reveal.on('slidechanged', (event) => syncLogoForSlide(event.currentSlide));

3) Background image sizing (`cover` vs `contain`)

cover fills the slide and may crop. contain preserves the entire image.

<section data-background-image="images/2024.jpg" data-background-size="cover"></section>
<section data-background-image="images/2024.jpg" data-background-size="contain"></section>

4) Slide structure control (replacement for Quarto `slide-level`)

Pure reveal.js does not use Pandoc slide-level. Control structure explicitly:

HTML mode: one <section> per slide, nested <section> for vertical slides.
Markdown mode: use configured separators (---, --) to split slides.

5) Emoji support

Quarto's from: markdown+emoji is not a reveal.js feature. In reveal.js:

Use native Unicode emoji directly.
Or render emoji through your markdown/HTML pipeline before reveal initializes.

6) Fit large text and stretch media

r-fit-text and r-stretch are reveal classes and work directly.

<section>
  <div class="r-fit-text">Big Text</div>
</section>

<section>
  <p>Here is an image:</p>
  <img class="r-stretch" src="image.webp" alt="Demo image" />
  <p>Some text after the image.</p>
</section>

7) Reveal content on key press with fragments

<section>
  <h2>It's a candy dog</h2>
  <p style="font-size: 44pt; color: #75aadb;">Would you like to see a candy dog?</p>
  <img class="fragment fade-up" src="./images/dog.webp" alt="Candy dog" />
</section>

8) Two-column and 4-quadrant layouts

Quarto ::: columns is not native reveal syntax. Use HTML/CSS layout wrappers.

<section>
  <div class="cols">
    <div class="col col-70"><img src="./images/image_1.webp" alt="Left" /></div>
    <div class="col col-30">
      <img src="./images/image_2.webp" alt="Right top" />
      <img src="./images/image_3.webp" alt="Right bottom" />
    </div>
  </div>
</section>

.reveal .cols {
  display: flex;
  gap: 1.5rem;
  align-items: flex-start;
}

.reveal .col-70 { flex: 0 0 70%; }
.reveal .col-30 { flex: 0 0 30%; }

For 4 quadrants, use a 2x2 CSS grid and reveal each cell with fragment classes (fade-in-then-semi-out or similar).

9) Custom inline short-code transform (`==text==` -> `<mark>text</mark>`)

function convertMarkedTextInSlide(slide) {
  if (!slide) return;
  slide.innerHTML = slide.innerHTML.replace(/==([^=]+)==/g, '<mark>$1</mark>');
}

Reveal.on('ready', (event) => convertMarkedTextInSlide(event.currentSlide));
Reveal.on('slidechanged', (event) => convertMarkedTextInSlide(event.currentSlide));

10) Inline style and custom CSS

In reveal markdown, use inline HTML for precise text styling:

<p>
  Make this <span style="color: red;">red</span> and this
  <span style="background: yellow;">highlighted</span>.
</p>

Load custom CSS in static HTML:

<link rel="stylesheet" href="./assets/custom.css" />

Or import it in ESM:

import './assets/custom.css';

11) Hide captions and style callouts when your theme emits them

Reveal core does not auto-generate Quarto callouts/captions, but many pipelines output similar markup:

.reveal p.caption,
.reveal figcaption {
  display: none;
}

.reveal .callout-title {
  display: none;
}

12) Vertical flow, slide IDs, menu labels, numbering, and notes

Vertical chapters: nest sections (<section><section>Child</section></section>).
Navigation behavior: use navigationMode: 'default' | 'linear' | 'grid'.
Stable slide URL names: set section id and enable hash: true.
Menu labels (when using the menu plugin): set data-menu-title.
Slide number with total: slideNumber: 'c/t'.
Speaker notes: <aside class="notes">...</aside> and press S.
Overview mode shortcut: Esc.

<section id="intro" data-menu-title="Introduction">
  <h2>Intro</h2>
  <aside class="notes">Presenter-only notes</aside>
</section>

Reveal.initialize({
  hash: true,
  slideNumber: 'c/t',
  navigationMode: 'default',
  plugins: [RevealNotes],
});

13) Choose one bold aesthetic direction before styling

Practical rule:

One deck, one dominant visual idea.
Keep typography, palette, motion, and background treatment coherent with that idea.

14) Use deck-level design tokens (CSS variables)

Create a token layer first, then style components/slides with those tokens.

:root {
  --deck-bg: #f6f3ea;
  --deck-surface: rgba(255, 255, 255, 0.72);
  --deck-text: #1b1a18;
  --deck-accent: #c0392b;
  --deck-muted: #6f6a61;
  --deck-shadow: 0 20px 50px rgba(20, 16, 10, 0.18);
  --deck-radius: 18px;
  --deck-gap: 1.2rem;
}

.reveal {
  color: var(--deck-text);
  background:
    radial-gradient(circle at 12% 18%, rgba(192, 57, 43, 0.12), transparent 45%),
    radial-gradient(circle at 88% 82%, rgba(27, 26, 24, 0.1), transparent 42%),
    var(--deck-bg);
}

15) Build typography hierarchy intentionally

Use a distinctive display face for headings and a separate body face for text-heavy slides. Define consistent scale and line length.

@import url('https://fonts.googleapis.com/css2?family=DM+Serif+Display:[email protected]&family=Manrope:wght@400;500;700;800&display=swap');

.reveal {
  font-family: 'Manrope', 'Helvetica Neue', Arial, sans-serif;
}

.reveal h1,
.reveal h2,
.reveal h3 {
  font-family: 'DM Serif Display', Georgia, 'Times New Roman', serif;
  letter-spacing: 0.01em;
  line-height: 1.05;
}

.reveal p,
.reveal li {
  line-height: 1.45;
  max-width: 58ch;
}

16) Prefer dominant palette + sharp accent over evenly mixed colors

A strong deck usually has:

One dominant background family.
One primary text color.
One high-contrast accent for emphasis, links, and key annotations.

.reveal a,
.reveal strong,
.reveal mark {
  color: var(--deck-accent);
}

.reveal mark {
  background: transparent;
  border-bottom: 0.2em solid color-mix(in srgb, var(--deck-accent) 35%, transparent);
  padding: 0 0.08em;
}

17) Compose slides with atmosphere (not flat backgrounds)

Avoid plain single-color canvases by default. Add depth with subtle gradients, textures, overlays, or layered shadows that match the chosen aesthetic.

.reveal .panel {
  background: var(--deck-surface);
  border: 1px solid rgba(255, 255, 255, 0.5);
  border-radius: var(--deck-radius);
  box-shadow: var(--deck-shadow);
  backdrop-filter: blur(6px);
  padding: calc(var(--deck-gap) * 1.2);
}

18) Use motion as choreography, not decoration

In reveal.js, prioritize:

One meaningful entry sequence per slide (fade-up, fade-in, zoom-in fragments with stagger).
Smooth global transition settings.
Minimal micro-animations elsewhere.

Reveal.initialize({
  transition: 'slide',
  backgroundTransition: 'fade',
  autoAnimateEasing: 'ease-out',
  autoAnimateDuration: 0.6,
});

<section>
  <h2 class="fragment fade-in">Problem</h2>
  <p class="fragment fade-up">Constraint</p>
  <p class="fragment fade-up">Decision</p>
  <p class="fragment fade-up">Outcome</p>
</section>

19) Break predictable layouts with controlled asymmetry

Avoid centering everything. Mix alignment, width, overlap, and whitespace intentionally.

.reveal .asym {
  display: grid;
  grid-template-columns: 1.2fr 0.8fr;
  gap: 2rem;
  align-items: end;
}

.reveal .asym .media {
  transform: translateY(1rem);
}

20) Final anti-generic design pass

Before shipping, quickly verify:

Font choice is intentional and not default/generic.
Color system has a dominant tone plus a clear accent.
At least one memorable visual motif exists (background treatment, type lockup, layout move, or motion sequence).
Slide density is controlled; no wall-of-text pages.
Mobile viewport still preserves hierarchy and readability.

21) Prefer Mermaid for architecture and flow communication

For system overviews, sequence explanations, data flow, and decision logic, use Mermaid slides first. This usually communicates structure faster than dense bullet lists.

<section>
  <h2>Architecture</h2>
  <pre class="mermaid">
flowchart LR
  Client["Client"] -->|HTTPS| API["API Gateway"]
  API --> Service["Application Service"]
  Service --> DB["PostgreSQL"]
  Service --> Queue["Background Queue"]
  Queue --> Worker["Worker"]
  </pre>
</section>

If Mermaid plugin setup is needed:

Reveal.initialize({
  hash: true,
  plugins: [RevealMermaid],
});

Use this decision rule:

Use Mermaid for complex graphs (branching/cycles/cross-links, usually 8+ nodes).
For simple linear pipelines (A -> B -> C -> D), prefer HTML/CSS step cards because they fill slide space better and are easier to style at presentation scale.
Never leave a tiny Mermaid graph alone in large empty space; pair it with supporting content or switch to a split layout.

22) Convert source documents with full coverage (no silent drops)

When turning a plan/spec/review into slides:

Inventory every source item first (sections, tables, cards, decisions, details).
Map each item to slide(s) before writing markup.
Verify coverage at the end: no major section from source should be missing in the deck.

If one source section has high density, split into multiple slides instead of compressing into unreadable bullets.

23) Use slide archetypes to control pacing

Build deck rhythm with explicit slide roles, not repeated generic content slides:

Title for opening tone.
Divider between major topics.
Content for explanation.
Split for comparison (before/after, text+diagram, problem/solution).
Diagram for structure/flow.
Dashboard for metrics/KPIs.
Table for compact factual comparison.
Code for implementation detail.
Quote for emphasis.
Full-bleed for key visual moments.

Avoid long runs of the same archetype.

24) Enforce compositional variety across consecutive slides

Alternate spatial compositions through the sequence:

centered
left-heavy
right-heavy
split
edge-aligned
full-bleed

Rule of thumb: do not use 3 consecutive slides with the same composition pattern.

25) Keep presentation density within slide limits

Use these limits by default:

Content slide: 1 heading + up to 5-6 bullets (max ~2 lines each).
Diagram slide: one primary diagram, usually up to 8-10 nodes at presentation size.
Table slide: up to ~8 rows; overflow moves to next slide.
Code slide: up to ~10 lines focused on one point.
Quote slide: short quote only; long quotes become content slides.

If limits are exceeded, split into additional slides instead of shrinking text.

26) Use presentation-scale typography baselines

Slides are not documents; scale text for screen-share/projector readability:

Display/title: roughly 48-120px
Heading: roughly 28-48px
Body/bullets: roughly 16-24px
Labels/captions: roughly 10-14px

Always prioritize readability from distance over document-like density.

Guardrails

Do not invent reveal.js config keys; only use documented options.
Do not use plugin syntax before registering the corresponding plugin (Markdown/Math/Notes/Highlight, etc.).
For multi-instance pages, prefer new Reveal(rootEl, config) with embedded: true.
In React, avoid duplicate initialization and call destroy() on unmount.
Treat Quarto/Pandoc-only syntax as source material, not runtime reveal.js syntax (::: columns, ::: notes, slide-level, markdown+emoji, callout blocks).
When migrating from Quarto to reveal.js, preserve behavior first (fragment timing, navigation flow, note visibility), then adjust visual styling.
Do not ship visually generic decks. Each deck must have a deliberate aesthetic direction, typography system, palette strategy, and motion intent.
Prefer reveal official solarized theme for default/light-tone decks unless user requirements explicitly call for another theme.
Minimize new custom CSS. First use built-in reveal classes/options; add CSS only when necessary.
When adding CSS, scope selectors to .reveal or a slide-level class and verify impact scope (what selectors will match, which slides/components are affected).
Do not reimplement slide engines (scroll-snap containers, custom nav chrome, custom keyboard routers) when using reveal.js. Use reveal built-ins unless there is a concrete gap.
When borrowing HTML-slide design systems, translate the design language to reveal primitives (section, fragments, built-in navigation) instead of copying unrelated runtime architecture.

Delivery Checklist

First slide renders correctly with no obvious console errors.
Plugin registration matches the content syntax used (Markdown/Notes/Math/Highlight/etc.).
Navigation and interactions match requirements (keyboard, hash, slideNumber, autoSlide, touch).
Theme defaults to official reveal solarized unless requirements explicitly override it.
If custom CSS was added, selector scope and impact were reviewed (which slides/components each rule can affect).
Architecture/process-heavy content uses Mermaid diagrams when appropriate.
Source-to-slide coverage check was completed for conversion tasks (no major source section dropped).
Composition rhythm was reviewed (no 3 consecutive slides with the same layout pattern).
Density limits were respected or split across additional slides.
If export is requested, verify print/PDF workflow end-to-end.

References

External Recipe Source

Some tips and tricks for Quarto when rendering as a reveal.js slideshow (extract reveal.js-applicable patterns; ignore Quarto-only syntax)
Anthropic frontend-design skill (aesthetic direction, typography, color, motion, composition discipline)
visual-explainer slide-patterns (slide archetypes, pacing, density limits, presentation readability)

Adoption

jeasonstudio/slides-revealjs

$ install --global

Security Scan Results

SKILL.md

Slides Skill for reveal.js

Overview

When to Use

Core Workflow

Implementation Templates

1) Static HTML (UMD)

2) npm/ESM

3) Markdown Slide Block

Feature Playbook

Reveal.js Tips

Design Principles (CRITICAL)

Color Palette Selection

Slide Content Principles

30-Second Design Review Checklist

1) Title slide with custom background

2) Move/resize a logo after leaving title slide

3) Background image sizing (cover vs contain)

4) Slide structure control (replacement for Quarto slide-level)

5) Emoji support

6) Fit large text and stretch media

7) Reveal content on key press with fragments

8) Two-column and 4-quadrant layouts

9) Custom inline short-code transform (==text== -> <mark>text</mark>)

10) Inline style and custom CSS

11) Hide captions and style callouts when your theme emits them

12) Vertical flow, slide IDs, menu labels, numbering, and notes

13) Choose one bold aesthetic direction before styling

14) Use deck-level design tokens (CSS variables)

15) Build typography hierarchy intentionally

16) Prefer dominant palette + sharp accent over evenly mixed colors

17) Compose slides with atmosphere (not flat backgrounds)

18) Use motion as choreography, not decoration

19) Break predictable layouts with controlled asymmetry

20) Final anti-generic design pass

21) Prefer Mermaid for architecture and flow communication

22) Convert source documents with full coverage (no silent drops)

23) Use slide archetypes to control pacing

24) Enforce compositional variety across consecutive slides

25) Keep presentation density within slide limits

26) Use presentation-scale typography baselines

Guardrails

Delivery Checklist

References

External Recipe Source

Getting Started

Content

Customization

Features

API

Initialization

Plugins

Other

Related Skills

jeasonstudio/organizing-meeting-reports

openclaw/taskflow

openclaw/extensions/lobster

steipete/extensions/lobster

jeasonstudio/slides-revealjs

$ install --global

Security Scan Results

SKILL.md

Slides Skill for reveal.js

Overview

When to Use

Core Workflow

Implementation Templates

1) Static HTML (UMD)

2) npm/ESM

3) Markdown Slide Block

Feature Playbook

Reveal.js Tips

Design Principles (CRITICAL)

Color Palette Selection

Slide Content Principles

30-Second Design Review Checklist

3) Background image sizing (`cover` vs `contain`)

4) Slide structure control (replacement for Quarto `slide-level`)

9) Custom inline short-code transform (`==text==` -> `<mark>text</mark>`)

3) Background image sizing (`cover` vs `contain`)

4) Slide structure control (replacement for Quarto `slide-level`)

9) Custom inline short-code transform (`==text==` -> `<mark>text</mark>`)