baoyu-slide-deck Skill: Turn an Article Into Slide Images, PPTX and PDF

Turns an article or notes into a deck of AI-generated slide images and merges them into PPTX and PDF files.

Installs: 31.4K; on skills.sh
Stars: 27.2K; on GitHub
Files: 34; besides SKILL.md
Updated: Nov 2026; last repo commit

baoyu-slide-deck makes your agent turn source content into a slide deck. It analyzes the content, asks you to confirm style, audience and slide count, writes an outline and one prompt file per slide, generates each slide as an image, then merges the images into a .pptx and a .pdf. The slides are made for reading and sharing, not for presenting live. It needs an image-generation backend: Codex's imagegen, Cursor's GenerateImage, or the repo's baoyu-image-gen skill with a provider key or a Codex login.

Good for

Writers and marketers who want a shareable deck from an article
Educators and developers making explainers or tutorials
People who need the slides as PPTX or PDF files
Claude Code, Codex and Cursor users who already run skills

Install baoyu-slide-deck

Claude Code

Copy this prompt.

Install the baoyu-slide-deck skill in Claude Code. Run this command:

npx skills add jimliu/baoyu-skills --skill baoyu-slide-deck --skill baoyu-image-gen -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

baoyu-image-gen is the repo's own image backend. It needs a key for one image provider (listed under environment variables), or a logged-in Codex CLI. Codex and Cursor have their own image tools, which baoyu-slide-deck prefers when it runs there. The README asks you to install only the skills you need, because its plain command installs 20+.

From the vendor's docs. Source.

What's in the skill

When it loads

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

Sections in SKILL.md

User Input Tools
Image Generation Tools
Batch Generation Policy
Confirmation Policy
Language
Script Directory
Options
Style System
Presets (17)
Dimensions (when "Custom dimensions" picked)
Auto-Selection
Slide Count Heuristic
Reference Images
File Layout
Workflow
Step 1: Setup & Analyze

Key facts

Author: jimliu, also known as Baoyu (repo owner)
License: MIT
Installs on skills.sh: 31,410 (Nov 2, 2026)
GitHub stars: 27,159 (Nov 2, 2026, whole repo)
Last commit: Nov 1, 2026
What installs: 35 files including SKILL.md: 2 scripts (merge-to-pptx.ts, merge-to-pdf.ts) and reference files for styles, layouts and prompts
Needs: An image backend, plus bun (or npx) to run the merge scripts
Style presets: 17, built from texture, mood, typography and density
Output: slide-deck/<topic>/ with outline.md, prompts/, slide PNGs, a .pptx and a .pdf
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass

What it includes

Loads your saved preferences and analyzes the content
Looks for an EXTEND.md file in the project, XDG or home folder, saves the source as source.md and writes analysis.md with topic, audience, style signals and slide count.
Write · Setup and analyze
Asks style, audience, slide count and review choices before anything is generated
A hard gate. Only an explicit request to skip, such as "直接生成", lets it go ahead without asking.
Confirm (required)
Writes outline.md with a layout for each slide
Picks one of 17 presets by matching words in your source, or combines custom texture, mood, typography and density.
Write · Generate outline
Shows a slide table; you proceed, edit outline.md or regenerate
Skipped if you chose no review.
Review outline (optional)
Saves one prompt file per slide under prompts/
The prompt files are the record, and each must exist before any image is generated.
Write · Generate prompts
Shows the prompt list; you proceed, edit or regenerate
Skipped if you chose no review.
Review prompts (optional)
Renders each slide as an image through your image backend
Runs up to 4 at a time by default (--batch-size 1 to 8) and retries a failed slide once. SKILL.md says about 10 to 30 seconds per slide.
Write · Generate images
Runs merge-to-pptx.ts and merge-to-pdf.ts on the slide folder
Runs with bun, or npx -y bun. Only after all selected slides exist.
Runs code · Merge to PPTX and PDF
Stops after the outline or after the prompts
Use to review before any images are generated.
--outline-only / --prompts-only
Skips to image generation, or redoes chosen slides
--regenerate takes a number or a list such as 2,5,8.
Network · --images-only / --regenerate N
Edit, add or delete slides
SKILL.md says to update the prompt file first, then regenerate. It does not repair text on a finished image with code.
Write · Slide modification

