Skip to content

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

2.4 KB
Raw Blame

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 executed
  • svg_final/ is a self-contained visual preview, and exports/*.pptx is 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/