SuperAPI AI Directory

doc-pptx

General & other

View repository

Updated 10-15 22:09

About this skill

PPT Designer (PPTX Designer)

Overview

Design and generate presentation slides. 10 curated palettes in the Claude brand tone(to avoid AI slop) and 9 business slide archetypes, Automated QA review pipeline, HTML-First optionare provided. Four generation methods are supported: (1) pptxgenjs directly, (2) HTML-First then export, (3) NotebookLM, (4) Markdown manuscript.

Trigger keywords

PPT, PowerPoint, presentation materials, slides, presentation, report, draft document, pitch deck, demo deck, conference materials

Design system — Claude Modern Deck Theme

For detailed tokens, see references/curated-palettes.md·references/typography-pairings.md .

10 curated palettes — at a glance

# Palette Primary color Secondary Background Purpose
1 Claude Classic Orange #d97757 Blue #6a9bcc Beige #faf9f5 General business·trust
2 Claude Coral Crail #c15f3c Pampas #f4f3ee White Active marketing·campaigns
3 Claude Mono Dark #141413 Mid Gray White Formal·academic·legal
4 Claude Blue Calm Blue #6a9bcc Mid Beige Data·finance·calm
5 Claude Green Earth Green #788c5d Olive Beige Sustainability·healthcare
6 Korean Brick Korean reddish-brown #a04a3a Beige Cream Korean traditional·B2B
7 Korean Navy Deep Navy #1d3557 Gold #c9a961 White Formal presentations·executive reports
8 Korean Sage Teal #5a8a85 Beige Cream Health·wellness·education
9 Dark Editorial Orange Mid Dark #1a1a1a Dark mode·tech·high-end
10 High Contrast Bold Black Orange Pop White Impact keynotes·events

9 business slide archetypes

# Archetype When to use Structure
1 Title (cover) First slide Large title + subtitle + presenter·date·logo
2 Agenda (table of contents) Second Section list + page numbers or progress indicator
3 Problem (problem definition) Start of body Current situation·pain points·impact
4 Solution After the problem Our approach·key differentiators
5 Features (features·differentiators) Solution details 3-6 grid + icons + short descriptions
6 Stats (highlighting statistics) Data page 3-4 large numbers + short labels
7 Team (team introduction) Later section Photos·roles·key experience
8 CTA (call to action) Before the closing Highlight box + 1 action + contact info
9 Closing (wrap-up·Q&A) Last Thank you · Contact · QR (optional)

For detailed wireframes, see references/slide-archetypes.md reference.

Typography Pairings (5 combinations)

Pairing Korean English Suitability
Modern Pretendard Inter General business (recommended)
Editorial Pretendard Lora (Serif Italic for quotes) Magazine·presentation·quote emphasis
Bold Heading Pretendard ExtraBold Poppins ExtraBold Impact·events
Classic Malgun Gothic Georgia Formal·papers·legal
Tech Pretendard JetBrains Mono (mono) Developers·tech conferences

Workflow

Step 1: Choose generation method

Method Recommended timing
pptxgenjs directly (recommended) .pptx file directly, fastest
HTML-First Export after visual review, when designer·design review is needed
NotebookLM Generate slides in the NotebookLM environment
Markdown manuscript only Write text only (user designs directly)

Step 2: Choose palette·pairing

Ask the user to confirm the following (AskUserQuestion):

  • Tone (Anthropic Orange default, Korean Navy formal, Coral assertive, Mono formal, etc.)
  • Number of slides (5-7 for 3 minutes, 10-15 for 10 minutes, 20-30 for 30 minutes)
  • Audience (executives·customers·developers·general public)

Step 3: Compose archetype sequence

Sequence the archetypes according to audience·length.

10분 사내 발표 (10-15장):
Title → Agenda → Problem → Solution → Features (3-6 그리드) →
Stats → Closing

30분 외부 피치 (20-30장):
Title → Agenda → Problem (2-3p) → Solution (3p) → Features (4-5p) →
Stats (2p) → Team → CTA → Closing → Q&A

3분 짧은 데모 (5-7장):
Title → Problem → Solution + Demo → Stats → Closing

Step 4: Apply design system

Apply the selected palette's colors·fonts·spacing to the slide master:

import PptxGenJS from "pptxgenjs";

const pptx = new PptxGenJS();

