VibeDeck

Step 0: Check Project

Before anything else, check if slide-kit.config.js exists in the current directory.

• Exists → this is an existing slide-kit project. Go to Building Slides.
• Does not exist → no project yet. Go to Creating a New Deck, then continue to Building Slides if the user also described content.

Creating a New Deck

1. Ask for title

Only ask for the project title (required). Show defaults for everything else:

I'll set up the project with these defaults unless you want changes:

• Directory: ./<title-slug>/
• Theme: corporate-blue (also available: minimal)
• Logo: built-in SlideKit logo
• Presenter: none (can set later in config)
• Password: none

Let me know if you want to change any of these, or I'll proceed.

See theme-presets.md for theme details.

2. Scaffold the project

cp -r <this-skill-dir>/template/ <target-dir>
cd <target-dir>
git init

No network required — the template is bundled in this skill.

3. Configure

• slide-kit.config.js: set title, theme, logo, presenter as needed
  • Custom primary color: use overrides.colors.primary — variants auto-derived
  • Custom logo: copy to public/, reference as /filename.svg
• index.html: set <title>
• src/App.jsx: remove PasswordGate if no password

4. Generate agent instructions

Read instruction-template.md, replace placeholders, write to both CLAUDE.md and AGENTS.md.

5. Install and start

npm install
npm run dev

Report: project location, theme, dev server URL.

Building Slides

1. Read context (do this BEFORE planning)

Read these three files first — skipping this step leads to duplicated content, wrong theme colors, or missed conventions:

• CLAUDE.md (or AGENTS.md) — theme, conventions, data sources
• src/App.jsx — current slide list and ordering (what already exists)
• slide-kit.config.js — active theme and presenter info

2. Understand the request

• What content should this slide show?
• Is there data involved? Where does it come from?
• Narrative continuity: new slide should follow logically from the previous one
• No duplication: if a data point is already shown elsewhere, present from a different angle
• Unit consistency: confirm the same units as existing slides ($K vs $M, etc.)

3. Choose layout

See layout-templates.md for code templates:

Built-in slide templates (import from src/slides/):

4. Build the slide

• Layout: MUST use SlideLayout for all content slides — it enforces Title → KeyMessage → Content order. See layout-templates.md
• Charts: chart-components.md
• Style: style-guide.md
• Content: content-rules.md
• Colors: import { colors } from '../theme'

5. Register (checklist)

import SlideXxx from './slides/SlideXxx'

// In <Deck>:
<Slide title="Page Title"><SlideXxx /></Slide>

Before moving on, verify:

• import added at top of App.jsx
• <Slide title="..."> — title is set (powers navigator, do NOT omit)
• Placed in correct position within <Deck> (narrative order)
• footnote prop set if slide uses external data

6. Data extraction (if needed)

• Use scripts/extract-xlsx.js to inspect Excel structure
• Write a custom extraction script, verify totals match
• Save to src/data/<name>.js
• NEVER fabricate data

Important Rules

• NEVER fabricate data — all numbers must come from source files
• When creating a project, generate BOTH CLAUDE.md and AGENTS.md
• slide-kit.config.js is the single source of truth for runtime config
• Slide components: src/slides/Slide<PascalCaseName>.jsx
• Data files: src/data/<kebab-case-name>.js