utility-slideshow-creator
Generates professional presentations from a JSON deck specification using 18 slide types with dark/light variants, content-to-layout decision logic, and calibrated character limits. Ships with a default professional theme.
By product-on-purpose · 626 installs
npx skills add product-on-purpose/pm-skills --skill utility-slideshow-creator
Source repository · Upstream listing
<! PM Skills https://github.com/product on purpose/pm skills Apache 2.0
Slideshow Creator
Generate professional presentations (.pptx and .pdf) from a JSON deck specification. Zero design decisions at generation time Claude selects slide types and fills content slots; all visual properties are pre decided by the theme.
When to Use
Creating slide decks for stakeholder updates, product reviews, team presentations
Generating professional .pptx files from content briefs
Producing consistent presentations without manual formatting
Exporting presentations to PDF for sharing or archiving
When NOT to Use
Creating complex data visualizations (use dedicated charting tools)
Building interactive web presentations (this produces .pptx, not HTML)
Editing existing PowerPoint files (this creates new decks from scratch)
How It Works
Two phase architecture:
1. Spec phase (Claude) Read the content brief, select slide types using decision logic, write a JSON deck specification. Content slots have character limits calibrated to prevent overflow. This is the only phase that costs tokens.
2. Generation phase (Local script) Run node scripts/generate deck.js deck spec.json to produce .pptx. Optionally run node scripts/export pdf.mjs deck spec.json for PDF. Deterministic rendering, zero token cost.
Both outputs come from the same JSON spec, so .pptx and .pdf always match.
18 Slide Types
Type Key Purpose Default Variant
1 title dark Opening slide (bold) dark only
2 title light Opening slide (internal/lighter) light only
3 section Section divider dark
4 content Paragraph explanation light
5 bullets 3 6 key points light
6 two col Side by side comparison light
7 stat Single key metric light
8 dual stat Two metrics compared dark
9 quote Testimonial or pull quote dark
10 three card Three parallel concepts dark
11 four grid Four concepts in 2x2 grid dark
12 timeline Dates or milestones (max 6) light
13 process flow Sequential workflow (max 5) light
14 agenda Meeting agenda (max 7) light
15 highlight Key finding or executive summary light
16 table Tabular data light
17 icon rows Feature list with markers (max 4) light
18 closing End slide dark only
Full slot definitions and character limits: references/slide types.md
Decision Logic (Quick Reference)
Content Pattern Use
Opening the deck (bold) title dark
Opening the deck (internal) title light
Transitioning between topics section
Paragraph explanation content
List of 3 6 points bullets
Side by side comparison two col
Single key metric stat
Two metrics compared dual stat
Testimonial or pull quote quote
Three parallel concepts three card
Four concepts in a grid four grid
Dates or milestones timeline
Sequential workflow process flow
Meeting agenda agenda
Key finding or summary highlight
Tabular data table
Feature list with markers icon rows
Ending the deck closing
Full decision logic with variant strategy: references/decision logic.md
JSON Deck Spec Format
Colors accept theme token names ( "accent" , "secondary" , "tertiary" , "warm" ) or 6 character hex strings ( "2563EB" ).
Full schema and workflow: references/TEMPLATE.md and references/platform rules.md
Instructions
1. Read the content brief Understand topic, audience, length, specific requirements
2. Plan the deck Select slide types using the decision logic table. Assign dark/light variants for visual rhythm (alternate to avoid monotony).
3. Write the JSON deck specification Fill content slots, respecting character limits from references/slide types.md
4. Run the generation script node scripts/generate deck.js deck spec.json
5. Optionally export PDF node scripts/export pdf.mjs deck spec.json output.pdf
6. Report the output Tell the user where the file(s) are
Output Contract
Planning artifact : JSON deck specification (the file Claude writes)
Final output : .pptx file (+ optional .pdf), generated locally from the spec
Quality gate : All items in the quality checklist pass
Quality Checklist
[ ] Every slide has a valid type key (one of the 18 defined types)
[ ] All content slots respect character limits from references/slide types.md
[ ] Dark/light variants alternate for visual rhythm (no 3+ consecutive same variant slides)
[ ] Deck has a title slide (first) and a closing slide (last)
[ ] Section dividers separate distinct topics in decks 6 slides
[ ] Speaker notes included for key slides (stats, highlights, transitions)
[ ] JSON is valid (no trailing commas, proper quoting, correct nesting)
[ ] Color values are valid theme tokens or 6 character hex strings (no prefix)
References
File Purpose
references/TEMPLATE.md JSON deck specification template with field documentation
references/EXAMPLE.md Worked example: Q3 Product Update deck (9 slides)
references/slide types.md All 18 slide types: content slots, character limits, variants
references/decision logic.md Content pattern → slide type mapping, variant strategy, deck sizing
references/platform rules.md pptxgenjs requirements, Google Slides compatibility, output format