// Claude Classic 팔레트
const colors = {
  primary: "D97757",   // Orange
  secondary: "6A9BCC", // Blue
  bg: "FAF9F5",        // Beige
  surface: "FFFFFF",
  ink: "141413",
  mid: "B0AEA5",
};

// 16:9 (1920×1080)
pptx.layout = "LAYOUT_WIDE";

// 슬라이드 마스터 정의
pptx.defineSlideMaster({
  title: "MASTER_SLIDE",
  background: { color: colors.bg },
  objects: [
    { rect: { x: 0, y: 0, w: "100%", h: 0.06, fill: { color: colors.primary } } },
    { text: {
      text: "© 2026",
      options: { x: 0.3, y: 7.1, w: 2, h: 0.3, fontSize: 9, color: colors.mid, fontFace: "Pretendard" }
    }},
    { text: {
      text: "{slide_num}",
      options: { x: 12.5, y: 7.1, w: 0.5, h: 0.3, fontSize: 9, color: colors.mid, align: "right" }
    }},
  ],
});

// Title 슬라이드
const titleSlide = pptx.addSlide({ masterName: "MASTER_SLIDE" });
titleSlide.addText("2026 Q1 사업 보고", {
  x: 0.8, y: 2.5, w: 11.4, h: 1.5,
  fontSize: 56, bold: true, color: colors.ink, fontFace: "Pretendard"
});

See the full code pattern in references/pptxgen-code-patterns.md (existing material, 612 lines) + references/slide-archetypes.md.

Step 5: Automated QA review

references/qa-checklist.mdautomated review + visual review:

Automated review (code):

  1. 0 empty placeholders
  2. Text overflow detection (exceeding slide area)
  3. Color contrast of 4.5:1 or higher
  4. Font whitelist verification
  5. Consistent slide master application

Visual review (slide → image conversion):

  1. Visual check after converting to PDF/JPEG with LibreOffice
  2. Check for overlapping elements·clipped text·overlap
  3. Color consistency (within one palette only)
  4. AI slop copy detection (moai-designer:design-slop-check chaining)
  5. Audience·tone suitability (human review)

Step 6: Output

Format When to use
.pptx Main deliverable (PowerPoint·Keynote compatible)
.pdf backup Prevent font breakage·external sending
.jpg/.png preview Visual check·SNS sharing
Per-slide guide .md Speaker notes·editing guide

Step 7: Copy-only gate (mandatory review of headline·body copy)

From the slide, separate only the copy (headline·subheadline·CTA·body sentences) goes through gate inspection. Until now, this skill has no copy-only stage, so headlines have not passed the gate — this stage fills that gap. Separate from visual QA (Step 5), all slide copy textmust mandatorily pass the two gates below.

Mandatory chain:

  1. moai-coworker:ai-slop-reviewer — 1st general AI slop inspection (banned words, structural patterns, rhythm)
  2. moai-writer:korean-humanize — 2nd precise Korean editing (40+ pattern SSOT, meaning unchanged)

3 types of structural slop S1 patterns that this gate must catch (most frequent in slide headlines):

# Pattern Detection signal [Bad example] Fix
1 Dash-contrast headline Dash (—) sentence split "X — Y" (dash-contrast headline) [Bad example] "From copy-paste to delegation — just give the goal" Remove dash, merge into one sentence, or split into two sentences
2 Particle/noun-ending fragment Particle/noun-ending fragment (ends with particle/noun) [Bad example] "The key to success — automation" (particle/noun ending) Rewrite as a complete sentence including a predicate
3 "From A to B" transition formula Introduces the "from X to Y" transition formula [Bad example] "From Excel to Notion, what changed" (transition formula) Start with a concrete example instead of a transition formula

If the copy contains any of the above 3 types, the gate FAILs → rewrite the copy and re-inspect. ai-slop-reviewer와 korean-humanize Both have registered these 3 types in the checklist, so either will catch them. This copy-only gate must be passed before visual inspection (Step 5).

Usage examples

  • "Q3 business performance report as a 10-slide PPT, Claude Classic tone" → Title/Agenda/Problem/Solution/Stats/Closing sequence
  • "Startup seed pitch deck, 15 slides, impact tone" → High Contrast Bold palette + utilize all archetypes
  • "New employee onboarding training materials" → Korean Sage palette + calm tone
  • "Tech conference keynote" → Dark Editorial palette + Tech pairing
  • "For internal executive reporting" → Korean Navy palette + formal
  • "B2B product demo" → Claude Classic + Feature Grid emphasis

