Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ideacco avatar

Baoyu Slide Deck

  • 18 installs
  • 12 repo stars
  • Updated March 4, 2026
  • ideacco/baoyu-skills-openclaw

Turn markdown or pasted copy into styled slide-deck images plus optional PPT/PDF merges for pitches, demos, and marketing.

About

Baoyu slide deck is an agent skill that converts source material into professional presentation assets: an outline with style instructions, individual slide images, and merges into PowerPoint or PDF via bundled TypeScript scripts. Solo and indie builders use it when asked to create slides, make a presentation, generate a deck, or produce PPT-style output without opening a separate design tool chain manually. The workflow supports presets, custom styles, audience tuning, multilingual output, and outline-only passes so you can approve structure before image generation. Placement spans Validate when you need pitch and scope clarity, Launch when you prepare distribution narratives, and Grow when you repurpose content into webinar or social funnels. Allowed tools include read, write, and bash so agents can run merge scripts from the skill directory. Complexity is intermediate because you must point agents at SKILL_DIR scripts correctly and choose style parameters that match your brand. The skill is a generator package migrated from the baoyu/openclaw ecosystem, not a live slide SaaS integration.

  • CLI-style invocations from content files, URLs, or pasted markdown with style and audience flags
  • Outline-first flow with optional --outline-only before generating per-slide images
  • Preset and custom visual styles including sketch-notes and language overrides (--lang zh)
  • Scripts merge-to-pptx.ts and merge-to-pdf.ts to export assembled decks
  • Configurable slide count (--slides) and audience targeting (e.g. executives)

Baoyu Slide Deck by the numbers

  • 18 all-time installs (skills.sh)
  • Ranked #1,005 of 1,335 Generative Media skills by installs in the Skillselion catalog
  • Security screen: LOW risk (skills.sh audit)
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ideacco/baoyu-skills-openclaw --skill baoyu-slide-deck

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs18
repo stars12
Security audit3 / 3 scanners passed
Last updatedMarch 4, 2026
Repositoryideacco/baoyu-skills-openclaw

What it does

Turn markdown or pasted copy into styled slide-deck images plus optional PPT/PDF merges for pitches, demos, and marketing.

Files

SKILL.mdMarkdownGitHub ↗

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

ScriptPurpose
scripts/merge-to-pptx.tsMerge slides into PowerPoint
scripts/merge-to-pdf.tsMerge slides into PDF

Options

OptionDescription
--style <name>Visual style: preset name, custom, or custom style name
--audience <type>Target: beginners, intermediate, experts, executives, general
--lang <code>Output language (en, zh, ja, etc.)
--slides <number>Target slide count (8-25 recommended, max 30)
--outline-onlyGenerate outline only, skip image generation
--prompts-onlyGenerate outline + prompts, skip images
--images-onlyGenerate images from existing prompts directory
--regenerate <N>Regenerate specific slide(s): --regenerate 3 or --regenerate 2,5,8

Slide Count by Content Length:

ContentSlides
< 1000 words5-10
1000-3000 words10-18
3000-5000 words15-25
> 5000 words20-30 (consider splitting)

Style System

Presets

PresetDimensionsBest For
blueprint (Default)grid + cool + technical + balancedArchitecture, system design
chalkboardorganic + warm + handwritten + balancedEducation, tutorials
corporateclean + professional + geometric + balancedInvestor decks, proposals
minimalclean + neutral + geometric + minimalExecutive briefings
sketch-notesorganic + warm + handwritten + balancedEducational, tutorials
watercolororganic + warm + humanist + minimalLifestyle, wellness
dark-atmosphericclean + dark + editorial + balancedEntertainment, gaming
notionclean + neutral + geometric + denseProduct demos, SaaS
bold-editorialclean + vibrant + editorial + balancedProduct launches, keynotes
editorial-infographicclean + cool + editorial + denseTech explainers, research
fantasy-animationorganic + vibrant + handwritten + minimalEducational storytelling
intuition-machineclean + cool + technical + denseTechnical docs, academic
pixel-artpixel + vibrant + technical + balancedGaming, developer talks
scientificclean + cool + technical + denseBiology, chemistry, medical
vector-illustrationclean + vibrant + humanist + balancedCreative, children's content
vintagepaper + warm + editorial + balancedHistorical, heritage

Style Dimensions

DimensionOptionsDescription
Textureclean, grid, organic, pixel, paperVisual texture and background treatment
Moodprofessional, warm, cool, vibrant, dark, neutralColor temperature and palette style
Typographygeometric, humanist, handwritten, editorial, technicalHeadline and body text styling
Densityminimal, balanced, denseInformation density per slide

Full specs: references/dimensions/*.md

Auto Style Selection

Content SignalsPreset
tutorial, learn, education, guide, beginnersketch-notes
classroom, teaching, school, chalkboardchalkboard
architecture, system, data, analysis, technicalblueprint
creative, children, kids, cutevector-illustration
briefing, academic, research, bilingualintuition-machine
executive, minimal, clean, simpleminimal
saas, product, dashboard, metricsnotion
investor, quarterly, business, corporatecorporate
launch, marketing, keynote, magazinebold-editorial
entertainment, music, gaming, atmosphericdark-atmospheric
explainer, journalism, science communicationeditorial-infographic
story, fantasy, animation, magicalfantasy-animation
gaming, retro, pixel, developerpixel-art
biology, chemistry, medical, scientificscientific
history, heritage, vintage, expeditionvintage
lifestyle, wellness, travel, artisticwatercolor
Defaultblueprint

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

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

See references/layouts.md for layout options.

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` 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

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`: 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. 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

OptionWorkflow
--outline-onlySteps 1-3 only (stop after outline)
--prompts-onlySteps 1-5 (generate prompts, skip images)
--images-onlySkip to Step 7 (requires existing prompts/)
--regenerate NRegenerate specific slide(s) only

Using --prompts-only

Generate outline and prompts without images:

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

/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

ActionCommandManual Steps
Edit--regenerate NUpdate prompt file FIRST → Regenerate image → Regenerate PDF
AddManualCreate prompt → Generate image → Renumber subsequent → Update outline → Regenerate PDF
DeleteManualRemove files → Renumber subsequent → Update outline → Regenerate PDF

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) FIRST before regenerating. This ensures changes are documented and reproducible.

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.

References

FileContent
references/analysis-framework.mdContent analysis for presentations
references/outline-template.mdOutline structure and format
references/modification-guide.mdEdit, add, delete slide workflows
references/content-rules.mdContent and style guidelines
references/design-guidelines.mdAudience, typography, colors, visual elements
references/layouts.mdLayout options and selection tips
references/base-prompt.mdBase prompt for image generation
references/dimensions/*.mdDimension specifications (texture, mood, typography, density)
references/dimensions/presets.mdPreset → dimension mapping
references/styles/<style>.mdFull style specifications (legacy)
references/config/preferences-schema.mdEXTEND.md structure

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.

OpenClaw Migration Notes

  • Migration mode: OpenClaw native first
  • Preserved directories:
  • scripts: yes
  • references: yes
  • prompts: no
  • External dependencies: bun
  • Risk level: low
  • Environment variables (detected): HOME
  • Config compatibility: keep original .baoyu-skills/<skill>/EXTEND.md behavior and add OpenClaw-compatible path in runtime wrappers when needed.

OpenClaw Preflight Checks

  • Confirm bun is available when script examples use npx -y bun ....

Detected env vars: HOME

OpenClaw Failure Fallback

  • If runtime dependency is missing, stop execution and return exact install/setup command.

Related skills

FAQ

Is Baoyu Slide Deck safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Generative Mediacontentdistribution

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.