make-slide
Universal AI skill for generating standalone HTML slide decks
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/kuneosu--make-slide)HTML
<a href="/listings/kuneosu--make-slide"><img src="/api/listings/kuneosu--make-slide/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install with npx (Recommended)
npx make-slide init
This will: 1. Copy the skill files into your project's `.claude/skills/make-slide/` 2. Auto-detect your AI config (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`) and inject the `/make-slide` command 3. You're ready! Type `/make-slide` in Claude Code to create presentations
Other Commands
npx make-slide themes # View all 10 themes npx make-slide gallery # Open theme gallery in browser npx make-slide help # Show help
Manual Setup (Any AI Tool)
Give your AI coding tool the following instruction:
Read SKILL.md from https://github.com/kuneosu/make-slide and create a presentation about [your topic] using the minimal-dark theme.
Or fetch it directly:
Fetch https://raw.githubusercontent.com/kuneosu/make-slide/main/.claude/skills/make-slide/SKILL.md and follow its instructions to create a presentation about [your topic].
> **Tip:** Browse themes first at [make-slide.vercel.app](https://make-slide.vercel.app) and tell your AI which one you like!
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 510 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # make-slide — AI Presentation Skill
- ## Overview
- **make-slide** is a universal skill for AI coding agents that generates single-file HTML presentations with speaker notes. The output is always a standalone `.html` file with all CSS and JS inlined — no build step, no framework, no dependencies beyond font CDNs.
- Any AI coding tool (Claude Code, Gemini CLI, Codex, Cursor, etc.) can read this file and follow the instructions to generate professional presentations.
- **Repository**: [github.com/kuneosu/make-slide](https://github.com/kuneosu/make-slide)
- **Theme Gallery**: [make-slide.vercel.app](https://make-slide.vercel.app)
- ---
- ## When to Use
- Activate this skill when the user's request matches any of these patterns:
- - "Make a presentation about..."
- - "Create slides for..."
- - "Build a slide deck..."
- - "Turn this into a presentation"
- - "Make a talk about..."
- - "Create a pitch deck for..."
- - "Generate presentation slides..."
- - Any request involving: **presentation**, **slides**, **deck**, **talk**, **keynote**, **pitch**, **slideshow**
- ---
- ## Input Modes
- Determine which mode applies based on the user's input:
- ### Mode A: Topic Only
- The user provides a topic and optionally a duration or audience.
- ```
- "Make a 15-min talk about AI trends"
- "Create a presentation on microservices architecture"
- ```
- → You design the structure, content, and speaker notes from scratch.
- ### Mode B: Content/Material Provided
- The user provides source material (documents, notes, data, articles).
- ```
- "Turn this document into a presentation"
- "Create slides based on these meeting notes"
- ```
- → You organize and distill the material into slides + speaker notes.
- ### Mode C: Script Provided
- The user provides a written speech or speaking script.
- ```
- "Create slides for this speech script"
- "Make a visual deck that accompanies this talk"
- ```
- → You analyze the script's structure and create matching visual slides. The script becomes the speaker notes.
- ---
- ## Workflow
- Follow these steps in order:
- ### Step 1: Analyze Input
- - Determine the input mode (A, B, or C)
- - Estimate the appropriate number of slides:
- - 5-min talk → 8-12 slides
- - 10-min talk → 12-18 slides
- - 15-min talk → 18-25 slides
- - 20-min talk → 25-30 slides
- - 30-min talk → 30-40 slides
- - Identify the target audience and tone (technical, business, casual, academic)
- - Detect the user's language from the conversation (generate content in that language)
- ### Step 2: Choose a Theme
- Present the user with the theme gallery link for browsing:
- > **Browse themes here**: https://make-slide.vercel.app
- If the user doesn't choose a theme, recommend one based on context:
- - Tech/developer talk → `minimal-dark` or `neon-terminal`
- - Business/corporate → `corporate` or `minimal-light`
- - Startup pitch → `gradient-pop` or `keynote-apple`
- - Data/analytics → `data-focus`
- - Education/workshop → `paper` or `playful`
- - Design/creative → `magazine`
- - Product launch → `keynote-apple`
- - Casual/team event → `playful`
- ### Step 3: Check Image Needs
- Ask the user:
- > "Would you like me to identify image insertion points in the slides? If yes, I'll mark them in the outline and you can provide image URLs. If no, I'll use styled placeholders."
- - **Yes** → Mark image positions in the outline, ask user for image URLs
- - **No** → Use CSS placeholders (emoji, SVG icons, CSS shapes) that match the theme
- ### Step 4: Generate Outline
- Create a slide-by-slide outline with:
- - Slide number
- - Slide type (from Slide Types Reference below)
- - Title
- - Key points / content summary
- - Image placement (if applicable)
- Present the outline to the user for confirmation. Wait for approval or modifications before proceeding.
- ### Step 5: Fetch Theme Reference
- Fetch the chosen theme's reference files from GitHub:
- 1. **reference.html** — The complete example presentation with all slide types, styles, navigation, and interactive features. This is your primary template.
- 2. **README.md** — Design guidelines including color palette, typography, spacing rules, and design philosophy.
- Use the raw GitHub URLs listed in the Theme List section below.
- ### Step 6: Generate HTML
- Using the reference.html as your template:
- - Replicate the exact HTML structure, CSS styles, and JS functionality
- - Replace the demo content with the user's actual content
- - Keep all interactive features (navigation, fullscreen, speaker notes, etc.)
- - Match the theme's typography, colors, spacing, and animations
- - Ensure all slide types used match the patterns in the reference
- ### Step 7: Generate Speaker Notes
- Add speaker notes as `data-notes` attributes on each slide's `<div>`:
- ```html
- <div class="slide" data-notes="Welcome everyone. Today I'll be talking about...">
- ```
- - Notes should be conversational and natural
- - Include timing cues where helpful (e.g., "[PAUSE]", "[2 min]")
- - Don't just repeat the slide text — expand on it
- - Include transitions between slides (e.g., "Now let's move on to...")
- ### Step 8: Generate Script (Mode A and B only)
- For Mode A and B, also generate a separate `script.md` file containing:
- - Full speaking script organized by slide
- - Timing estimates per section
- - Audience interaction cues
- - Key points to emphasize
- For Mode C, the user already has a script — skip this step.
- ### Step 9: Save and Deliver
- - Save the presentation as `index.html` (or user-specified filename)
- - Save the script as `script.md` (if generated)
- - Offer to start a local server for preview:
- ```bash
- # Python
- python -m http.server 8000
- # Node.js
- npx serve .
- ```
- ---
- ## Theme List
- | # | Theme ID | Style | Best For | Reference HTML | README |
- |---|----------|-------|----------|---------------|--------|
- | 1 | `minimal-dark` | Clean dark background, white typography, modern minimal | Tech conferences, developer talks, open source presentations | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/minimal-dark/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/minimal-dark/README.md) |
- | 2 | `minimal-light` | Bright white background, precise typography, Apple-inspired | General presentations, corporate meetings, academic lectures | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/minimal-light/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/minimal-light/README.md) |
- | 3 | `corporate` | Navy and gold accents, professional structured layout | Business presentations, investor meetings, quarterly reports | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/corporate/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/corporate/README.md) |
- | 4 | `gradient-pop` | Vibrant purple-pink-orange gradients, glass-morphism cards | Startup pitches, product launches, marketing campaigns | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/gradient-pop/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/gradient-pop/README.md) |
- | 5 | `neon-terminal` | Terminal-style dark theme, neon green/cyan, scanline effects | Developer conferences, hackathons, CTF events, security talks | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/neon-terminal/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/neon-terminal/README.md) |
- | 6 | `paper` | Warm kraft-paper aesthetic, serif typography, terracotta accents | Educational talks, academic conferences, workshops, research | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/paper/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/paper/README.md) |
- | 7 | `keynote-apple` | Dramatic dark/gradient backgrounds, Apple keynote-inspired | Product launches, keynote conferences, executive briefings | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/keynote-apple/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/keynote-apple/README.md) |
- | 8 | `magazine` | Editorial magazine layout, asymmetric design, dramatic typography | Design presentations, portfolio reviews, brand guidelines | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/magazine/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/magazine/README.md) |
- | 9 | `data-focus` | Clean data-centric layout, dashboard aesthetics, trend indicators | Data analysis, KPI dashboards, financial reviews, statistical reports | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/data-focus/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/data-focus/README.md) |
- | 10 | `playful` | Rounded corners, pastel colors, emoji accents, bouncy animations | Team workshops, casual tech talks, retrospectives, community events | [reference.html](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/playful/reference.html) | [README.md](https://raw.githubusercontent.com/kuneosu/make-slide/main/themes/playful/README.md) |
- ---
- ## HTML Requirements
- Every generated presentation **MUST** include all of the following features. These are non-negotiable.
- ### File Structure
- - Single standalone `.html` file
- - All CSS inlined in `<style>` tags
- - All JS inlined in `<script>` tags
- - No external files except CDN links listed below
- ### Required CDN Dependencies
- ```html
- <!-- Pretendard Font (MANDATORY) -->
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard/dist/web/static/pretendard.min.css">
- <!-- JetBrains Mono for code blocks -->
- <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&display=swap">
- <!-- Prism.js for syntax highlighting (ONLY if code blocks exist) -->
- <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css">
- <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
- <!-- Add language components as needed -->
- <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-javascript.min.js"></script>
- ```
- ### Keyboard Navigation
- - `←` / `→` Arrow keys: Previous / Next slide
- - `Space`: Next slide
- - `F`: Toggle fullscreen
- - `S`: Toggle speaker notes panel
- - `Escape`: Exit fullscreen
- ### Slide Counter
- - Display current slide number and total: `3 / 25`
- - Position: bottom-right or as defined by the theme
- ### Progress Bar
- - Visual progress indicator showing position in the deck
- - Updates on each slide transition
- ### Fullscreen
- - `F` key toggles fullscreen mode
- - Fullscreen button in the UI controls
- - Uses the Fullscreen API (`requestFullscreen`)
- ### Speaker Notes Panel
- - `S` key toggles the speaker notes panel
- - Panel displays:
- - Current slide's notes (from `data-notes` attribute)
- - Next slide preview (when possible)
- - Panel should not obstruct the main slide view
- ### PDF Export
- ```css
- @media print {
- /* Hide all UI controls */
- .controls, .progress-bar, .slide-counter,
- .fullscreen-btn, .speaker-notes-panel,
- nav, button { display: none !important; }
- /* Each slide = 1 page, landscape */
- .slide {
- page-break-after: always;
- width: 100vw;
- height: 100vh;
- }
- @page {
- size: landscape;
- margin: 0;
- }
- }
- ```
- ### Touch/Swipe Navigation
- - Swipe left → Next slide
- - Swipe right → Previous slide
- - Implement using touch event listeners (`touchstart`, `touchend`)
- ### Slide Transitions
- - Fade transition between slides (CSS transitions or animations)
- - Smooth and professional — no jarring jumps
- ### Staggered Element Animations
- - Elements within a slide animate in sequentially (stagger effect)
- - Use CSS animations with incremental `animation-delay`
- - Trigger animations when the slide becomes active
- ### Aspect Ratio
- - 16:9 aspect ratio for all slides
- - Centered on screen with letterboxing if needed
- ### Responsive Design
- - Scales to fit various screen sizes
- - Text remains readable at all resolutions
- - Controls adapt to screen size
- ### Content Overflow
- - Apply `overflow-y: auto` on slide content areas
- - Prevents content from being clipped if a slide has more content than fits
- - Scrollbar should be subtle and match the theme
- ---
- ## Image Handling
- ### Default: CSS Placeholders
- When no image URLs are provided, use styled placeholders that match the theme:
- ```html
- <!-- Emoji-based placeholder -->
- <div class="image-placeholder">
- <span class="placeholder-icon">🚀</span>
- <span class="placeholder-label">Product Screenshot</span>
- </div>
- <!-- CSS shape placeholder -->
- <div class="image-placeholder gradient-bg">
- <svg>...</svg>
- </div>
- ```
- ### When User Provides URLs
- ```html
- <img src="https://example.com/image.jpg" alt="Description" loading="lazy">
- ```
- - Always include descriptive `alt` text
- - Use `loading="lazy"` for images below the fold
- - Style images to fit within the slide layout without overflow
- ---
- ## Code Blocks
- ### Syntax Highlighting with Prism.js
- - **Only include Prism.js CDN when code blocks are present** in the presentation
- - If no code blocks exist, omit all Prism.js `<link>` and `<script>` tags
- ### Supported Languages
- Include Prism.js language components as needed:
- - `prism-javascript.min.js` — JavaScript
- - `prism-typescript.min.js` — TypeScript
- - `prism-python.min.js` — Python
- - `prism-markup.min.js` — HTML/XML (included in core)
- - `prism-css.min.js` — CSS (included in core)
- - `prism-bash.min.js` — Bash/Shell
- - `prism-json.min.js` — JSON
- - `prism-java.min.js` — Java
- - `prism-go.min.js` — Go
- - `prism-rust.min.js` — Rust
- ### Code Block Markup
- ```html
- <pre><code class="language-javascript">
- function hello() {
- console.log("Hello, World!");
- }
- </code></pre>
- ```
- - Use `JetBrains Mono` font for all code blocks
- - Ensure adequate contrast for readability
- - Match the code theme to the presentation theme (dark themes → dark code, light themes → light code)
- ---
- ## Output Rules
- 1. **Always output a single `.html` file** with all CSS and JS inlined
- 2. **Only allowed external dependencies**: Font CDNs (Pretendard, JetBrains Mono) + Prism.js CDN (conditional)
- 3. **Speaker notes** embedded as `data-notes` attributes on each slide `<div>`
- 4. **Optionally output `script.md`** for full speaking script (Mode A and B)
- 5. **Generate content in the user's language** — detect from the conversation context
- 6. **Filename**: `index.html` by default, or as specified by the user
- 7. **Do not use any JavaScript frameworks** — vanilla JS only
- 8. **Do not use any CSS frameworks** — vanilla CSS only
- ---
- ## Slide Types Reference
- Every theme supports these common slide types. Use the appropriate type based on content needs:
- ### 1. Title Slide
- The opening slide with presentation title, subtitle, presenter name, and date.
- ```
- [Large Title]
- [Subtitle or tagline]
- [Presenter Name — Date]
- ```
- ### 2. Agenda / Table of Contents
- Overview of the presentation structure with numbered sections.
- ```
- [Agenda heading]
- 01. First Section
- 02. Second Section
- 03. Third Section
- ...
- ```
- ### 3. Section Divider
- Marks the beginning of a new section. Usually has a big number or icon.
- ```
- [Big Number: 01]
- [Section Title]
- [Optional brief description]
- ```
- ### 4. Content Slide
- Standard slide with heading and bullet points or paragraphs.
- ```
- [Heading]
- • Point one
- • Point two
- • Point three
- [Optional supporting text]
- ```
- ### 5. Quote Slide
- Features a prominent quotation with attribution.
- ```
- "The best way to predict the future is to invent it."
- — Alan Kay
- ```
- ### 6. Comparison Slide
- Side-by-side columns comparing two concepts, approaches, or options.
- ```
- [Left Column: Option A] [Right Column: Option B]
- - Feature 1 - Feature 1
- - Feature 2 - Feature 2
- ```
- ### 7. Flow / Process Slide
- Step-by-step process visualization with arrows or connectors.
- ```
- [Step 1] → [Step 2] → [Step 3] → [Step 4]
- ```
- ### 8. Card Grid Slide
- 2-4 cards arranged in a grid, each with an icon, title, and description.
- ```
- [🎯 Card 1] [🚀 Card 2]
- [Title] [Title]
- [Desc] [Desc]
- [💡 Card 3] [⚡ Card 4]
- [Title] [Title]
- [Desc] [Desc]
- ```
- ### 9. Data / Chart Slide
- Statistics, metrics, bar charts, or KPI displays. Use CSS-only charts when possible.
- ```
- [Metric: 95%] [Metric: 2.5x] [Metric: 10K+]
- [CSS bar chart or visual representation]
- ```
- ### 10. Code Block Slide
- Syntax-highlighted code with optional title and description.
- ```
- [Title: Implementation Example]
- ┌──────────────────────────┐
- │ function example() { │
- │ return "hello"; │
- │ } │
- └──────────────────────────┘
- [Optional explanation below]
- ```
- ### 11. Image Slide
- Slide featuring an image (or placeholder) with optional caption.
- ```
- [Image or Placeholder]
- [Caption text]
- ```
- ### 12. Closing Slide
- Final slide with thank you message, contact info, or call to action.
- ```
- [Thank You]
- [Contact info / Social links / QR code]
- [Call to action]
- ```
- ---
- ## Tips for Best Results
- ### Content
- - Keep slides concise: **max 6-8 bullet points** per slide
- - One core idea per slide
- - Use short phrases, not full sentences, on slides
- - Save detailed explanations for speaker notes
- ### Design
- - Use the theme's accent color for emphasis and key terms
- - Match typography hierarchy exactly from the reference.html
- - Maintain consistent spacing and padding throughout
- - Don't override the theme's core design — work within its system
- ### Speaker Notes
- - Write notes in a conversational tone
- - Don't just repeat the slide text — expand, explain, give examples
- - Include timing hints: "[This section: ~3 minutes]"
- - Add transition phrases: "Now let's look at...", "Building on that..."
- - Mark audience interaction points: "[ASK AUDIENCE]", "[DEMO]", "[PAUSE]"
- ### Data Visualization
- - Use CSS-only charts when possible (bar charts, progress bars, donut charts)
- - Keep numbers round and memorable (say "nearly 50%" not "49.7%")
- - Highlight the most important metric with size or color
- ### Performance
- - Keep total HTML file size reasonable (under 200KB ideally)
- - Use `loading="lazy"` on images
- - Minimize complex CSS animations on slides with heavy content
- ### Accessibility
- - Maintain sufficient color contrast ratios
- - Include `alt` text on all images
- - Ensure keyboard navigation works for all interactive elements
- - Use semantic HTML where appropriate
- ---
- ## Quick Start Example
- If the user says: *"Make a 10-minute presentation about Python best practices"*
- 1. **Mode**: A (Topic only)
- 2. **Slides**: ~15 slides
- 3. **Theme recommendation**: `minimal-dark` or `neon-terminal` (developer topic)
- 4. **Ask**: Theme preference + image needs
- 5. **Generate outline** → Get confirmation
- 6. **Fetch**: `minimal-dark/reference.html` + `minimal-dark/README.md`
- 7. **Generate**: `index.html` + `script.md`
- 8. **Offer**: Local server preview
- ---
- *Skill version: 1.0 | Repository: [kuneosu/make-slide](https://github.com/kuneosu/make-slide)*
README.md · README · 360 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # make-slide 🎯
- **AI-powered presentation skill that generates stunning single-file HTML slide decks.**
- **AI 코딩 에이전트가 단일 HTML 파일로 고품질 프레젠테이션을 생성하는 범용 스킬.**
- [](https://make-slide.vercel.app)
- [](https://www.npmjs.com/package/make-slide)
- [](LICENSE)
- ---
- ## What is make-slide?
- **make-slide** is a skill (instruction set) for AI coding agents — like Claude Code, Gemini CLI, Codex, Cursor, and others — that enables them to generate professional presentation slides as a **single HTML file**.
- Instead of crafting designs from scratch every time (wasting tokens and producing inconsistent results), the AI references pre-built theme templates from this repository. The result is:
- - **Token-efficient** — AI fetches a reference file instead of inventing layouts
- - **Consistent quality** — every presentation follows a polished, tested design system
- - **Zero dependencies** — output is one `.html` file you can open anywhere
- > Think of it as a **design system for AI-generated presentations**.
- ---
- ## ✨ Features
- | Feature | Description |
- |---------|-------------|
- | 🎨 **10 Themes** | From dark minimal to playful pastels — [browse the gallery](https://make-slide.vercel.app) |
- | 📄 **Single HTML Output** | One file, no build step, no framework — just open in a browser |
- | 🎤 **Speaker Notes** | Built-in presenter mode with per-slide notes (press `S`) |
- | 🖨️ **PDF Export** | Print-ready via `Ctrl+P` with clean `@media print` styles |
- | 🖥️ **Fullscreen** | One-key fullscreen toggle (press `F`) |
- | ⌨️ **Keyboard Navigation** | Arrow keys, spacebar, touch/swipe support |
- | 📥 **3 Input Modes** | Topic only / Content provided / Script provided |
- | 📐 **4 Layout Styles** | Centered, Wide, Split, Editorial — [browse layouts](https://make-slide.vercel.app) |
- | 📊 **PPTX Export** | Generate PowerPoint files alongside HTML |
- | 🖼️ **Auto Image Search** | Automatically find and place relevant images from Unsplash |
- | 🤖 **Works with Any AI Tool** | Claude Code, Gemini CLI, Codex, Cursor, and more |
- | 🌍 **Language-Agnostic** | Generates content in whatever language you speak |
- | 📊 **CSS-Only Charts** | Bar charts, progress rings, KPI cards — no chart library needed |
- ---
- ## 🚀 Quick Start
- ### Install with npx (Recommended)
- ```bash
- npx make-slide init
- ```
- This will:
- 1. Copy the skill files into your project's `.claude/skills/make-slide/`
- 2. Auto-detect your AI config (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`) and inject the `/make-slide` command
- 3. You're ready! Type `/make-slide` in Claude Code to create presentations
- ### Other Commands
- ```bash
- npx make-slide themes # View all 10 themes
- npx make-slide gallery # Open theme gallery in browser
- npx make-slide help # Show help
- ```
- ### Manual Setup (Any AI Tool)
- Give your AI coding tool the following instruction:
- ```
- Read SKILL.md from https://github.com/kuneosu/make-slide and create a presentation about [your topic] using the minimal-dark theme.
- ```
- Or fetch it directly:
- ```
- Fetch https://raw.githubusercontent.com/kuneosu/make-slide/main/.claude/skills/make-slide/SKILL.md and follow its instructions to create a presentation about [your topic].
- ```
- > **Tip:** Browse themes first at [make-slide.vercel.app](https://make-slide.vercel.app) and tell your AI which one you like!
- ---
- ## ⚙️ How It Works
- ### The `.claude/skills/` Convention
- make-slide uses Claude Code's native skill system. After running `npx make-slide init`, your project gets:
- ```
- your-project/
- ├── .claude/
- │ └── skills/
- │ └── make-slide/
- │ ├── SKILL.md ← Main instruction file
- │ └── references/
- │ ├── themes.md ← 10 themes + GitHub raw URLs
- │ ├── layouts.md ← 4 layout styles
- │ ├── slide-types.md ← 12 slide type patterns
- │ ├── html-spec.md ← HTML requirements
- │ ├── core-features.md ← Copy-paste JS/CSS for features
- │ └── pptx-spec.md ← PPTX conversion rules
- ├── CLAUDE.md ← Auto-updated with /make-slide command
- └── ... your project files
- ```
- When you type `/make-slide` in Claude Code, it reads the skill and follows a 10-step workflow:
- 1. **Analyze input** — mode (topic / content / script), slide count, output format (HTML / PPTX)
- 2. **Choose a theme** — pick from the [gallery](https://make-slide.vercel.app) or AI recommends
- 3. **Choose a layout** — Centered, Wide, Split, or Editorial
- 4. **Image options** — no images / provide URLs / auto-search from Unsplash
- 5. **Generate outline** — slide-by-slide plan for your approval
- 6. **Fetch theme + layout reference** — downloads templates from GitHub
- 7. **Generate HTML** — builds presentation matching theme + layout exactly
- 8. **Add speaker notes** — popup window with timing cues
- 9. **Generate script** — full speaking script (optional)
- 10. **Deliver** — saves `index.html` (and `presentation.pptx` if PPTX mode)
- Theme files are fetched from GitHub on demand — nothing heavy is stored locally.
- ---
- ## 🎨 Themes
- All 10 themes are live at **[make-slide.vercel.app](https://make-slide.vercel.app)**
- | # | Theme | Style | Best For |
- |:-:|-------|-------|----------|
- | 1 | `minimal-dark` | Clean dark, white typography | Tech talks, conferences |
- | 2 | `minimal-light` | Bright white, precise type | General, academic |
- | 3 | `corporate` | Navy & gold, structured | Business, reports |
- | 4 | `gradient-pop` | Vibrant gradients, glassmorphism | Startups, pitches |
- | 5 | `neon-terminal` | Terminal green, scanlines | Dev talks, hackathons |
- | 6 | `paper` | Kraft paper, serif type | Education, workshops |
- | 7 | `keynote-apple` | Dramatic dark, Apple-inspired | Product launches, keynotes |
- | 8 | `magazine` | Editorial, asymmetric layout | Design, creative |
- | 9 | `data-focus` | Dashboard aesthetic, clean | Data analysis, KPIs |
- | 10 | `playful` | Rounded, pastel, bouncy | Workshops, casual talks |
- ---
- ## 📁 Project Structure
- ```
- make-slide/
- ├── package.json # npm package config
- ├── bin/cli.js # CLI (init, themes, gallery)
- ├── .claude/skills/make-slide/ # Skill template (copied by init)
- │ ├── SKILL.md
- │ └── references/
- │ ├── themes.md
- │ ├── layouts.md
- │ ├── slide-types.md
- │ ├── html-spec.md
- │ ├── core-features.md
- │ └── pptx-spec.md
- ├── layouts/ # Layout references (4 styles)
- │ ├── centered/
- │ ├── wide/
- │ ├── split/
- │ └── editorial/
- ├── SKILL.md # Legacy standalone skill file
- ├── README.md # This file
- ├── LICENSE # MIT License
- │
- ├── themes/ # Theme references (10 themes)
- │ ├── minimal-dark/
- │ │ ├── README.md # Design guidelines
- │ │ └── reference.html # Full example presentation
- │ ├── minimal-light/
- │ ├── corporate/
- │ ├── gradient-pop/
- │ ├── neon-terminal/
- │ ├── paper/
- │ ├── keynote-apple/
- │ ├── magazine/
- │ ├── data-focus/
- │ └── playful/
- │
- ├── gallery/ # Theme gallery website (Vercel)
- │ └── index.html
- │
- ├── core/ # Shared JS/CSS source
- │ ├── navigation.js
- │ ├── fullscreen.js
- │ ├── speaker-notes.js
- │ ├── pdf-export.css
- │ └── base.css
- │
- └── examples/ # Example presentations
- └── pineone-talk-reference.html
- ```
- ---
- ## 🤝 Contributing
- ### Adding a New Theme
- 1. Create a folder in `themes/` with your theme ID (kebab-case):
- ```
- themes/your-theme-name/
- ```
- 2. Add these files:
- - `reference.html` — Complete 10-slide example with all slide types, navigation, fullscreen, speaker notes, and PDF export
- - `README.md` — Design guidelines: color palette, typography, spacing, philosophy
- 3. Follow the conventions in `core/` for navigation, fullscreen, speaker notes, and PDF export
- 4. Submit a PR — your theme will appear in the gallery!
- ### Guidelines
- - Output must be a single `.html` file — all CSS/JS inlined
- - Only external dependencies: font CDNs (Pretendard required) + Prism.js (for code blocks)
- - All themes must support the full slide type set
- - Test keyboard navigation, fullscreen, speaker notes, and print export
- ---
- ## 📜 License
- [MIT](LICENSE) — use freely for personal and commercial projects.
- ---
- ---
- <br>
- # make-slide 🎯 (한국어)
- **AI 코딩 에이전트가 단일 HTML 파일로 고품질 프레젠테이션을 생성하는 범용 스킬.**
- [](https://make-slide.vercel.app)
- [](https://www.npmjs.com/package/make-slide)
- [](LICENSE)
- ---
- ## make-slide란?
- **make-slide**는 Claude Code, Gemini CLI, Codex, Cursor 등 AI 코딩 에이전트를 위한 스킬(지침서)입니다. AI가 이 스킬을 읽고 따라하면 전문적인 프레젠테이션 슬라이드를 **단일 HTML 파일**로 생성합니다.
- 매번 처음부터 디자인을 만드는 대신(토큰 낭비 + 일관성 없는 결과), AI가 이 레포의 사전 제작된 테마 템플릿을 참조합니다:
- - **토큰 절약** — AI가 레이아웃을 발명하는 대신 레퍼런스 파일을 가져옴
- - **일관된 품질** — 모든 프레젠테이션이 검증된 디자인 시스템을 따름
- - **제로 의존성** — 결과물은 어디서나 열 수 있는 `.html` 파일 하나
- > **AI 생성 프레젠테이션을 위한 디자인 시스템**이라고 생각하세요.
- ---
- ## 🚀 빠른 시작
- ### npx로 설치 (권장)
- ```bash
- npx make-slide init
- ```
- 이 명령어는:
- 1. `.claude/skills/make-slide/`에 스킬 파일 복사
- 2. AI 설정 파일(`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`) 자동 감지 후 `/make-slide` 명령어 주입
- 3. 준비 완료! Claude Code에서 `/make-slide` 입력하면 프레젠테이션 생성
- ### 기타 명령어
- ```bash
- npx make-slide themes # 10개 테마 보기
- npx make-slide gallery # 테마 갤러리 열기
- npx make-slide help # 도움말
- ```
- ### 수동 설정 (다른 AI 도구)
- AI 코딩 도구에 다음과 같이 지시하세요:
- ```
- https://github.com/kuneosu/make-slide 의 SKILL.md를 읽고 [주제]에 대한 프레젠테이션을 minimal-dark 테마로 만들어줘.
- ```
- > **팁:** [make-slide.vercel.app](https://make-slide.vercel.app)에서 테마를 먼저 둘러보고 마음에 드는 것을 AI에게 알려주세요!
- ---
- ## ⚙️ 작동 방식
- ### `.claude/skills/` 컨벤션
- `npx make-slide init` 실행 후 프로젝트 구조:
- ```
- your-project/
- ├── .claude/
- │ └── skills/
- │ └── make-slide/
- │ ├── SKILL.md ← 메인 지침서
- │ └── references/
- │ ├── themes.md ← 10개 테마 + GitHub raw URL
- │ ├── layouts.md ← 4가지 레이아웃 스타일
- │ ├── slide-types.md ← 12가지 슬라이드 타입
- │ ├── html-spec.md ← HTML 요구사항
- │ ├── core-features.md ← 기본 기능 JS/CSS 코드
- │ └── pptx-spec.md ← PPTX 변환 규칙
- ├── CLAUDE.md ← /make-slide 명령어 자동 추가
- └── ... 프로젝트 파일들
- ```
- Claude Code에서 `/make-slide` 입력하면 9단계 워크플로우를 따릅니다:
- 1. **입력 분석** — 모드(주제/내용/대본), 슬라이드 수, 출력 형식(HTML/PPTX) 결정
- 2. **테마 선택** — [갤러리](https://make-slide.vercel.app)에서 선택하거나 AI가 추천
- 3. **레이아웃 선택** — Centered, Wide, Split, Editorial 중 선택
- 4. **이미지 옵션** — 없음 / URL 제공 / Unsplash 자동 검색
- 5. **아웃라인 생성** — 슬라이드별 구성 승인
- 6. **테마 + 레이아웃 레퍼런스** — GitHub에서 템플릿 다운로드
- 7. **HTML 생성** — 테마 + 레이아웃에 맞는 프레젠테이션 빌드
- 8. **발표자 노트** — 팝업 윈도우 방식, 타이밍 큐 포함
- 9. **대본 생성** — 전체 발표 대본 (선택)
- 10. **전달** — `index.html` 저장 (PPTX 모드면 `presentation.pptx`도)
- 테마 파일은 GitHub에서 온디맨드로 가져옵니다 — 로컬에 무거운 파일이 저장되지 않습니다.
- ---
- ## 🎨 테마
- 10개 테마 모두 **[make-slide.vercel.app](https://make-slide.vercel.app)** 에서 확인할 수 있습니다.
- | # | 테마 | 스타일 | 추천 용도 |
- |:-:|------|--------|-----------|
- | 1 | `minimal-dark` | 다크 배경, 화이트 타이포 | 테크 발표, 컨퍼런스 |
- | 2 | `minimal-light` | 화이트 배경, 클린 타이포 | 일반 발표, 세미나 |
- | 3 | `corporate` | 네이비 & 골드, 구조적 | 비즈니스, 보고 |
- | 4 | `gradient-pop` | 비비드 그라디언트, 글라스모피즘 | 스타트업, 피칭 |
- | 5 | `neon-terminal` | 터미널 그린, 스캔라인 | 개발자 발표, 해커톤 |
- | 6 | `paper` | 크래프트지, 세리프 타이포 | 교육, 워크숍 |
- | 7 | `keynote-apple` | 드라마틱 다크, Apple 스타일 | 제품 발표, 키노트 |
- | 8 | `magazine` | 에디토리얼, 비대칭 레이아웃 | 디자인, 크리에이티브 |
- | 9 | `data-focus` | 대시보드 스타일, 깔끔 | 데이터 분석, KPI |
- | 10 | `playful` | 둥근 모서리, 파스텔, 바운스 | 워크숍, 캐주얼 발표 |
- ---
- ## 🤝 기여하기
- ### 새 테마 추가하기
- 1. `themes/` 안에 테마 ID로 폴더 생성 (케밥 케이스)
- 2. `reference.html` + `README.md` 추가
- 3. `core/`의 컨벤션을 따르기
- 4. PR 제출 — 갤러리에 자동 추가!
- ---
- ## 📜 라이선스
- [MIT](LICENSE) — 개인 및 상업 프로젝트에 자유롭게 사용하세요.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.