product-on-purpose/pm-skills

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.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-slideshow-creator

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

<!-- 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 KeyPurposeDefault Variant
1title_darkOpening slide (bold)dark only
2title_lightOpening slide (internal/lighter)light only
3sectionSection dividerdark
4contentParagraph explanationlight
5bullets3-6 key pointslight
6two_colSide-by-side comparisonlight
7statSingle key metriclight
8dual_statTwo metrics compareddark
9quoteTestimonial or pull quotedark
10three_cardThree parallel conceptsdark
11four_gridFour concepts in 2x2 griddark
12timelineDates or milestones (max 6)light
13process_flowSequential workflow (max 5)light
14agendaMeeting agenda (max 7)light
15highlightKey finding or executive summarylight
16tableTabular datalight
17icon_rowsFeature list with markers (max 4)light
18closingEnd slidedark only

Full slot definitions and character limits: references/slide-types.md

Decision Logic (Quick Reference)

Content PatternUse
Opening the deck (bold)title_dark
Opening the deck (internal)title_light
Transitioning between topicssection
Paragraph explanationcontent
List of 3-6 pointsbullets
Side-by-side comparisontwo_col
Single key metricstat
Two metrics compareddual_stat
Testimonial or pull quotequote
Three parallel conceptsthree_card
Four concepts in a gridfour_grid
Dates or milestonestimeline
Sequential workflowprocess_flow
Meeting agendaagenda
Key finding or summaryhighlight
Tabular datatable
Feature list with markersicon_rows
Ending the deckclosing

Full decision logic with variant strategy: references/decision-logic.md

JSON Deck Spec Format

json
{
  "title": "Q3 Product Update",
  "author": "Product Team",
  "footerText": "Internal . Q3 Review",
  "slides": [
    { "type": "title_dark", "title": "Q3 Product Update", "subtitle": "October 2026" },
    { "type": "stat", "stat": "94%", "label": "Customer satisfaction score", "accentColor": "secondary" },
    { "type": "bullets", "title": "What Shipped", "bullets": ["Feature A", "Feature B", "Feature C"] },
    { "type": "closing" }
  ]
}

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

FilePurpose
references/TEMPLATE.mdJSON deck specification template with field documentation
references/EXAMPLE.mdWorked example: Q3 Product Update deck (9 slides)
references/slide-types.mdAll 18 slide types: content slots, character limits, variants
references/decision-logic.mdContent pattern → slide type mapping, variant strategy, deck sizing
references/platform-rules.mdpptxgenjs requirements, Google Slides compatibility, output format
来自同一仓库

更多 Skills

全部 Skills
product-on-purpose
社区

discover-interview-synthesis

Synthesizes user research interviews into actionable insights, patterns, and recommendations. Use after conducting user interviews, customer calls, or usability sessions to extract and communicate findings across participants. Distinct from foundation-meeting-recap, which summarizes one internal meeting for its attendees; this skill aggregates research conversations into evidence-backed findings.

1小时安装量
1
GitHub Stars
777
最近更新
10月31日
product-on-purpose
社区

tool-design-sprint-prototype-plan

Day 4 (Thursday) move of a Design Sprint that produces the planning artifact for the day. Output covers the prototype role plan (Maker, Stitcher, Writer, Asset Collector, Interviewer), prototype brief (what to build, fidelity bar, time allocation per role), canonical Five-Act Interview script (Welcome, Context, Intro, Tasks, Debrief), trial-run checklist, and Friday participant confirmation tracker. The actual prototype build is craft work outside the skill's AI invocation surface. Use Thursday

1小时安装量
1
GitHub Stars
777
最近更新
10月31日
product-on-purpose
社区

deliver-acceptance-criteria

Generates structured Given/When/Then acceptance criteria for a user story or feature slice, covering the happy path, key failure scenarios, and non-functional expectations in testable form. Use when turning requirements into verifiable scenarios for engineering handoff and QA sign-off. For a dedicated catalog of boundary conditions, error states, and recovery paths across a feature, use deliver-edge-cases; to write the stories themselves, use deliver-user-stories.

1小时安装量
2
GitHub Stars
746
最近更新
10月20日
product-on-purpose
社区

deliver-user-stories

Generates user stories in the standard persona, action, benefit story format from product requirements or feature descriptions. Use when breaking a feature into stories for sprint planning, writing tickets, or communicating scope to engineering. For testable Given/When/Then acceptance criteria on a story, use deliver-acceptance-criteria; for boundary and failure scenarios, use deliver-edge-cases.

1小时安装量
1
GitHub Stars
648
最近更新
9月8日