From the official docs

Permissions

Medium risk

It sends your content to an image provider and runs two scripts on your machine. Try --outline-only first and keep API keys out of git.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Your content goes to an image provider
Each slide prompt is built from your source and sent to the backend you pick. Do not feed it text you cannot share with that provider. github.com
It runs scripts and may download bun
The merge step runs two bundled TypeScript scripts, and the installed baoyu-image-gen skill runs its own scripts the same way. If bun is not installed, SKILL.md says to try npx -y bun, or to install bun with brew. Install bun yourself if you want to control that. github.com
It writes a folder of files in your project
Outline, prompts, PNGs, PPTX and PDF go in slide-deck/<topic>/. Existing files are renamed with a backup suffix before it writes. github.com
Image generation can cost money
It renders one image per slide, 4 at a time by default (--batch-size 1 to 8). Provider billing is yours. Try --outline-only first and watch the first run. github.com

Technical details

Turning on read-only	Use --outline-only or --prompts-only to stop before any image is generated.
Talks to	Your image provider receives each slide prompt, built from your content. npx -y bun downloads bun if it is not installed
Sign-in and keys	Provider keys for baoyu-image-gen live in a .env file: ~/.baoyu-skills/.env or <project>/.baoyu-skills/.env. The README tells you not to commit project-level .env files.
Scopes	Your project folder: it creates slide-deck/<topic>/ and renames existing files to -backup- before overwriting A .env file with your image provider key

Questions

What does baoyu-slide-deck do?

It turns an article or notes into a deck of slide images in a style you pick, then merges them into PPTX and PDF files. The slides are written to be read and shared, so each is self-explanatory.

How do I install baoyu-slide-deck in Claude Code?

Use the install box above. It adds baoyu-slide-deck and baoyu-image-gen together, because Claude Code has no built-in image tool. Then set one provider key for baoyu-image-gen, listed under environment variables.

Does it need an API key?

Usually. The skill needs some image backend. Codex and Cursor have their own, and elsewhere the repo's baoyu-image-gen takes a provider key (OpenAI, Google, OpenRouter and others) or a logged-in Codex CLI, which needs no OPENAI_API_KEY per its SKILL.md.

Does baoyu-slide-deck work in the Claude app?

Not documented. The skill writes files, runs scripts with bun and calls an image backend from a terminal agent, and the README does not mention the Claude app. Use Claude Code, Codex or Cursor.

Is baoyu-slide-deck safe?

It sends your slide content to the image provider you choose, runs two bundled scripts (and the scripts in baoyu-image-gen), and writes a folder of files in your project. If bun is missing it falls back to npx -y bun, which downloads and runs bun. Keep API keys in a .env file you do not commit.

Can it fix wrong text on a slide?

Not by editing the picture. SKILL.md forbids covering or repainting text on a generated slide. It regenerates from a corrected prompt, simplifies the on-slide text, or asks you which flawed version to keep.

How is it different from baoyu-xhs-images?

baoyu-slide-deck builds an ordered deck with an outline and exports PPTX and PDF. baoyu-xhs-images builds 1 to 10 cartoon-style cards for social posts and exports images only. Both live in the same repo.

Information

updated Nov 2, 2026

Repository: jimliu/baoyu-skills
Folder: skills/baoyu-slide-deck

jimliu/baoyu-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

baoyu-skills README · github.com
skills CLI commands · github.com
baoyu-slide-deck SKILL.md · github.com
baoyu-image-gen SKILL.md · github.com
codex-imagegen.md · github.com