Output format

pptxgenjs direct method

  • File format: .pptx (PowerPoint 2007+ compatible)
  • Slide size: 16:9 (1920×1080) or 4:3 (1024×768)
  • Font: Pretendard (Korean body) + Inter (English)
  • Color encoding: sRGB

HTML-First method

  • Intermediate output: slides.html (for visual review)
  • Final: .pptx or .pdf export
  • Editable and re-exportable after review

NotebookLM method

  • slides.md (Markdown manuscript) + style-prompt.txt (for NotebookLM input)

Markdown manuscript method

  • .md (each slide = ## heading)
  • Manual design possible in Figma, Canva, PowerPoint, etc.

Precautions

Claude tone usage rules

  • Only 1 palette per deck — do not change colors per slide
  • Primary color only for headings and key emphasis (do not saturate the body)
  • Maximum 3 colors per slide (Primary + Secondary + Neutral)
  • For presentations to Korean audiences, Korean fonts (Pretendard, Malgun Gothic) are required

Slide count guide

Presentation time Number of slides Recommended archetype sequence
3분 5-7장 Title · Problem · Solution · Stats · Closing
10분 10-15장 + Agenda · Features · CTA
30분 20-30장 + multiple body sections · Team · detailed data
60분 40-50장 + detailed cases, demonstrations, Q&A preparation

One message per slide

Each slide = 1 key message. Recommend 50 words or fewer of text per slide. Put details in the speaker notes.

Minimum text size

  • Body: 18pt or larger (readability at 32-40 ft distance)
  • Caption: 14pt or larger
  • Title: 32pt or larger (56pt+ for emphasis slides)

Charts and visualizations first

Visualize data with charts — 1000x faster cognition than lists of tables and text. Actively use the Stats archetype.

Image copyright

Use only free image sites (Unsplash, Pixabay) or self-made/licensed images. For AI-generated images, check the terms of use.

Embed Korean fonts

Pretendard and Malgun Gothic are free for commercial use and distribution. If the font is not installed on the presentation PC, converting to PDF is recommended.

Problem solving

Situation Solution
File creation failed npm install pptxgenjs Install
Font corruption Convert to PDF or install Pretendard on the presentation PC
Color contrast failure Body text in Ink Dark, emphasis only in Primary
Slide overflow 50 words or fewer of text, specify line breaks
Master not applied masterName: "MASTER_SLIDE" Specify
HTML-First preview not working Refresh browser, clear cache
NotebookLM integration Markdown + style prompt provided separately (manual input)

Related skills / self-review

When slide generation is complete, reopen the generated .pptx file and check for remaining placeholders, insufficient slide count, Korean font issues, encoding corruption, and chart/image corruption, then self-review, and if there are problems, automatically fix and regenerate, then report the final PASS/FAIL result (for review items, see references/qa-checklist.md ).

Skill When to use
moai-officer:doc-docx DOCX document generation (shares the same Claude tone system)
moai-officer:doc-hwp Hangul/Hancom word processor documents
moai-officer:doc-xlsx Excel data sheets (chart data source)
moai-officer:doc-pdf Multilingual PDF conversion
moai-marketer:content-copywriting Slide copy writing
moai-writer:korean-humanize Korean copy naturalization
moai-designer:design-slop-check Slide copy AI slop review
moai-designer:design-prompt-builder When requesting simultaneous drafts from Claude Design
moai-media:media-gemini-3-image-prompt Slide illustration/background image prompts

Technical references

Detailed reference

File Loading conditions
references/curated-palettes.md When selecting a two-tier palette (10 curated palettes in detail — Claude tone variations + 4 Korean tones)
references/slide-archetypes.md When composing a 3-step archetype sequence (9 archetype wireframes)
references/typography-pairings.md When deciding font pairing and size hierarchy (5 pairings)
references/qa-checklist.md During Step 5 QA review (10 steps of automated and visual review)
references/pptxgen-code-patterns.md When writing Step 4 pptxgenjs code (code patterns, existing materials)
references/guide.md When a design system builder guide is needed (existing materials, 12 layouts)
references/report-generator.md When generating a report-type deck (existing materials)
references/templates/minimal-business.md When applying the minimal business style pack (color, font, layout presets)