AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
User Project Workspace
This directory is used for storing in-progress projects.
Create a New Project
# Defer the canvas to authoring:
python3 skills/ppt-master/scripts/project_manager.py init my_project
# Or record an exact registered canvas:
python3 skills/ppt-master/scripts/project_manager.py init my_widescreen --format ppt169
Pass --format only when the canvas exactly matches a registered format. If it
is omitted, the canvas is determined during authoring and recorded in
spec_lock.md for Default Generate or by the first SVG for Quick Generate.
Directory Structure
A typical project usually contains the following:
project_name[_registered_format]_YYYYMMDD/
├── README.md
├── design_spec.md
├── sources/
│ ├── Raw files / URL archives / Converted Markdown
│ └── *_files/ # Markdown companion resource directory (e.g., images)
├── images/ # Image assets used by the project
├── analysis/ # Extracted source facts (PPTX intake bundle, image_analysis.csv)
├── notes/
│ ├── 01_xxx.md
│ ├── 02_xxx.md
│ └── total.md
├── svg_output/
│ ├── 01_xxx.svg
│ └── ...
├── svg_final/
│ ├── 01_xxx.svg
│ └── ...
├── templates/ # Project-level templates (if any)
└── exports/
└── *.pptx # Native DrawingML deliverables
The optional format token appears only when init receives --format.
Projects can remain at different stages and do not necessarily have all artifacts at once. For example:
- Only
sources/archiving and the Design Specification & Content Outline (design_spec) are complete svg_output/has been generated, but post-processing has not yet been executedsvg_final/is a self-contained visual preview, andexports/*.pptxis complete
Notes
- Contents under this directory are excluded by
.gitignore svg_final/may be opened directly or inserted manually as an SVG image; PowerPoint's manual Convert to Shape behavior is not supported- Completed projects can be published through the PPT Master examples repository
- Files outside the workspace are copied by default; files within the workspace are moved directly to the project's
sources/