Slide Deck Generator

Transform content into professional slide deck images.

Usage

/baoyu-slide-deck path/to/content.md
/baoyu-slide-deck path/to/content.md --style sketch-notes
/baoyu-slide-deck path/to/content.md --audience executives
/baoyu-slide-deck path/to/content.md --lang zh
/baoyu-slide-deck path/to/content.md --slides 10
/baoyu-slide-deck path/to/content.md --outline-only
/baoyu-slide-deck  # Then paste content

Script Directory

Agent Execution Instructions:

1. Determine this SKILL.md file's directory path as

   SKILL_DIR

2. Script path =

   ${SKILL_DIR}/scripts/<script-name>.ts

scripts/merge-to-pptx.ts

scripts/merge-to-pdf.ts

Options

--style <name>

custom

--audience <type>

--lang <code>

--slides <number>

--outline-only

--prompts-only

--images-only

--regenerate <N>

--regenerate 3

--regenerate 2,5,8

Slide Count by Content Length:

Style System

Presets

blueprint

chalkboard

corporate

minimal

sketch-notes

watercolor

dark-atmospheric

notion

bold-editorial

editorial-infographic

fantasy-animation

intuition-machine

pixel-art

scientific

vector-illustration

vintage

Style Dimensions

Full specs:

references/dimensions/*.md

Auto Style Selection

sketch-notes

chalkboard

blueprint

vector-illustration

intuition-machine

minimal

notion

corporate

bold-editorial

dark-atmospheric

editorial-infographic

fantasy-animation

pixel-art

scientific

vintage

watercolor

blueprint

Design Philosophy

Decks designed for reading and sharing, not live presentation:

• Each slide self-explanatory without verbal commentary
• Logical flow when scrolling
• All necessary context within each slide
• Optimized for social media sharing

See

references/design-guidelines.md

• Audience-specific principles
• Visual hierarchy
• Content density guidelines
• Color and typography selection
• Font recommendations

See

references/layouts.md

File Management

Output Directory

slide-deck/{topic-slug}/
├── source-{slug}.{ext}
├── outline.md
├── prompts/
│   └── 01-slide-cover.md, 02-slide-{slug}.md, ...
├── 01-slide-cover.png, 02-slide-{slug}.png, ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

Slug: Extract topic (2-4 words, kebab-case). Example: "Introduction to Machine Learning" →

intro-machine-learning

Conflict Handling: See Step 1.3 for existing content detection and user options.

Language Handling

Detection Priority:

1. --lang

   flag (explicit)
2. EXTEND.md

   language

   setting
3. User's conversation language (input language)
4. Source content language

Rule: ALL responses use user's preferred language:

• Questions and confirmations
• Progress reports
• Error messages
• Completion summaries

Technical terms (style names, file paths, code) remain in English.

Workflow

Copy this checklist and check off items as you complete them:

Slide Deck Progress:
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Load preferences
  - [ ] 1.2 Analyze content
  - [ ] 1.3 Check existing ⚠️ REQUIRED
- [ ] Step 2: Confirmation ⚠️ REQUIRED (Round 1, optional Round 2)
- [ ] Step 3: Generate outline
- [ ] Step 4: Review outline (conditional)
- [ ] Step 5: Generate prompts
- [ ] Step 6: Review prompts (conditional)
- [ ] Step 7: Generate images
- [ ] Step 8: Merge to PPTX/PDF
- [ ] Step 9: Output summary

Flow

Input → Preferences → Analyze → [Check Existing?] → Confirm (1-2 rounds) → Outline → [Review Outline?] → Prompts → [Review Prompts?] → Images → Merge → Complete

Step 1: Setup & Analyze

1.1 Load Preferences (EXTEND.md)

Use Bash to check EXTEND.md existence (priority order):

# Check project-level first
test -f .baoyu-skills/baoyu-slide-deck/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.baoyu-skills/baoyu-slide-deck/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────┬───────────────────┐ │ Path │ Location │ ├──────────────────────────────────────────────────┼───────────────────┤ │ .baoyu-skills/baoyu-slide-deck/EXTEND.md │ Project directory │ ├──────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.baoyu-skills/baoyu-slide-deck/EXTEND.md │ User home │ └──────────────────────────────────────────────────┴───────────────────┘

When EXTEND.md Found → Read, parse, output summary to user:

📋 Loaded preferences from [full path]
├─ Style: [preset/custom name]
├─ Audience: [audience or "auto-detect"]
├─ Language: [language or "auto-detect"]
└─ Review: [enabled/disabled]

When EXTEND.md Not Found → First-time setup using AskUserQuestion or proceed with defaults.

EXTEND.md Supports: Preferred style | Custom dimensions | Default audience | Language preference | Review preference

Schema:

references/config/preferences-schema.md

1.2 Analyze Content

1. Save source content (if pasted, save as

   source.md

   )
   • Backup rule: If

     source.md

     exists, rename to

     source-backup-YYYYMMDD-HHMMSS.md

2. Follow

   references/analysis-framework.md

   for content analysis
3. Analyze content signals for style recommendations
4. Detect source language
5. Determine recommended slide count
6. Generate topic slug from content

1.3 Check Existing Content ⚠️ REQUIRED

MUST execute before proceeding to Step 2.

Use Bash to check if output directory exists:

test -d "slide-deck/{topic-slug}" && echo "exists"

If directory exists, use AskUserQuestion:

header: "Existing"
question: "Existing content found. How to proceed?"
options:
  - label: "Regenerate outline"
    description: "Keep images, regenerate outline only"
  - label: "Regenerate images"
    description: "Keep outline, regenerate images only"
  - label: "Backup and regenerate"
    description: "Backup to {slug}-backup-{timestamp}, then regenerate all"
  - label: "Exit"
    description: "Cancel, keep existing content unchanged"

Save to

analysis.md

• Topic, audience, content signals
• Recommended style (based on Auto Style Selection)
• Recommended slide count
• Language detection

Step 2: Confirmation ⚠️ REQUIRED

Two-round confirmation: Round 1 always, Round 2 only if "Custom dimensions" selected.

Language: Use user's input language or saved language preference.

Display summary:

• Content type + topic identified
• Language: [from EXTEND.md or detected]
• Recommended style: [preset] (based on content signals)
• Recommended slides: [N] (based on content length)

Round 1 (Always)

Use AskUserQuestion for all 5 questions:

Question 1: Style

header: "Style"
question: "Which visual style for this deck?"
options:
  - label: "{recommended_preset} (Recommended)"
    description: "Best match based on content analysis"
  - label: "{alternative_preset}"
    description: "[alternative style description]"
  - label: "Custom dimensions"
    description: "Choose texture, mood, typography, density separately"

Question 2: Audience

header: "Audience"
question: "Who is the primary reader?"
options:
  - label: "General readers (Recommended)"
    description: "Broad appeal, accessible content"
  - label: "Beginners/learners"
    description: "Educational focus, clear explanations"
  - label: "Experts/professionals"
    description: "Technical depth, domain knowledge"
  - label: "Executives"
    description: "High-level insights, minimal detail"

Question 3: Slide Count

header: "Slides"
question: "How many slides?"
options:
  - label: "{N} slides (Recommended)"
    description: "Based on content length"
  - label: "Fewer ({N-3} slides)"
    description: "More condensed, less detail"
  - label: "More ({N+3} slides)"
    description: "More detailed breakdown"

Question 4: Review Outline

header: "Outline"
question: "Review outline before generating prompts?"
options:
  - label: "Yes, review outline (Recommended)"
    description: "Review slide titles and structure"
  - label: "No, skip outline review"
    description: "Proceed directly to prompt generation"

Question 5: Review Prompts

header: "Prompts"
question: "Review prompts before generating images?"
options:
  - label: "Yes, review prompts (Recommended)"
    description: "Review image generation prompts"
  - label: "No, skip prompt review"
    description: "Proceed directly to image generation"

Round 2 (Only if "Custom dimensions" selected)

Use AskUserQuestion for all 4 dimensions:

Question 1: Texture

header: "Texture"
question: "Which visual texture?"
options:
  - label: "clean"
    description: "Pure solid color, no texture"
  - label: "grid"
    description: "Subtle grid overlay, technical"
  - label: "organic"
    description: "Soft textures, hand-drawn feel"
  - label: "pixel"
    description: "Chunky pixels, 8-bit aesthetic"

(Note: "paper" available via Other)

Question 2: Mood

header: "Mood"
question: "Which color mood?"
options:
  - label: "professional"
    description: "Cool-neutral, navy/gold"
  - label: "warm"
    description: "Earth tones, friendly"
  - label: "cool"
    description: "Blues, grays, analytical"
  - label: "vibrant"
    description: "High saturation, bold"

(Note: "dark", "neutral" available via Other)

Question 3: Typography

header: "Typography"
question: "Which typography style?"
options:
  - label: "geometric"
    description: "Modern sans-serif, clean"
  - label: "humanist"
    description: "Friendly, readable"
  - label: "handwritten"
    description: "Marker/brush, organic"
  - label: "editorial"
    description: "Magazine style, dramatic"

(Note: "technical" available via Other)

Question 4: Density

header: "Density"
question: "Information density?"
options:
  - label: "balanced (Recommended)"
    description: "2-3 key points per slide"
  - label: "minimal"
    description: "One focus point, maximum whitespace"
  - label: "dense"
    description: "Multiple data points, compact"

After Round 2: Store custom dimensions as the style configuration.

After Confirmation:

1. Update

   analysis.md

   with confirmed preferences
2. Store

   skip_outline_review

   flag from Question 4
3. Store

   skip_prompt_review

   flag from Question 5
4. → Step 3

Step 3: Generate Outline

Create outline using the confirmed style from Step 2.

Style Resolution:

• If preset selected → Read

  references/styles/{preset}.md

• If custom dimensions → Read dimension files from

  references/dimensions/

  and combine

Generate:

1. Follow

   references/outline-template.md

   for structure
2. Build STYLE_INSTRUCTIONS from style or dimensions
3. Apply confirmed audience, language, slide count
4. Save as

   outline.md

After generation:

• If

  --outline-only

  , stop here
• If

  skip_outline_review

  is true → Skip Step 4, go to Step 5
• If

  skip_outline_review

  is false → Continue to Step 4

Step 4: Review Outline (Conditional)

Skip this step if user selected "No, skip outline review" in Step 2.

Purpose: Review outline structure before prompt generation.

Language: Use user's input language or saved language preference.

Display:

• Total slides: N
• Style: [preset name or "custom: texture+mood+typography+density"]
• Slide-by-slide summary table:

| # | Title | Type | Layout |
|---|-------|------|--------|
| 1 | [title] | Cover | title-hero |
| 2 | [title] | Content | [layout] |
| 3 | [title] | Content | [layout] |
| ... | ... | ... | ... |

Use AskUserQuestion:

header: "Confirm"
question: "Ready to generate prompts?"
options:
  - label: "Yes, proceed (Recommended)"
    description: "Generate image prompts"
  - label: "Edit outline first"
    description: "I'll modify outline.md before continuing"
  - label: "Regenerate outline"
    description: "Create new outline with different approach"

After response:

1. If "Edit outline first" → Inform user to edit

   outline.md

   , ask again when ready
2. If "Regenerate outline" → Back to Step 3
3. If "Yes, proceed" → Continue to Step 5

Step 5: Generate Prompts

1. Read

   references/base-prompt.md

2. For each slide in outline:
   • Extract STYLE_INSTRUCTIONS from outline (not from style file again)
   • Add slide-specific content
   • If

     Layout:

     specified, include layout guidance from

     references/layouts.md

3. Save to

   prompts/

   directory
   • Backup rule: If prompt file exists, rename to

     prompts/NN-slide-{slug}-backup-YYYYMMDD-HHMMSS.md

After generation:

• If

  --prompts-only

  , stop here and output prompt summary
• If

  skip_prompt_review

  is true → Skip Step 6, go to Step 7
• If

  skip_prompt_review

  is false → Continue to Step 6

Step 6: Review Prompts (Conditional)

Skip this step if user selected "No, skip prompt review" in Step 2.

Purpose: Review prompts before image generation.

Language: Use user's input language or saved language preference.

Display:

• Total prompts: N
• Style: [preset name or custom dimensions]
• Prompt list:

| # | Filename | Slide Title |
|---|----------|-------------|
| 1 | 01-slide-cover.md | [title] |
| 2 | 02-slide-xxx.md | [title] |
| ... | ... | ... |

• Path to prompts directory:

  prompts/

Use AskUserQuestion:

header: "Confirm"
question: "Ready to generate slide images?"
options:
  - label: "Yes, proceed (Recommended)"
    description: "Generate all slide images"
  - label: "Edit prompts first"
    description: "I'll modify prompts before continuing"
  - label: "Regenerate prompts"
    description: "Create new prompts with different approach"

After response:

1. If "Edit prompts first" → Inform user to edit prompts, ask again when ready
2. If "Regenerate prompts" → Back to Step 5
3. If "Yes, proceed" → Continue to Step 7

Step 7: Generate Images

For

--images-only

For

--regenerate N

Standard flow:

1. Select available image generation skill
2. Generate session ID:

   slides-{topic-slug}-{timestamp}

3. For each slide:
   • Backup rule: If image file exists, rename to

     NN-slide-{slug}-backup-YYYYMMDD-HHMMSS.png

   • Generate image sequentially with same session ID
4. Report progress: "Generated X/N" (in user's language)
5. Auto-retry once on failure before reporting error

Step 8: Merge to PPTX and PDF

npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <slide-deck-dir>

Step 9: Output Summary

Language: Use user's input language or saved language preference.

Slide Deck Complete!

Topic: [topic]
Style: [preset name or custom dimensions]
Location: [directory path]
Slides: N total

- 01-slide-cover.png - Cover
- 02-slide-intro.png - Content
- ...
- {NN}-slide-back-cover.png - Back Cover

Outline: outline.md
PPTX: {topic-slug}.pptx
PDF: {topic-slug}.pdf

Partial Workflows

--outline-only

--prompts-only

--images-only

--regenerate N

Using

--prompts-only

Generate outline and prompts without images:

/baoyu-slide-deck content.md --prompts-only

Output:

outline.md

prompts/*.md

Using

--images-only

Generate images from existing prompts (starts at Step 7):

/baoyu-slide-deck slide-deck/topic-slug/ --images-only

Prerequisites:

• prompts/

  directory with slide prompt files

• outline.md

  with style information

Using

--regenerate

Regenerate specific slides:

# Single slide
/baoyu-slide-deck slide-deck/topic-slug/ --regenerate 3

# Multiple slides
/baoyu-slide-deck slide-deck/topic-slug/ --regenerate 2,5,8

Flow:

1. Read existing prompts for specified slides
2. Regenerate images only for those slides
3. Regenerate PPTX/PDF

Slide Modification

Quick Reference

--regenerate N

Edit Single Slide

1. Update prompt file FIRST in

   prompts/NN-slide-{slug}.md

2. Run:

   /baoyu-slide-deck <dir> --regenerate N

3. Or manually regenerate image + PDF

IMPORTANT: When updating slides, ALWAYS update the prompt file (

prompts/NN-slide-{slug}.md

Add New Slide

1. Create prompt at position:

   prompts/NN-slide-{new-slug}.md

2. Generate image using same session ID
3. Renumber: Subsequent files NN+1 (slugs unchanged)
4. Update

   outline.md

5. Regenerate PPTX/PDF

Delete Slide

1. Remove

   NN-slide-{slug}.png

   and

   prompts/NN-slide-{slug}.md

2. Renumber: Subsequent files NN-1 (slugs unchanged)
3. Update

   outline.md

4. Regenerate PPTX/PDF

File Naming

Format:

NN-slide-[slug].png

• NN

  : Two-digit sequence (01, 02, ...)

• slug

  : Kebab-case from content (2-5 words, unique)

Renumbering Rule: Only NN changes, slugs remain unchanged.

See

references/modification-guide.md

References

references/analysis-framework.md

references/outline-template.md

references/modification-guide.md

references/content-rules.md

references/design-guidelines.md

references/layouts.md

references/base-prompt.md

references/dimensions/*.md

references/dimensions/presets.md

references/styles/<style>.md

references/config/preferences-schema.md

Notes

• Image generation: 10-30 seconds per slide
• Auto-retry once on generation failure
• Use stylized alternatives for sensitive public figures
• Maintain style consistency via session ID
• Step 2 confirmation required - do not skip (style, audience, slides, outline review, prompt review)
• Step 4 conditional - only if user requested outline review in Step 2
• Step 6 conditional - only if user requested prompt review in Step 2

Extension Support

Custom configurations via EXTEND.md. See Step 1.1 for paths and supported options.