JimLiu

baoyu-slide-deck

@JimLiu/baoyu-slide-deck
JimLiu
603
61 forks
Updated 1/18/2026
View on GitHub

Generate professional slide deck images from content. Creates comprehensive outlines with style instructions, then generates individual slide images. Use when user asks to "create slides", "make a presentation", "generate deck", or "slide deck".

Installation

$skills install @JimLiu/baoyu-slide-deck
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Pathskills/baoyu-slide-deck/SKILL.md
Branchmain
Scoped Name@JimLiu/baoyu-slide-deck

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: baoyu-slide-deck description: Generate professional slide deck images from content. Creates comprehensive outlines with style instructions, then generates individual slide images. Use when user asks to "create slides", "make a presentation", "generate deck", or "slide deck".

Slide Deck Generator

Transform content into professional slide deck images with flexible style options.

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

Important: All scripts are located in the scripts/ subdirectory of this skill.

Agent Execution Instructions:

  1. Determine this SKILL.md file's directory path as SKILL_DIR
  2. Script path = ${SKILL_DIR}/scripts/<script-name>.ts
  3. Replace all ${SKILL_DIR} in this document with the actual path

Script Reference:

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

Options

OptionDescription
--style <name>Visual style (see Style Gallery)
--audience <type>Target audience: beginners, intermediate, experts, executives, general
--lang <code>Output language (en, zh, ja, etc.)
--slides <number>Target slide count
--outline-onlyGenerate outline only, skip image generation

Style Gallery

StyleDescriptionBest For
blueprint (Default)Technical schematics, grid textureArchitecture, system design
notionSaaS dashboard, card-based layoutsProduct demos, SaaS, B2B
bold-editorialMagazine cover, bold typography, darkProduct launches, keynotes
corporateNavy/gold, structured layoutsInvestor decks, proposals
dark-atmosphericCinematic dark mode, glowing accentsEntertainment, gaming
editorial-infographicMagazine explainers, flat illustrationsTech explainers, research
fantasy-animationGhibli/Disney style, hand-drawnEducational, storytelling
intuition-machineTechnical briefing, bilingual labelsTechnical docs, academic
minimalUltra-clean, maximum whitespaceExecutive briefings, premium
pixel-artRetro 8-bit, chunky pixelsGaming, developer talks
scientificAcademic diagrams, precise labelingBiology, chemistry, medical
sketch-notesHand-drawn, warm & friendlyEducational, tutorials
vector-illustrationFlat vector, retro & cuteCreative, children's content
vintageAged-paper, historical stylingHistorical, heritage, biography
watercolorHand-painted textures, natural warmthLifestyle, wellness, travel

Auto Style Selection

Content SignalsSelected Style
tutorial, learn, education, guide, intro, beginnersketch-notes
architecture, system, data, analysis, technicalblueprint
creative, children, kids, cute, illustrationvector-illustration
briefing, academic, research, bilingual, infographic, conceptintuition-machine
executive, minimal, clean, simple, elegantminimal
saas, product, dashboard, metrics, productivitynotion
investor, quarterly, business, corporate, proposalcorporate
launch, marketing, keynote, bold, impact, magazinebold-editorial
entertainment, music, gaming, creative, atmosphericdark-atmospheric
explainer, journalism, science communicationeditorial-infographic
story, fantasy, animation, magical, whimsicalfantasy-animation
gaming, retro, pixel, developer, nostalgiapixel-art
biology, chemistry, medical, pathway, scientificscientific
history, heritage, vintage, expedition, historicalvintage
lifestyle, wellness, travel, artistic, naturalwatercolor
Defaultblueprint

Design Philosophy

This deck is designed for reading and sharing, not live presentation:

  • Each slide must be self-explanatory without verbal commentary
  • Structure content for logical flow when scrolling
  • Include all necessary context within each slide
  • Optimize for social media sharing and offline reading

File Management

With Content Path

content-dir/
├── source-content.md
└── source-content/
    └── slide-deck/
        ├── 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

Example: /posts/ai-intro.md/posts/ai-intro/slide-deck/

Without Content Path (Pasted Content)

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

Directory Backup

If target directory exists, rename existing to <dirname>-backup-YYYYMMDD-HHMMSS

Workflow

Step 1: Analyze Content

  1. Save source content (if pasted, save as source.md)
  2. Follow references/analysis-framework.md for deep content analysis
  3. Determine style (use --style or auto-select from signals)
  4. Detect languages (source vs. user preference)
  5. Plan slide count (--slides or dynamic)

Step 2: Generate Outline Variants

  1. Generate 3 style variant outlines based on content analysis
  2. Follow references/outline-template.md for structure
  3. Save as outline-{style}.md for each variant

Step 3: User Confirmation

Single AskUserQuestion with all applicable options:

QuestionWhen to Ask
Style variantAlways (3 options + custom)
LanguageOnly if source ≠ user language

After selection:

  • Copy selected outline-{style}.md to outline.md
  • Regenerate in different language if requested
  • User may edit outline.md for fine-tuning

If --outline-only, stop here.

Step 4: Generate Prompts

  1. Read references/base-prompt.md
  2. Combine with style instructions from outline
  3. Add slide-specific content
  4. Save to prompts/ directory

Step 5: Generate Images

  1. Select available image generation skill
  2. Generate session ID: slides-{topic-slug}-{timestamp}
  3. Generate each slide with same session ID
  4. Report progress: "Generated X/N"

Step 6: 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 7: Output Summary

Slide Deck Complete!

Topic: [topic]
Style: [style name]
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

Slide Modification

See references/modification-guide.md for:

  • Edit single slide workflow
  • Add new slide (with renumbering)
  • Delete slide (with renumbering)
  • File naming conventions

References

FileContent
references/analysis-framework.mdDeep content analysis for presentations
references/outline-template.mdOutline structure and STYLE_INSTRUCTIONS format
references/modification-guide.mdEdit, add, delete slide workflows
references/content-rules.mdContent and style guidelines
references/base-prompt.mdBase prompt for image generation
references/styles/<style>.mdFull style specifications

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

Extension Support

Custom styles and configurations via EXTEND.md.

Check paths (priority order):

  1. .baoyu-skills/baoyu-slide-deck/EXTEND.md (project)
  2. ~/.baoyu-skills/baoyu-slide-deck/EXTEND.md (user)

If found, load before Step 1. Extension content overrides defaults.