pptx-create

/pptx-create

Create a new PowerPoint presentation using a template from the extracted library. Populate slides from an outline, vault notes, or a JSON content specification.

Usage

/pptx-create <title> [--template <slug>]
/pptx-create <title> --template <slug> --from <note-path>
/pptx-create --template <slug> --content <content.json>

Examples

/pptx-create "Q1 Architecture Review" --template baae-community-day-feb2026
/pptx-create "Alpha Programme Update" --from "Projects/Project - Alpha.md"
/pptx-create --template baae-community-day-feb2026 --content slides.json

Instructions

Phase 1: Select Template

1. If --template provided, load that template
2. If not provided, list available templates and ask user to choose:

python3 .claude/scripts/pptx_create.py --list-templates

Use AskUserQuestion to select:

Question: "Which template should be used?"
Header: "Template"
Options:
  1. "<most recent template>" (Recommended)
  2. "<other template>"
  3. "List all layouts first"

Phase 2: Define Content

Determine the content source based on user input:

Option A: Interactive Outline

If user provides just a title, help them build an outline interactively:

1. Ask for the presentation structure (sections/topics)
2. For each section, ask for key points
3. Map each section to an appropriate layout

Option B: From Vault Note

If --from <note-path> is provided:

1. Read the vault note
2. Extract headings, key points, and relationships
3. Map sections to slides automatically:
   • H1 → Title slide
   • H2 → Section headers
   • H3 + bullets → Content slides
   • Tables → Content slides with table data
   • Images → Image layout slides

Option C: JSON Content Specification

If --content <file> is provided, use the JSON directly. Format:

{
  "title": "Presentation Title",
  "slides": [
    {
      "layout": "title-slide",
      "content": {
        "title": "Presentation Title",
        "subtitle": "Author — Date"
      }
    },
    {
      "layout": "section-divider-dark-blue",
      "content": {
        "title": "Section Name"
      }
    },
    {
      "layout": "single-column-text",
      "content": {
        "title": "Slide Title",
        "body": ["Bullet 1", "Bullet 2", "Bullet 3"]
      },
      "notes": "Speaker notes here"
    },
    {
      "layout": "two-column-text",
      "content": {
        "title": "Comparison",
        "left": ["Before item 1", "Before item 2"],
        "right": ["After item 1", "After item 2"]
      }
    },
    {
      "layout": "large-image-large-text",
      "content": {
        "title": "Architecture Diagram",
        "image": "Attachments/diagram.png",
        "body": "Key architecture overview"
      }
    }
  ]
}