Skip to content
Back to search

make-slide

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kuneosu--make-slide/badge.svg)](/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

i

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)

  1. # make-slide — AI Presentation Skill
  2. ## Overview
  3. **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.
  4. Any AI coding tool (Claude Code, Gemini CLI, Codex, Cursor, etc.) can read this file and follow the instructions to generate professional presentations.
  5. **Repository**: [github.com/kuneosu/make-slide](https://github.com/kuneosu/make-slide)
  6. **Theme Gallery**: [make-slide.vercel.app](https://make-slide.vercel.app)
  7. ---
  8. ## When to Use
  9. Activate this skill when the user's request matches any of these patterns:
  10. - "Make a presentation about..."
  11. - "Create slides for..."
  12. - "Build a slide deck..."
  13. - "Turn this into a presentation"
  14. - "Make a talk about..."
  15. - "Create a pitch deck for..."
  16. - "Generate presentation slides..."
  17. - Any request involving: **presentation**, **slides**, **deck**, **talk**, **keynote**, **pitch**, **slideshow**
  18. ---
  19. ## Input Modes
  20. Determine which mode applies based on the user's input:
  21. ### Mode A: Topic Only
  22. The user provides a topic and optionally a duration or audience.
  23. ```
  24. "Make a 15-min talk about AI trends"
  25. "Create a presentation on microservices architecture"
  26. ```
  27. → You design the structure, content, and speaker notes from scratch.
  28. ### Mode B: Content/Material Provided
  29. The user provides source material (documents, notes, data, articles).
  30. ```
  31. "Turn this document into a presentation"
  32. "Create slides based on these meeting notes"
  33. ```
  34. → You organize and distill the material into slides + speaker notes.
  35. ### Mode C: Script Provided
  36. The user provides a written speech or speaking script.
  37. ```
  38. "Create slides for this speech script"
  39. "Make a visual deck that accompanies this talk"
  40. ```
  41. → You analyze the script's structure and create matching visual slides. The script becomes the speaker notes.
  42. ---
  43. ## Workflow
  44. Follow these steps in order:
  45. ### Step 1: Analyze Input
  46. - Determine the input mode (A, B, or C)
  47. - Estimate the appropriate number of slides:
  48. - 5-min talk → 8-12 slides
  49. - 10-min talk → 12-18 slides
  50. - 15-min talk → 18-25 slides
  51. - 20-min talk → 25-30 slides
  52. - 30-min talk → 30-40 slides
  53. - Identify the target audience and tone (technical, business, casual, academic)
  54. - Detect the user's language from the conversation (generate content in that language)
  55. ### Step 2: Choose a Theme
  56. Present the user with the theme gallery link for browsing:
  57. > **Browse themes here**: https://make-slide.vercel.app
  58. If the user doesn't choose a theme, recommend one based on context:
  59. - Tech/developer talk → `minimal-dark` or `neon-terminal`
  60. - Business/corporate → `corporate` or `minimal-light`
  61. - Startup pitch → `gradient-pop` or `keynote-apple`
  62. - Data/analytics → `data-focus`
  63. - Education/workshop → `paper` or `playful`
  64. - Design/creative → `magazine`
  65. - Product launch → `keynote-apple`
  66. - Casual/team event → `playful`
  67. ### Step 3: Check Image Needs
  68. Ask the user:
  69. > "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."
  70. - **Yes** → Mark image positions in the outline, ask user for image URLs
  71. - **No** → Use CSS placeholders (emoji, SVG icons, CSS shapes) that match the theme
  72. ### Step 4: Generate Outline
  73. Create a slide-by-slide outline with:
  74. - Slide number
  75. - Slide type (from Slide Types Reference below)
  76. - Title
  77. - Key points / content summary
  78. - Image placement (if applicable)
  79. Present the outline to the user for confirmation. Wait for approval or modifications before proceeding.
  80. ### Step 5: Fetch Theme Reference
  81. Fetch the chosen theme's reference files from GitHub:
  82. 1. **reference.html** — The complete example presentation with all slide types, styles, navigation, and interactive features. This is your primary template.
  83. 2. **README.md** — Design guidelines including color palette, typography, spacing rules, and design philosophy.
  84. Use the raw GitHub URLs listed in the Theme List section below.
  85. ### Step 6: Generate HTML
  86. Using the reference.html as your template:
  87. - Replicate the exact HTML structure, CSS styles, and JS functionality
  88. - Replace the demo content with the user's actual content
  89. - Keep all interactive features (navigation, fullscreen, speaker notes, etc.)
  90. - Match the theme's typography, colors, spacing, and animations
  91. - Ensure all slide types used match the patterns in the reference
  92. ### Step 7: Generate Speaker Notes
  93. Add speaker notes as `data-notes` attributes on each slide's `<div>`:
  94. ```html
  95. <div class="slide" data-notes="Welcome everyone. Today I'll be talking about...">
  96. ```
  97. - Notes should be conversational and natural
  98. - Include timing cues where helpful (e.g., "[PAUSE]", "[2 min]")
  99. - Don't just repeat the slide text — expand on it
  100. - Include transitions between slides (e.g., "Now let's move on to...")
  101. ### Step 8: Generate Script (Mode A and B only)
  102. For Mode A and B, also generate a separate `script.md` file containing:
  103. - Full speaking script organized by slide
  104. - Timing estimates per section
  105. - Audience interaction cues
  106. - Key points to emphasize
  107. For Mode C, the user already has a script — skip this step.
  108. ### Step 9: Save and Deliver
  109. - Save the presentation as `index.html` (or user-specified filename)
  110. - Save the script as `script.md` (if generated)
  111. - Offer to start a local server for preview:
  112. ```bash
  113. # Python
  114. python -m http.server 8000
  115. # Node.js
  116. npx serve .
  117. ```
  118. ---
  119. ## Theme List
  120. | # | Theme ID | Style | Best For | Reference HTML | README |
  121. |---|----------|-------|----------|---------------|--------|
  122. | 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) |
  123. | 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) |
  124. | 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) |
  125. | 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) |
  126. | 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) |
  127. | 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) |
  128. | 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) |
  129. | 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) |
  130. | 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) |
  131. | 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) |
  132. ---
  133. ## HTML Requirements
  134. Every generated presentation **MUST** include all of the following features. These are non-negotiable.
  135. ### File Structure
  136. - Single standalone `.html` file
  137. - All CSS inlined in `<style>` tags
  138. - All JS inlined in `<script>` tags
  139. - No external files except CDN links listed below
  140. ### Required CDN Dependencies
  141. ```html
  142. <!-- Pretendard Font (MANDATORY) -->
  143. <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard/dist/web/static/pretendard.min.css">
  144. <!-- JetBrains Mono for code blocks -->
  145. <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&display=swap">
  146. <!-- Prism.js for syntax highlighting (ONLY if code blocks exist) -->
  147. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css">
  148. <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
  149. <!-- Add language components as needed -->
  150. <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-javascript.min.js"></script>
  151. ```
  152. ### Keyboard Navigation
  153. - `←` / `→` Arrow keys: Previous / Next slide
  154. - `Space`: Next slide
  155. - `F`: Toggle fullscreen
  156. - `S`: Toggle speaker notes panel
  157. - `Escape`: Exit fullscreen
  158. ### Slide Counter
  159. - Display current slide number and total: `3 / 25`
  160. - Position: bottom-right or as defined by the theme
  161. ### Progress Bar
  162. - Visual progress indicator showing position in the deck
  163. - Updates on each slide transition
  164. ### Fullscreen
  165. - `F` key toggles fullscreen mode
  166. - Fullscreen button in the UI controls
  167. - Uses the Fullscreen API (`requestFullscreen`)
  168. ### Speaker Notes Panel
  169. - `S` key toggles the speaker notes panel
  170. - Panel displays:
  171. - Current slide's notes (from `data-notes` attribute)
  172. - Next slide preview (when possible)
  173. - Panel should not obstruct the main slide view
  174. ### PDF Export
  175. ```css
  176. @media print {
  177. /* Hide all UI controls */
  178. .controls, .progress-bar, .slide-counter,
  179. .fullscreen-btn, .speaker-notes-panel,
  180. nav, button { display: none !important; }
  181. /* Each slide = 1 page, landscape */
  182. .slide {
  183. page-break-after: always;
  184. width: 100vw;
  185. height: 100vh;
  186. }
  187. @page {
  188. size: landscape;
  189. margin: 0;
  190. }
  191. }
  192. ```
  193. ### Touch/Swipe Navigation
  194. - Swipe left → Next slide
  195. - Swipe right → Previous slide
  196. - Implement using touch event listeners (`touchstart`, `touchend`)
  197. ### Slide Transitions
  198. - Fade transition between slides (CSS transitions or animations)
  199. - Smooth and professional — no jarring jumps
  200. ### Staggered Element Animations
  201. - Elements within a slide animate in sequentially (stagger effect)
  202. - Use CSS animations with incremental `animation-delay`
  203. - Trigger animations when the slide becomes active
  204. ### Aspect Ratio
  205. - 16:9 aspect ratio for all slides
  206. - Centered on screen with letterboxing if needed
  207. ### Responsive Design
  208. - Scales to fit various screen sizes
  209. - Text remains readable at all resolutions
  210. - Controls adapt to screen size
  211. ### Content Overflow
  212. - Apply `overflow-y: auto` on slide content areas
  213. - Prevents content from being clipped if a slide has more content than fits
  214. - Scrollbar should be subtle and match the theme
  215. ---
  216. ## Image Handling
  217. ### Default: CSS Placeholders
  218. When no image URLs are provided, use styled placeholders that match the theme:
  219. ```html
  220. <!-- Emoji-based placeholder -->
  221. <div class="image-placeholder">
  222. <span class="placeholder-icon">🚀</span>
  223. <span class="placeholder-label">Product Screenshot</span>
  224. </div>
  225. <!-- CSS shape placeholder -->
  226. <div class="image-placeholder gradient-bg">
  227. <svg>...</svg>
  228. </div>
  229. ```
  230. ### When User Provides URLs
  231. ```html
  232. <img src="https://example.com/image.jpg" alt="Description" loading="lazy">
  233. ```
  234. - Always include descriptive `alt` text
  235. - Use `loading="lazy"` for images below the fold
  236. - Style images to fit within the slide layout without overflow
  237. ---
  238. ## Code Blocks
  239. ### Syntax Highlighting with Prism.js
  240. - **Only include Prism.js CDN when code blocks are present** in the presentation
  241. - If no code blocks exist, omit all Prism.js `<link>` and `<script>` tags
  242. ### Supported Languages
  243. Include Prism.js language components as needed:
  244. - `prism-javascript.min.js` — JavaScript
  245. - `prism-typescript.min.js` — TypeScript
  246. - `prism-python.min.js` — Python
  247. - `prism-markup.min.js` — HTML/XML (included in core)
  248. - `prism-css.min.js` — CSS (included in core)
  249. - `prism-bash.min.js` — Bash/Shell
  250. - `prism-json.min.js` — JSON
  251. - `prism-java.min.js` — Java
  252. - `prism-go.min.js` — Go
  253. - `prism-rust.min.js` — Rust
  254. ### Code Block Markup
  255. ```html
  256. <pre><code class="language-javascript">
  257. function hello() {
  258. console.log("Hello, World!");
  259. }
  260. </code></pre>
  261. ```
  262. - Use `JetBrains Mono` font for all code blocks
  263. - Ensure adequate contrast for readability
  264. - Match the code theme to the presentation theme (dark themes → dark code, light themes → light code)
  265. ---
  266. ## Output Rules
  267. 1. **Always output a single `.html` file** with all CSS and JS inlined
  268. 2. **Only allowed external dependencies**: Font CDNs (Pretendard, JetBrains Mono) + Prism.js CDN (conditional)
  269. 3. **Speaker notes** embedded as `data-notes` attributes on each slide `<div>`
  270. 4. **Optionally output `script.md`** for full speaking script (Mode A and B)
  271. 5. **Generate content in the user's language** — detect from the conversation context
  272. 6. **Filename**: `index.html` by default, or as specified by the user
  273. 7. **Do not use any JavaScript frameworks** — vanilla JS only
  274. 8. **Do not use any CSS frameworks** — vanilla CSS only
  275. ---
  276. ## Slide Types Reference
  277. Every theme supports these common slide types. Use the appropriate type based on content needs:
  278. ### 1. Title Slide
  279. The opening slide with presentation title, subtitle, presenter name, and date.
  280. ```
  281. [Large Title]
  282. [Subtitle or tagline]
  283. [Presenter Name — Date]
  284. ```
  285. ### 2. Agenda / Table of Contents
  286. Overview of the presentation structure with numbered sections.
  287. ```
  288. [Agenda heading]
  289. 01. First Section
  290. 02. Second Section
  291. 03. Third Section
  292. ...
  293. ```
  294. ### 3. Section Divider
  295. Marks the beginning of a new section. Usually has a big number or icon.
  296. ```
  297. [Big Number: 01]
  298. [Section Title]
  299. [Optional brief description]
  300. ```
  301. ### 4. Content Slide
  302. Standard slide with heading and bullet points or paragraphs.
  303. ```
  304. [Heading]
  305. • Point one
  306. • Point two
  307. • Point three
  308. [Optional supporting text]
  309. ```
  310. ### 5. Quote Slide
  311. Features a prominent quotation with attribution.
  312. ```
  313. "The best way to predict the future is to invent it."
  314. — Alan Kay
  315. ```
  316. ### 6. Comparison Slide
  317. Side-by-side columns comparing two concepts, approaches, or options.
  318. ```
  319. [Left Column: Option A] [Right Column: Option B]
  320. - Feature 1 - Feature 1
  321. - Feature 2 - Feature 2
  322. ```
  323. ### 7. Flow / Process Slide
  324. Step-by-step process visualization with arrows or connectors.
  325. ```
  326. [Step 1] → [Step 2] → [Step 3] → [Step 4]
  327. ```
  328. ### 8. Card Grid Slide
  329. 2-4 cards arranged in a grid, each with an icon, title, and description.
  330. ```
  331. [🎯 Card 1] [🚀 Card 2]
  332. [Title] [Title]
  333. [Desc] [Desc]
  334. [💡 Card 3] [⚡ Card 4]
  335. [Title] [Title]
  336. [Desc] [Desc]
  337. ```
  338. ### 9. Data / Chart Slide
  339. Statistics, metrics, bar charts, or KPI displays. Use CSS-only charts when possible.
  340. ```
  341. [Metric: 95%] [Metric: 2.5x] [Metric: 10K+]
  342. [CSS bar chart or visual representation]
  343. ```
  344. ### 10. Code Block Slide
  345. Syntax-highlighted code with optional title and description.
  346. ```
  347. [Title: Implementation Example]
  348. ┌──────────────────────────┐
  349. │ function example() { │
  350. │ return "hello"; │
  351. │ } │
  352. └──────────────────────────┘
  353. [Optional explanation below]
  354. ```
  355. ### 11. Image Slide
  356. Slide featuring an image (or placeholder) with optional caption.
  357. ```
  358. [Image or Placeholder]
  359. [Caption text]
  360. ```
  361. ### 12. Closing Slide
  362. Final slide with thank you message, contact info, or call to action.
  363. ```
  364. [Thank You]
  365. [Contact info / Social links / QR code]
  366. [Call to action]
  367. ```
  368. ---
  369. ## Tips for Best Results
  370. ### Content
  371. - Keep slides concise: **max 6-8 bullet points** per slide
  372. - One core idea per slide
  373. - Use short phrases, not full sentences, on slides
  374. - Save detailed explanations for speaker notes
  375. ### Design
  376. - Use the theme's accent color for emphasis and key terms
  377. - Match typography hierarchy exactly from the reference.html
  378. - Maintain consistent spacing and padding throughout
  379. - Don't override the theme's core design — work within its system
  380. ### Speaker Notes
  381. - Write notes in a conversational tone
  382. - Don't just repeat the slide text — expand, explain, give examples
  383. - Include timing hints: "[This section: ~3 minutes]"
  384. - Add transition phrases: "Now let's look at...", "Building on that..."
  385. - Mark audience interaction points: "[ASK AUDIENCE]", "[DEMO]", "[PAUSE]"
  386. ### Data Visualization
  387. - Use CSS-only charts when possible (bar charts, progress bars, donut charts)
  388. - Keep numbers round and memorable (say "nearly 50%" not "49.7%")
  389. - Highlight the most important metric with size or color
  390. ### Performance
  391. - Keep total HTML file size reasonable (under 200KB ideally)
  392. - Use `loading="lazy"` on images
  393. - Minimize complex CSS animations on slides with heavy content
  394. ### Accessibility
  395. - Maintain sufficient color contrast ratios
  396. - Include `alt` text on all images
  397. - Ensure keyboard navigation works for all interactive elements
  398. - Use semantic HTML where appropriate
  399. ---
  400. ## Quick Start Example
  401. If the user says: *"Make a 10-minute presentation about Python best practices"*
  402. 1. **Mode**: A (Topic only)
  403. 2. **Slides**: ~15 slides
  404. 3. **Theme recommendation**: `minimal-dark` or `neon-terminal` (developer topic)
  405. 4. **Ask**: Theme preference + image needs
  406. 5. **Generate outline** → Get confirmation
  407. 6. **Fetch**: `minimal-dark/reference.html` + `minimal-dark/README.md`
  408. 7. **Generate**: `index.html` + `script.md`
  409. 8. **Offer**: Local server preview
  410. ---
  411. *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)

  1. # make-slide 🎯
  2. **AI-powered presentation skill that generates stunning single-file HTML slide decks.**
  3. **AI 코딩 에이전트가 단일 HTML 파일로 고품질 프레젠테이션을 생성하는 범용 스킬.**
  4. [![Live Gallery](https://img.shields.io/badge/🎨_Theme_Gallery-Live_Demo-blue?style=for-the-badge)](https://make-slide.vercel.app)
  5. [![npm](https://img.shields.io/npm/v/make-slide?style=for-the-badge)](https://www.npmjs.com/package/make-slide)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
  7. ---
  8. ## What is make-slide?
  9. **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**.
  10. 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:
  11. - **Token-efficient** — AI fetches a reference file instead of inventing layouts
  12. - **Consistent quality** — every presentation follows a polished, tested design system
  13. - **Zero dependencies** — output is one `.html` file you can open anywhere
  14. > Think of it as a **design system for AI-generated presentations**.
  15. ---
  16. ## ✨ Features
  17. | Feature | Description |
  18. |---------|-------------|
  19. | 🎨 **10 Themes** | From dark minimal to playful pastels — [browse the gallery](https://make-slide.vercel.app) |
  20. | 📄 **Single HTML Output** | One file, no build step, no framework — just open in a browser |
  21. | 🎤 **Speaker Notes** | Built-in presenter mode with per-slide notes (press `S`) |
  22. | 🖨️ **PDF Export** | Print-ready via `Ctrl+P` with clean `@media print` styles |
  23. | 🖥️ **Fullscreen** | One-key fullscreen toggle (press `F`) |
  24. | ⌨️ **Keyboard Navigation** | Arrow keys, spacebar, touch/swipe support |
  25. | 📥 **3 Input Modes** | Topic only / Content provided / Script provided |
  26. | 📐 **4 Layout Styles** | Centered, Wide, Split, Editorial — [browse layouts](https://make-slide.vercel.app) |
  27. | 📊 **PPTX Export** | Generate PowerPoint files alongside HTML |
  28. | 🖼️ **Auto Image Search** | Automatically find and place relevant images from Unsplash |
  29. | 🤖 **Works with Any AI Tool** | Claude Code, Gemini CLI, Codex, Cursor, and more |
  30. | 🌍 **Language-Agnostic** | Generates content in whatever language you speak |
  31. | 📊 **CSS-Only Charts** | Bar charts, progress rings, KPI cards — no chart library needed |
  32. ---
  33. ## 🚀 Quick Start
  34. ### Install with npx (Recommended)
  35. ```bash
  36. npx make-slide init
  37. ```
  38. This will:
  39. 1. Copy the skill files into your project's `.claude/skills/make-slide/`
  40. 2. Auto-detect your AI config (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`) and inject the `/make-slide` command
  41. 3. You're ready! Type `/make-slide` in Claude Code to create presentations
  42. ### Other Commands
  43. ```bash
  44. npx make-slide themes # View all 10 themes
  45. npx make-slide gallery # Open theme gallery in browser
  46. npx make-slide help # Show help
  47. ```
  48. ### Manual Setup (Any AI Tool)
  49. Give your AI coding tool the following instruction:
  50. ```
  51. Read SKILL.md from https://github.com/kuneosu/make-slide and create a presentation about [your topic] using the minimal-dark theme.
  52. ```
  53. Or fetch it directly:
  54. ```
  55. 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].
  56. ```
  57. > **Tip:** Browse themes first at [make-slide.vercel.app](https://make-slide.vercel.app) and tell your AI which one you like!
  58. ---
  59. ## ⚙️ How It Works
  60. ### The `.claude/skills/` Convention
  61. make-slide uses Claude Code's native skill system. After running `npx make-slide init`, your project gets:
  62. ```
  63. your-project/
  64. ├── .claude/
  65. │ └── skills/
  66. │ └── make-slide/
  67. │ ├── SKILL.md ← Main instruction file
  68. │ └── references/
  69. │ ├── themes.md ← 10 themes + GitHub raw URLs
  70. │ ├── layouts.md ← 4 layout styles
  71. │ ├── slide-types.md ← 12 slide type patterns
  72. │ ├── html-spec.md ← HTML requirements
  73. │ ├── core-features.md ← Copy-paste JS/CSS for features
  74. │ └── pptx-spec.md ← PPTX conversion rules
  75. ├── CLAUDE.md ← Auto-updated with /make-slide command
  76. └── ... your project files
  77. ```
  78. When you type `/make-slide` in Claude Code, it reads the skill and follows a 10-step workflow:
  79. 1. **Analyze input** — mode (topic / content / script), slide count, output format (HTML / PPTX)
  80. 2. **Choose a theme** — pick from the [gallery](https://make-slide.vercel.app) or AI recommends
  81. 3. **Choose a layout** — Centered, Wide, Split, or Editorial
  82. 4. **Image options** — no images / provide URLs / auto-search from Unsplash
  83. 5. **Generate outline** — slide-by-slide plan for your approval
  84. 6. **Fetch theme + layout reference** — downloads templates from GitHub
  85. 7. **Generate HTML** — builds presentation matching theme + layout exactly
  86. 8. **Add speaker notes** — popup window with timing cues
  87. 9. **Generate script** — full speaking script (optional)
  88. 10. **Deliver** — saves `index.html` (and `presentation.pptx` if PPTX mode)
  89. Theme files are fetched from GitHub on demand — nothing heavy is stored locally.
  90. ---
  91. ## 🎨 Themes
  92. All 10 themes are live at **[make-slide.vercel.app](https://make-slide.vercel.app)**
  93. | # | Theme | Style | Best For |
  94. |:-:|-------|-------|----------|
  95. | 1 | `minimal-dark` | Clean dark, white typography | Tech talks, conferences |
  96. | 2 | `minimal-light` | Bright white, precise type | General, academic |
  97. | 3 | `corporate` | Navy & gold, structured | Business, reports |
  98. | 4 | `gradient-pop` | Vibrant gradients, glassmorphism | Startups, pitches |
  99. | 5 | `neon-terminal` | Terminal green, scanlines | Dev talks, hackathons |
  100. | 6 | `paper` | Kraft paper, serif type | Education, workshops |
  101. | 7 | `keynote-apple` | Dramatic dark, Apple-inspired | Product launches, keynotes |
  102. | 8 | `magazine` | Editorial, asymmetric layout | Design, creative |
  103. | 9 | `data-focus` | Dashboard aesthetic, clean | Data analysis, KPIs |
  104. | 10 | `playful` | Rounded, pastel, bouncy | Workshops, casual talks |
  105. ---
  106. ## 📁 Project Structure
  107. ```
  108. make-slide/
  109. ├── package.json # npm package config
  110. ├── bin/cli.js # CLI (init, themes, gallery)
  111. ├── .claude/skills/make-slide/ # Skill template (copied by init)
  112. │ ├── SKILL.md
  113. │ └── references/
  114. │ ├── themes.md
  115. │ ├── layouts.md
  116. │ ├── slide-types.md
  117. │ ├── html-spec.md
  118. │ ├── core-features.md
  119. │ └── pptx-spec.md
  120. ├── layouts/ # Layout references (4 styles)
  121. │ ├── centered/
  122. │ ├── wide/
  123. │ ├── split/
  124. │ └── editorial/
  125. ├── SKILL.md # Legacy standalone skill file
  126. ├── README.md # This file
  127. ├── LICENSE # MIT License
  128. │
  129. ├── themes/ # Theme references (10 themes)
  130. │ ├── minimal-dark/
  131. │ │ ├── README.md # Design guidelines
  132. │ │ └── reference.html # Full example presentation
  133. │ ├── minimal-light/
  134. │ ├── corporate/
  135. │ ├── gradient-pop/
  136. │ ├── neon-terminal/
  137. │ ├── paper/
  138. │ ├── keynote-apple/
  139. │ ├── magazine/
  140. │ ├── data-focus/
  141. │ └── playful/
  142. │
  143. ├── gallery/ # Theme gallery website (Vercel)
  144. │ └── index.html
  145. │
  146. ├── core/ # Shared JS/CSS source
  147. │ ├── navigation.js
  148. │ ├── fullscreen.js
  149. │ ├── speaker-notes.js
  150. │ ├── pdf-export.css
  151. │ └── base.css
  152. │
  153. └── examples/ # Example presentations
  154. └── pineone-talk-reference.html
  155. ```
  156. ---
  157. ## 🤝 Contributing
  158. ### Adding a New Theme
  159. 1. Create a folder in `themes/` with your theme ID (kebab-case):
  160. ```
  161. themes/your-theme-name/
  162. ```
  163. 2. Add these files:
  164. - `reference.html` — Complete 10-slide example with all slide types, navigation, fullscreen, speaker notes, and PDF export
  165. - `README.md` — Design guidelines: color palette, typography, spacing, philosophy
  166. 3. Follow the conventions in `core/` for navigation, fullscreen, speaker notes, and PDF export
  167. 4. Submit a PR — your theme will appear in the gallery!
  168. ### Guidelines
  169. - Output must be a single `.html` file — all CSS/JS inlined
  170. - Only external dependencies: font CDNs (Pretendard required) + Prism.js (for code blocks)
  171. - All themes must support the full slide type set
  172. - Test keyboard navigation, fullscreen, speaker notes, and print export
  173. ---
  174. ## 📜 License
  175. [MIT](LICENSE) — use freely for personal and commercial projects.
  176. ---
  177. ---
  178. <br>
  179. # make-slide 🎯 (한국어)
  180. **AI 코딩 에이전트가 단일 HTML 파일로 고품질 프레젠테이션을 생성하는 범용 스킬.**
  181. [![테마 갤러리](https://img.shields.io/badge/🎨_테마_갤러리-라이브_데모-blue?style=for-the-badge)](https://make-slide.vercel.app)
  182. [![npm](https://img.shields.io/npm/v/make-slide?style=for-the-badge)](https://www.npmjs.com/package/make-slide)
  183. [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
  184. ---
  185. ## make-slide란?
  186. **make-slide**는 Claude Code, Gemini CLI, Codex, Cursor 등 AI 코딩 에이전트를 위한 스킬(지침서)입니다. AI가 이 스킬을 읽고 따라하면 전문적인 프레젠테이션 슬라이드를 **단일 HTML 파일**로 생성합니다.
  187. 매번 처음부터 디자인을 만드는 대신(토큰 낭비 + 일관성 없는 결과), AI가 이 레포의 사전 제작된 테마 템플릿을 참조합니다:
  188. - **토큰 절약** — AI가 레이아웃을 발명하는 대신 레퍼런스 파일을 가져옴
  189. - **일관된 품질** — 모든 프레젠테이션이 검증된 디자인 시스템을 따름
  190. - **제로 의존성** — 결과물은 어디서나 열 수 있는 `.html` 파일 하나
  191. > **AI 생성 프레젠테이션을 위한 디자인 시스템**이라고 생각하세요.
  192. ---
  193. ## 🚀 빠른 시작
  194. ### npx로 설치 (권장)
  195. ```bash
  196. npx make-slide init
  197. ```
  198. 이 명령어는:
  199. 1. `.claude/skills/make-slide/`에 스킬 파일 복사
  200. 2. AI 설정 파일(`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`) 자동 감지 후 `/make-slide` 명령어 주입
  201. 3. 준비 완료! Claude Code에서 `/make-slide` 입력하면 프레젠테이션 생성
  202. ### 기타 명령어
  203. ```bash
  204. npx make-slide themes # 10개 테마 보기
  205. npx make-slide gallery # 테마 갤러리 열기
  206. npx make-slide help # 도움말
  207. ```
  208. ### 수동 설정 (다른 AI 도구)
  209. AI 코딩 도구에 다음과 같이 지시하세요:
  210. ```
  211. https://github.com/kuneosu/make-slide 의 SKILL.md를 읽고 [주제]에 대한 프레젠테이션을 minimal-dark 테마로 만들어줘.
  212. ```
  213. > **팁:** [make-slide.vercel.app](https://make-slide.vercel.app)에서 테마를 먼저 둘러보고 마음에 드는 것을 AI에게 알려주세요!
  214. ---
  215. ## ⚙️ 작동 방식
  216. ### `.claude/skills/` 컨벤션
  217. `npx make-slide init` 실행 후 프로젝트 구조:
  218. ```
  219. your-project/
  220. ├── .claude/
  221. │ └── skills/
  222. │ └── make-slide/
  223. │ ├── SKILL.md ← 메인 지침서
  224. │ └── references/
  225. │ ├── themes.md ← 10개 테마 + GitHub raw URL
  226. │ ├── layouts.md ← 4가지 레이아웃 스타일
  227. │ ├── slide-types.md ← 12가지 슬라이드 타입
  228. │ ├── html-spec.md ← HTML 요구사항
  229. │ ├── core-features.md ← 기본 기능 JS/CSS 코드
  230. │ └── pptx-spec.md ← PPTX 변환 규칙
  231. ├── CLAUDE.md ← /make-slide 명령어 자동 추가
  232. └── ... 프로젝트 파일들
  233. ```
  234. Claude Code에서 `/make-slide` 입력하면 9단계 워크플로우를 따릅니다:
  235. 1. **입력 분석** — 모드(주제/내용/대본), 슬라이드 수, 출력 형식(HTML/PPTX) 결정
  236. 2. **테마 선택** — [갤러리](https://make-slide.vercel.app)에서 선택하거나 AI가 추천
  237. 3. **레이아웃 선택** — Centered, Wide, Split, Editorial 중 선택
  238. 4. **이미지 옵션** — 없음 / URL 제공 / Unsplash 자동 검색
  239. 5. **아웃라인 생성** — 슬라이드별 구성 승인
  240. 6. **테마 + 레이아웃 레퍼런스** — GitHub에서 템플릿 다운로드
  241. 7. **HTML 생성** — 테마 + 레이아웃에 맞는 프레젠테이션 빌드
  242. 8. **발표자 노트** — 팝업 윈도우 방식, 타이밍 큐 포함
  243. 9. **대본 생성** — 전체 발표 대본 (선택)
  244. 10. **전달** — `index.html` 저장 (PPTX 모드면 `presentation.pptx`도)
  245. 테마 파일은 GitHub에서 온디맨드로 가져옵니다 — 로컬에 무거운 파일이 저장되지 않습니다.
  246. ---
  247. ## 🎨 테마
  248. 10개 테마 모두 **[make-slide.vercel.app](https://make-slide.vercel.app)** 에서 확인할 수 있습니다.
  249. | # | 테마 | 스타일 | 추천 용도 |
  250. |:-:|------|--------|-----------|
  251. | 1 | `minimal-dark` | 다크 배경, 화이트 타이포 | 테크 발표, 컨퍼런스 |
  252. | 2 | `minimal-light` | 화이트 배경, 클린 타이포 | 일반 발표, 세미나 |
  253. | 3 | `corporate` | 네이비 & 골드, 구조적 | 비즈니스, 보고 |
  254. | 4 | `gradient-pop` | 비비드 그라디언트, 글라스모피즘 | 스타트업, 피칭 |
  255. | 5 | `neon-terminal` | 터미널 그린, 스캔라인 | 개발자 발표, 해커톤 |
  256. | 6 | `paper` | 크래프트지, 세리프 타이포 | 교육, 워크숍 |
  257. | 7 | `keynote-apple` | 드라마틱 다크, Apple 스타일 | 제품 발표, 키노트 |
  258. | 8 | `magazine` | 에디토리얼, 비대칭 레이아웃 | 디자인, 크리에이티브 |
  259. | 9 | `data-focus` | 대시보드 스타일, 깔끔 | 데이터 분석, KPI |
  260. | 10 | `playful` | 둥근 모서리, 파스텔, 바운스 | 워크숍, 캐주얼 발표 |
  261. ---
  262. ## 🤝 기여하기
  263. ### 새 테마 추가하기
  264. 1. `themes/` 안에 테마 ID로 폴더 생성 (케밥 케이스)
  265. 2. `reference.html` + `README.md` 추가
  266. 3. `core/`의 컨벤션을 따르기
  267. 4. PR 제출 — 갤러리에 자동 추가!
  268. ---
  269. ## 📜 라이선스
  270. [MIT](LICENSE) — 개인 및 상업 프로젝트에 자유롭게 사용하세요.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.