coreyhaines31/makerskills / skills/slide-deck
slide-deck
VerifiedWhen you want to draft, update, convert, or export a slide deck for a React/Next.js slide system (${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/app/slides/). Writes TypeScript Slide[] arrays using your primitives (Eyebrow, Heading, Accent, Body, BulletList, Divider, TwoCol, GradientText), 12 cycling brand gradients, optional sections for "where am I" context, and speaker notes. Inspired by zarazhangrui/frontend-slides — "show, don't tell" for narrative (presents 3 angles, you pick) plus density modes (speaker-led vs reading-first). Four modes — new (draft from brief), update (modify existing, with overflow guards), ppt (convert legacy PPTX → React deck), export (Playwright snapshot existing React deck to standalone HTML, PDF, or Vercel URL — keeps brand). Triggers on "/slide-deck," "/slides new," "/slides export," "/slides update," "/slides ppt," "draft a deck," "deck for [topic]," "talk on [topic]," "keynote on [topic]," "internal deck for [audience]," "convert this pptx," "export this deck."
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.0 KB |
| references/export.md | markdown | 6.6 KB |
| references/narrative-and-voice.md | markdown | 11.1 KB |
| references/ppt-conversion.md | markdown | 5.4 KB |
| references/system.md | markdown | 5.9 KB |
| references/template.md | markdown | 6.4 KB |
references/system.md
View on GitHub# Slide-deck system reference
Reference layout for the Next.js repo that hosts your branded React decks. Adopt the file structure below, then point `SLIDE_DECK_REPO` at your repo path.
## Locations
| What | Path |
|---|---|
| **Deck routes** | `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/app/slides/<slug>/page.tsx` |
| **Per-deck layout** | `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/app/slides/<slug>/layout.tsx` |
| **Shared primitives** | `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/components/slides/slide-primitives.tsx` |
| **SlideDeck component** | `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/components/slides/slide-deck.tsx` |
| **Sections types** | `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/components/slides/sections.ts` |
| **Brand gradients** | `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/lib/gradients.ts` (12 cycling, applied automatically) |
| **Existing decks (style refs)** | `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/app/slides/marketing-like-an-engineer/page.tsx`, `${SLIDE_DECK_REPO:-$HOME/code/your-slide-deck-site}/src/app/slides/skill-for-your-skills/page.tsx` |
## Imports a `page.tsx` typically needs
```typescript
"use client";
import { SlideDeck, type Slide } from "@/components/slides/slide-deck";
import type { SectionRange } from "@/components/slides/sections";
import {
Eyebrow,
Heading,
Accent,
Body,
BulletList,
Divider,
TwoCol,
GradientText,
} from "@/components/slides/slide-primitives";
```
Only import the primitives the deck actually uses.
## Primitives
| Primitive | Use | Notes |
|---|---|---|
| `<Eyebrow>` | Small all-caps label above a heading | Section tag, slide kind, "Keynote" / "Chapter 1" etc. |
| `<Heading>` | Slide-level header (`<h2>`-equivalent) | Most slides have one |
| `<Accent>` | Inline keyword styled with the slide's gradient | Use in `<h1>` or `<Heading>`. One per slide max. |
| `<GradientText>` | Same as Accent but takes `className` for custom layout | Use when `<Accent>` doesn't fit |
| `<Body>` | Paragraph text | Soft gray, max-width-2xl, relaxed leading |
| `<BulletList items={[]}>` | Tight 3–7 bullet list | Pass array of strings |
| `<Divider>` | Dashed horizontal rule | Use sparingly to break up content |
| `<TwoCol left={} right={}>` | Two-column grid | Comparison, before/after, problem/solution |
## Title-slide pattern (from `marketing-like-an-engineer`)
```tsx
{
id: "title",
content: (
<div className="flex flex-col justify-center h-full max-w-3xl">
<p className="text-sm uppercase tracking-[0.08em] font-heading font-medium text-[#4d4d4d]/40 mb-4">
Keynote
</p>
<h1 className="font-heading font-medium text-[4.236rem] leading-[1.05] tracking-[-0.02em] text-[#4d4d4d] mb-6 text-balance">
Marketing Like an <Accent>Engineer</Accent>
</h1>
<p className="text-[#4d4d4d]/50 text-xl font-heading">
<SPEAKER_NAME>
</p>
</div>
),
notes: [
"Welcome everyone — excited to be here.",
"This talk is about applying the engineering mindset to marketing.",
"By the end you'll have a framework you can take home and start building Monday.",
],
}
```
Use this as the title slide template. Swap copy + adjust `<Accent>` to the topic's keyword.
## Slide type
```typescript
type Slide = {
id: string; // kebab-case, unique per deck (used for anchors)
content: React.ReactNode;
notes?: string[]; // 3–5 lines, complete spoken thoughts
};
```
## Sections type + pattern
```typescript
type SectionRange = { name: string; from: number; to: number };
```
`from` / `to` are **zero-indexed slide indices** (slide 1 = index 0).
Example from `marketing-like-an-engineer`:
```typescript
const sections: SectionRange[] = [
{ name: "Title", from: 0, to: 0 },
{ name: "Intro", from: 1, to: 4 },
{ name: "Takeaways", from: 5, to: 6 },
{ name: "Reframe marketing", from: 7, to: 11 },
{ name: "The system", from: 12, to: 18 },
{ name: "All roads lead to Rome", from: 19, to: 19 },
{ name: "Close", from: 20, to: 22 },
];
```
Sections drive the presenter view's "where am I" context. Use them for keynote-length decks. Optional for short decks.
## Component invocation
```tsx
export default function MyDeckPage() {
return <SlideDeck slides={slides} sections={sections} />;
}
```
`sections` is optional.
## layout.tsx pattern
```tsx
import type { Metadata } from "next";
export const metadata: Metadata = {
title: "<Deck Title>",
};
export default function <DeckName>Layout({
children,
}: {
children: React.ReactNode;
}) {
return <>{children}</>;
}
```
The `title` becomes the browser tab title when presenting.
## Brand colors used in primitives
- **Text**: `#4d4d4d` (charcoal)
- **Muted text**: `#4d4d4d` with opacity (`/40`, `/45`, `/50`, `/70`, `/80`)
- **Font heading**: `font-heading` (custom class) for display sizes
- **Brand gradients**: 12 in rotation, applied automatically via CSS vars — don't hardcode gradient colors per slide
## Comment patterns from existing decks
Use these horizontal rules as section markers in the slides array — they make the file scan-able:
```typescript
// ─── Slides ───────────────────────────────────────────────────────────────────
// ═══════════════════════════════════════════════════════════════════════════
// ACT 1 — HOOK & FRAME
// ═══════════════════════════════════════════════════════════════════════════
// 1. Title
{ ... },
// 2. Surreal moment
{ ... },
```
Comments aren't strictly necessary but help when editing a 20+ slide deck.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |