baoyu-slide-deck

```bash

/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

```

Agent Execution Instructions:

1. Determine this SKILL.md file's directory path as SKILL_DIR
2. Script path = ${SKILL_DIR}/scripts/.ts

| Script | Purpose |

|--------|---------|

| scripts/merge-to-pptx.ts | Merge slides into PowerPoint |

| scripts/merge-to-pdf.ts | Merge slides into PDF |

| Option | Description |

|--------|-------------|

| --style | Visual style: preset name, custom, or custom style name |

| --audience | Target: beginners, intermediate, experts, executives, general |

| --lang | Output language (en, zh, ja, etc.) |

| --slides | Target slide count (8-25 recommended, max 30) |

| --outline-only | Generate outline only, skip image generation |

| --prompts-only | Generate outline + prompts, skip images |

| --images-only | Generate images from existing prompts directory |

| --regenerate | Regenerate specific slide(s): --regenerate 3 or --regenerate 2,5,8 |

Slide Count by Content Length:

| Content | Slides |

|---------|--------|

| < 1000 words | 5-10 |

| 1000-3000 words | 10-18 |

| 3000-5000 words | 15-25 |

| > 5000 words | 20-30 (consider splitting) |

Presets

| Preset | Dimensions | Best For |

|--------|------------|----------|

| blueprint (Default) | grid + cool + technical + balanced | Architecture, system design |

| chalkboard | organic + warm + handwritten + balanced | Education, tutorials |

| corporate | clean + professional + geometric + balanced | Investor decks, proposals |

| minimal | clean + neutral + geometric + minimal | Executive briefings |

| sketch-notes | organic + warm + handwritten + balanced | Educational, tutorials |

| watercolor | organic + warm + humanist + minimal | Lifestyle, wellness |

| dark-atmospheric | clean + dark + editorial + balanced | Entertainment, gaming |

| notion | clean + neutral + geometric + dense | Product demos, SaaS |

| bold-editorial | clean + vibrant + editorial + balanced | Product launches, keynotes |

| editorial-infographic | clean + cool + editorial + dense | Tech explainers, research |

| fantasy-animation | organic + vibrant + handwritten + minimal | Educational storytelling |

| intuition-machine | clean + cool + technical + dense | Technical docs, academic |

| pixel-art | pixel + vibrant + technical + balanced | Gaming, developer talks |

| scientific | clean + cool + technical + dense | Biology, chemistry, medical |

| vector-illustration | clean + vibrant + humanist + balanced | Creative, children's content |

| vintage | paper + warm + editorial + balanced | Historical, heritage |

Style Dimensions

| Dimension | Options | Description |

|-----------|---------|-------------|

| Texture | clean, grid, organic, pixel, paper | Visual texture and background treatment |

| Mood | professional, warm, cool, vibrant, dark, neutral | Color temperature and palette style |

| Typography | geometric, humanist, handwritten, editorial, technical | Headline and body text styling |

| Density | minimal, balanced, dense | Information density per slide |

Full specs: references/dimensions/*.md

Auto Style Selection

| Content Signals | Preset |

|-----------------|--------|

| tutorial, learn, education, guide, beginner | sketch-notes |

| classroom, teaching, school, chalkboard | chalkboard |

| architecture, system, data, analysis, technical | blueprint |

| creative, children, kids, cute | vector-illustration |

| briefing, academic, research, bilingual | intuition-machine |

| executive, minimal, clean, simple | minimal |

| saas, product, dashboard, metrics | notion |

| investor, quarterly, business, corporate | corporate |

| launch, marketing, keynote, magazine | bold-editorial |

| entertainment, music, gaming, atmospheric | dark-atmospheric |

| explainer, journalism, science communication | editorial-infographic |

| story, fantasy, animation, magical | fantasy-animation |

| gaming, retro, pixel, developer | pixel-art |

| biology, chemistry, medical, scientific | scientific |

| history, heritage, vintage, expedition | vintage |

| lifestyle, wellness, travel, artistic | watercolor |

| Default | blueprint |

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 for:

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

See references/layouts.md for layout options.

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.

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.

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):

```bash

# 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)
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:

```bash

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 with:

• 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

1. Save to prompts/ directory

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: Start here with existing prompts.

For --regenerate N: Only regenerate specified slide(s).

Standard flow:

1. Select available image generation skill
2. Generate session ID: slides-{topic-slug}-{timestamp}
3. Generate each slide 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

```bash

npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts

npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts

```

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

```

| Option | Workflow |

|--------|----------|

| --outline-only | Steps 1-3 only (stop after outline) |

| --prompts-only | Steps 1-5 (generate prompts, skip images) |

| --images-only | Skip to Step 7 (requires existing prompts/) |

| --regenerate N | Regenerate specific slide(s) only |

Using `--prompts-only`

Generate outline and prompts without images:

```bash

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

```

Output: outline.md + prompts/*.md ready for review/editing.

Using `--images-only`

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

```bash

/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:

```bash

# 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

Quick Reference

| Action | Command | Manual Steps |

|--------|---------|--------------|

| Edit | --regenerate N | Update prompt → Regenerate image → Regenerate PDF |

| Add | Manual | Create prompt → Generate image → Renumber subsequent → Update outline → Regenerate PDF |

| Delete | Manual | Remove files → Renumber subsequent → Update outline → Regenerate PDF |

Edit Single Slide

1. Update prompt in prompts/NN-slide-{slug}.md
2. Run: /baoyu-slide-deck --regenerate N
3. Or manually regenerate image + PDF

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 for complete details.

| File | Content |

|------|---------|

| references/analysis-framework.md | Content analysis for presentations |

| references/outline-template.md | Outline structure and format |

| references/modification-guide.md | Edit, add, delete slide workflows |

| references/content-rules.md | Content and style guidelines |

| references/design-guidelines.md | Audience, typography, colors, visual elements |

| references/layouts.md | Layout options and selection tips |

| references/base-prompt.md | Base prompt for image generation |

| references/dimensions/*.md | Dimension specifications (texture, mood, typography, density) |

| references/dimensions/presets.md | Preset → dimension mapping |

| references/styles/