Slide Deck Generator

Transform content into professional slide deck images. The deck is designed for reading and sharing (self-explanatory slides, logical scroll flow, social-media-friendly) rather than live presentation — that assumption drives every layout and density decision below.

User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

1. Prefer built-in user-input tools exposed by the current agent runtime — e.g.,

   AskUserQuestion

   ,

   request_user_input

   ,

   clarify

   ,

   ask_user

   , or any equivalent.
2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

Concrete

AskUserQuestion

Image Generation Tools

When this skill needs to render an image:

• Use whatever image-generation tool or skill is available in the current runtime — e.g., Codex

  imagegen

  , Hermes

  image_generate

  ,

  baoyu-imagine

  , or any equivalent the user has installed.
• If multiple are available, ask the user once at the start which to use (batch with any other initial questions).
• If none are available, tell the user and ask how to proceed.

Prompt file requirement (hard): write each image's full, final prompt to a standalone file under

prompts/

NN-slide-[slug].md

Language

Respond in the user's language across questions, progress reports, error messages, and the completion summary. Keep technical tokens (style names, file paths, code) in English.

Script Directory

{baseDir}

${BUN_X}

bun

npx -y bun

brew install oven-sh/bun/bun

scripts/merge-to-pptx.ts

scripts/merge-to-pdf.ts

Options

--style <name>

custom

--audience <type>

--lang <code>

--slides <N>

--ref <files...>

--outline-only

--prompts-only

--images-only

prompts/

--regenerate <N>

3

2,5,8

Style System

17 presets covering technical / educational / lifestyle / editorial use cases. Every preset is a combination of four dimensions (texture / mood / typography / density). If the user picks "Custom dimensions" in Round 1, Round 2 of the confirmation asks one question per dimension — options and verbatim copy live in

references/confirmation.md

Presets (17)

blueprint

chalkboard

corporate

minimal

sketch-notes

hand-drawn-edu

watercolor

dark-atmospheric

notion

bold-editorial

editorial-infographic

fantasy-animation

intuition-machine

pixel-art

scientific

vector-illustration

vintage

Per-preset specs:

references/styles/<preset>.md

references/dimensions/presets.md

Dimensions (when "Custom dimensions" picked)

Full per-dimension specs:

