Pptx Generation

---
name: pptx-generation
description: "Programmatic PowerPoint creation via PptxGenJS with data-driven slides and Markdown conversion"
lastReviewed: 2026-04-30
---

# 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 comparison
- `line` — Trend over time
- `pie` — Part-of-whole (use ≤6 segments)
- `doughnut` — Pie variant with center hole
- `area` — Volume over time
- `scatter` — 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

```markdown
# 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

```typescript
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

```bash
# 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