PPTX Generation Skill
Domain: Presentation Generation
Purpose: Programmatic PowerPoint creation via PptxGenJS
Expertise: Data-driven slides, Markdown conversion, the AI assistant brand templates
Staleness Watch: See EXTERNAL-API-REGISTRY.md for source URLs and recheck cadence
Capabilities
| Capability |
Description |
| Markdown → PPTX |
Convert .md files to branded presentations |
| Data-Driven Slides |
Generate charts/tables from JSON data |
| Template System |
the AI assistant brand Slide Masters (title, content, section, chart) |
| Multi-Format Export |
File output or base64 for web delivery |
Activation Triggers
- "create presentation", "generate slides", "make pptx"
- "convert markdown to powerpoint", "md to pptx"
- "data visualization slides", "chart presentation"
- "alex branded deck", "presentation template"
Slide Types
| Type |
Use Case |
Data Shape |
title |
Opening slide with main title + subtitle |
{ title, subtitle?, notes? } |
content |
Bullet list slide |
{ title, bullets[], notes? } |
section |
Section divider |
{ title, subtitle? } |
chart |
Data visualization |
{ chartType, series[], title? } |
table |
Tabular data |
{ headers[], rows[][] } |
image |
Image slide |
{ path|base64, caption? } |
twoColumn |
Side-by-side content |
{ left: {title, bullets}, right: {title, bullets} } |
Chart Types
bar — Category comparisonline — Trend over timepie — Part-of-whole (use ≤6 segments)doughnut — Pie variant with center holearea — Volume over timescatter — Correlation analysis
the AI assistant Brand Colors
| Name |
Fill |
Text |
Border |
| Blue |
ddf4ff |
0550ae |
80ccff |
| Green |
d3f5db |
1a7f37 |
6fdd8b |
| Purple |
d8b9ff |
6639ba |
bf8aff |
| Gold |
fff8c5 |
9a6700 |
d4a72c |
| Gray |
eaeef2 |
24292f |
afb8c1 |
Example: Markdown Input
# Quarterly Review
## Executive Summary
---
# Q4 2024 Results
## Performance Overview
- Revenue up 23% YoY
- Customer acquisition: 1,200 new accounts
- NPS improved from 45 to 62
> Speaker notes: Highlight the NPS improvement as key win
---
## Next Quarter [section]
Focus areas for Q1 2025
---
# Strategic Priorities
- Expand enterprise segment
- Launch self-serve tier
- Hire 15 engineers
Example: Programmatic API
import { generateAndSavePresentation, SlideContent } from './pptxGenerator';
const slides: SlideContent[] = [
{ type: 'title', title: 'Q4 Review', subtitle: 'Performance & Strategy' },
{ type: 'content', title: 'Highlights', bullets: ['Revenue +23%', 'NPS 62'] },
{ type: 'chart', title: 'Revenue Trend', data: {
chartType: 'line',
series: [{ name: 'Revenue', labels: ['Q1','Q2','Q3','Q4'], values: [100,120,115,146] }]
}}
];
await generateAndSavePresentation(slides, { title: 'Q4 Review' }, 'review.pptx');
CLI Usage
# From markdown (planned)
# node .github/muscles/pptxgen-cli.cjs --input slides.md --output deck.pptx
# Quick content (planned)
# node .github/muscles/pptxgen-cli.cjs --content "Welcome to the AI assistant|Point 1|Point 2" --output quick.pptx
Integration Points
| Integration |
Description |
| Chat command |
/pptx <topic> to generate slides from topic |
| Memory export |
Convert episodic memories to slides |
| Skill output |
Any skill can request PPTX output |
| Data connectors |
Azure SQL / Power BI → charts |
Constraints
- Offline-only (no cloud dependencies)
- 16:9 default layout (4:3, 16:10 available)
- Max recommended: 50 slides per deck
- Images: local path, URL, or base64
1---2name: pptx-generation3description: Programmatic PowerPoint creation via PptxGenJS with data-driven slides and Markdown conversion4---5
6# PPTX Generation Skill
7
8
9**Domain**: Presentation Generation
10**Purpose**: Programmatic PowerPoint creation via PptxGenJS
11**Expertise**: Data-driven slides, Markdown conversion, the AI assistant brand templates
12
13> **Staleness Watch**: See `EXTERNAL-API-REGISTRY.md` for source URLs and recheck cadence
14
15---
16
17## Capabilities
18
19| Capability | Description |
20|------------|-------------|
21| **Markdown → PPTX** | Convert `.md` files to branded presentations |
22| **Data-Driven Slides** | Generate charts/tables from JSON data |
23| **Template System** | the AI assistant brand Slide Masters (title, content, section, chart) |
24| **Multi-Format Export** | File output or base64 for web delivery |
25
26---
27
28## Activation Triggers
29
30- "create presentation", "generate slides", "make pptx"
31- "convert markdown to powerpoint", "md to pptx"
32- "data visualization slides", "chart presentation"
33- "alex branded deck", "presentation template"
34
35---
36
37## Slide Types
38
39| Type | Use Case | Data Shape |
40|------|----------|-----------|
41| `title` | Opening slide with main title + subtitle | `{ title, subtitle?, notes? }` |
42| `content` | Bullet list slide | `{ title, bullets[], notes? }` |
43| `section` | Section divider | `{ title, subtitle? }` |
44| `chart` | Data visualization | `{ chartType, series[], title? }` |
45| `table` | Tabular data | `{ headers[], rows[][] }` |
46| `image` | Image slide | `{ path\|base64, caption? }` |
47| `twoColumn` | Side-by-side content | `{ left: {title, bullets}, right: {title, bullets} }` |
48
49---
50
51## Chart Types
52
53- `bar` — Category comparison
54- `line` — Trend over time
55- `pie` — Part-of-whole (use ≤6 segments)
56- `doughnut` — Pie variant with center hole
57- `area` — Volume over time
58- `scatter` — Correlation analysis
59
60---
61
62## the AI assistant Brand Colors
63
64| Name | Fill | Text | Border |
65|------|------|------|--------|
66| Blue | `ddf4ff` | `0550ae` | `80ccff` |
67| Green | `d3f5db` | `1a7f37` | `6fdd8b` |
68| Purple | `d8b9ff` | `6639ba` | `bf8aff` |
69| Gold | `fff8c5` | `9a6700` | `d4a72c` |
70| Gray | `eaeef2` | `24292f` | `afb8c1` |
71
72---
73
74## Example: Markdown Input
75
76```markdown
77# Quarterly Review
78
79## Executive Summary
80
81---
82
83# Q4 2024 Results
84
85## Performance Overview
86
87- Revenue up 23% YoY
88- Customer acquisition: 1,200 new accounts
89- NPS improved from 45 to 62
90
91> Speaker notes: Highlight the NPS improvement as key win
92
93---
94
95## Next Quarter [section]
96
97Focus areas for Q1 2025
98
99---
100
101# Strategic Priorities
102
103- Expand enterprise segment
104- Launch self-serve tier
105- Hire 15 engineers
106```
107
108---
109
110## Example: Programmatic API
111
112```typescript
113import { generateAndSavePresentation, SlideContent } from './pptxGenerator';
114
115const slides: SlideContent[] = [
116 { type: 'title', title: 'Q4 Review', subtitle: 'Performance & Strategy' },
117 { type: 'content', title: 'Highlights', bullets: ['Revenue +23%', 'NPS 62'] },
118 { type: 'chart', title: 'Revenue Trend', data: {
119 chartType: 'line',
120 series: [{ name: 'Revenue', labels: ['Q1','Q2','Q3','Q4'], values: [100,120,115,146] }]
121 }}
122];
123
124await generateAndSavePresentation(slides, { title: 'Q4 Review' }, 'review.pptx');
125```
126
127---
128
129## CLI Usage
130
131```bash
132# From markdown (planned)
133# node .github/muscles/pptxgen-cli.cjs --input slides.md --output deck.pptx
134
135# Quick content (planned)
136# node .github/muscles/pptxgen-cli.cjs --content "Welcome to the AI assistant|Point 1|Point 2" --output quick.pptx
137```
138
139---
140
141## Integration Points
142
143| Integration | Description |
144|-------------|-------------|
145| **Chat command** | `/pptx <topic>` to generate slides from topic |
146| **Memory export** | Convert episodic memories to slides |
147| **Skill output** | Any skill can request PPTX output |
148| **Data connectors** | Azure SQL / Power BI → charts |
149
150---
151
152## Constraints
153
154- Offline-only (no cloud dependencies)
155- 16:9 default layout (4:3, 16:10 available)
156- Max recommended: 50 slides per deck
157- Images: local path, URL, or base64
gabrielmoreira