PowerPoint Artisan (v2.0)
This skill creates high-impact, boardroom-ready presentations. It has evolved from a simple Markdown-to-Marp converter into a design-centric orchestrator that can distill native PPTX designs into portable data and reconstruct them from scratch.
Core Capabilities (v2.0: AI-Native Generation)
1. Design Distillation (The Distiller)
Extracts the "soul" (visual design, heritage chain, physical colors) of an existing PowerPoint file into a portable, structured JSON format.
- Heritage Sync: Resolves background images and themes across Slide -> Layout -> Master layers.
- Physical Color Resolution: Translates abstract
schemeClr(e.g.,bg1,accent3) into physical ARGB values. - Asset Extraction: Automatically saves referenced media (images/logos) to an
assetsdirectory.
2. Tailored Re-generation (The Tailor)
"Wears" an extracted Design Protocol onto new presentations without needing the original binary template.
- Z-Order Preservation: Ensures backgrounds, master shapes, and text are rendered in the correct optical order.
- Scale Sync: Matches the EMU canvas dimensions of the original file perfectly.
Legacy Capabilities (v1.0: Marp Conversion)
- Converts Markdown files to PPTX using Marp ecosystems.
- Applies custom CSS themes (
--theme).
Usage Examples
Distill: Extract Design from a Source PPTX
ppt-artisan --distill vault/downloads/original.pptx --out knowledge/templates/design/my-ppt-pattern.json --assets knowledge/templates/design/assetsGenerate: Create PPTX from a Pattern
ppt-artisan --template knowledge/templates/design/my-ppt-pattern.json --out active/projects/final-report.pptxOptions
| Option | Alias | Type | Description |
|---|---|---|---|
--distill | -d | string | Path to source PPTX file to extract Design Protocol (ADF). |
--template | -t | string | Path to Design Protocol JSON (ADF) to apply as a template. |
--input | -i | string | Path to input data (Markdown for Marp, or JSON data). |
--out | -o | string | Output file path (.pptx for generation,.json for distillation). |
--assets | string | Directory path to save/load media assets (Default: next to --out). |
Fidelity Modes & Knowledge Protocol
(Legacy Markdown/Marp generation rules regarding Executive/Standard/Deep-Dive modes still apply when using the --input <markdown> flow.)