references/dimensions/*.md

Auto-Selection

Match content signals to a preset. Pick the first row whose signal keywords appear in the source; fall back to

blueprint

sketch-notes

hand-drawn-edu

chalkboard

blueprint

vector-illustration

intuition-machine

minimal

notion

corporate

bold-editorial

dark-atmospheric

editorial-infographic

fantasy-animation

pixel-art

scientific

vintage

watercolor

Slide Count Heuristic

Reference Images

Users may supply reference images to guide style, palette, layout, or subject.

Intake: Accept via

--ref <files...>

• File path → copy to

  {slide-deck-dir}/refs/NN-ref-{slug}.{ext}

• Pasted image with no path → ask for the path, or extract style traits verbally as a text fallback

Usage modes (per reference):

direct

style

palette

Record refs in each slide's prompt frontmatter:

references:
  - ref_id: 01
    filename: 01-ref-brand.png
    usage: direct

At generation time, verify files exist. If

usage: direct

baoyu-imagine --ref

style

palette

File Layout

slide-deck/{topic-slug}/
├── source-{slug}.{ext}
├── outline.md
├── prompts/NN-slide-{slug}.md
├── NN-slide-{slug}.png
├── {topic-slug}.pptx
└── {topic-slug}.pdf

Slug: 2-4 words, kebab-case, extracted from topic. "Introduction to Machine Learning" →

intro-machine-learning

Backup rule (applies across steps): if a file about to be written already exists, rename it to

<name>-backup-YYYYMMDD-HHMMSS.<ext>

Workflow

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

- [ ] Step 1: Setup & analyze
- [ ] Step 2: Confirmation ⚠️ REQUIRED (Round 1; Round 2 only if "Custom dimensions")
- [ ] 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

Step 1: Setup & Analyze

1.1 Load EXTEND.md — check these paths in order; first hit wins:

.baoyu-skills/baoyu-slide-deck/EXTEND.md

${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-slide-deck/EXTEND.md

$HOME/.baoyu-skills/baoyu-slide-deck/EXTEND.md

If found, read, parse, and print a summary (style / audience / language / review). If not, proceed with defaults — first-time setup is not blocking for this skill. Schema:

references/config/preferences-schema.md

1.2 Analyze content — follow

references/analysis-framework.md

source.md

1.3 Check existing output ⚠️ REQUIRED before Step 2. If

slide-deck/{topic-slug}/

references/confirmation.md

Save findings to

analysis.md

Step 2: Confirmation ⚠️ REQUIRED

Round 1 (always) — batch five questions in one

AskUserQuestion

references/confirmation.md

Summary displayed before the questions:

• Content type + topic
• Detected language
• Recommended style (based on signals)
• Recommended slide count (based on length)

Round 2 (only if "Custom dimensions" in Round 1) — batch four questions: texture, mood, typography, density. Verbatim options in

references/confirmation.md

After confirmation: update

analysis.md

skip_outline_review

skip_prompt_review

Step 3: Generate Outline

Resolve style: preset →

references/styles/{preset}.md

references/dimensions/

STYLE_INSTRUCTIONS

references/outline-template.md

outline.md

Stop here if

--outline-only

skip_outline_review

Step 4: Review Outline (Conditional)

Display a slide-by-slide table (

# | Title | Type | Layout

references/confirmation.md

On "Edit outline first", tell the user to edit

outline.md

Step 5: Generate Prompts

For each slide in outline:

1. Read

   references/base-prompt.md

2. Extract

   STYLE_INSTRUCTIONS

   from the outline (don't re-read the style file)
3. Add the slide's content
4. If a

   Layout:

   is specified, include guidance from

   references/layouts.md

5. Save to

   prompts/NN-slide-{slug}.md

   (backup rule applies)

Stop here if

--prompts-only

skip_prompt_review

Step 6: Review Prompts (Conditional)

Display the prompts index (

# | Filename | Slide Title

references/confirmation.md

Step 7: Generate Images

1. Resolve the image backend via the Image Generation Tools rule at the top — ask once if multiple are installed.
2. Confirm every

   prompts/NN-slide-{slug}.md

   exists (hard requirement; prompt files are the reproducibility record regardless of backend).
3. Session ID:

   slides-{topic-slug}-{timestamp}

   — pass to the backend only if it supports sessions.
4. For each slide: generate sequentially, reusing the session ID. Backup rule applies to PNG files. Report progress as

   Generated X/N

   . Auto-retry once on failure before reporting an error.

--regenerate N

--images-only

Step 8: Merge

${BUN_X} {baseDir}/scripts/merge-to-pptx.ts <slide-deck-dir>
${BUN_X} {baseDir}/scripts/merge-to-pdf.ts <slide-deck-dir>

Step 9: Summary

Slide Deck Complete!
Topic: [topic]
Style: [preset or "custom: texture+mood+typography+density"]
Location: [directory]
Slides: N

- 01-slide-cover.png
- ...
- NN-slide-back-cover.png

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

Slide Modification

prompts/NN-slide-{slug}.md

--regenerate N

NN

outline.md

outline.md

Always update the prompt file before regenerating the image — this keeps the prompts directory as the source of truth and makes changes reproducible. Only

NN

See

references/modification-guide.md

References

references/confirmation.md

references/analysis-framework.md

references/outline-template.md

references/base-prompt.md

references/layouts.md

references/design-guidelines.md

references/content-rules.md

references/modification-guide.md

references/styles/<preset>.md

references/dimensions/*.md

references/config/preferences-schema.md

Notes

• Image generation takes ~10-30s per slide; report progress between them.
• For sensitive public figures, prefer stylized alternatives to avoid likeness issues.
• Maintain visual consistency via the session ID when the backend supports it.

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