spec-driven-presentation-maker

Category: Tools & Productivity | Uploader: aws-samples | Downloads: 0 | Version: v1.0（Latest）

Generate PowerPoint presentations from JSON. Use when user wants to create slides, proposals, or presentation materials.

Changelog: Source: GitHub https://github.com/aws-samples/sample-spec-driven-presentation-maker

Directory Structure

Current level: tree/main/skill/

📁 assets/
- 📄 config.example.json 114 B
📁 references/
- 📁 examples/
  - 📁 styles/
    
    📄 .gitkeep 0 B
    
    📄 border.html 12.1 KB
    
    📄 corporate-executive.html 27.1 KB
    
    📄 cute-playful.html 25.5 KB
    
    📄 elegant-dark.html 20.5 KB
    
    📄 elegant-light.html 19.6 KB
    
    📄 flat-shadow.html 15.4 KB
    
    📄 lumina.html 13.0 KB
    
    📄 tech-cyber.html 20.3 KB
  - 📄 components.pptx 135.8 KB
  - 📄 patterns.pptx 104.9 KB
- 📁 guides/
  - 📄 arch-elements.md 8.8 KB
  - 📄 aws-design.md 1.7 KB
  - 📄 chart-bar.md 3.6 KB
  - 📄 chart-line.md 2.5 KB
  - 📄 chart-pie.md 2.6 KB
  - 📄 design-review-guide.md 1.7 KB
  - 📄 design-rules.md 4.5 KB
  - 📄 design-vocabulary.md 3.6 KB
  - 📄 freeform.md 5.9 KB
  - 📄 grid.md 13.1 KB
  - 📄 setup.md 1.1 KB
  - 📄 source-material-guide.md 2.1 KB
  - 📄 storytelling-vocabulary.md 3.5 KB
  - 📄 table.md 11.7 KB
- 📁 workflows/
  - 📄 create-new-1-art-direction.md 5.4 KB
  - 📄 create-new-1-briefing.md 5.2 KB
  - 📄 create-new-1-outline.md 4.8 KB
  - 📄 create-new-2-compose.md 9.0 KB
  - 📄 create-new-3-review.md 2.6 KB
  - 📄 create-new-4-hand-edit-sync.md 1.8 KB
  - 📄 create-style.md 12.1 KB
  - 📄 edit-existing.md 2.3 KB
  - 📄 planner-answers.md 3.2 KB
  - 📄 slide-json-spec.md 21.9 KB
  - 📄 translate-pptx.md 6.6 KB
📁 scripts/
- 📄 download_aws_icons.py 6.5 KB
- 📄 download_material_icons.py 5.8 KB
- 📄 pptx_builder.py 40.6 KB
- 📄 pptx_to_json.py 330 B
📁 sdpm/
- 📁 analyzer/
  - 📄 __init__.py 6.9 KB
- 📁 assets/
  - 📄 __init__.py 16.3 KB
- 📁 builder/
  - 📁 elements/
    
    📄 __init__.py 141 B
    
    📄 chart.py 19.9 KB
    
    📄 group.py 4.3 KB
    
    📄 image.py 9.1 KB
    
    📄 line.py 11.8 KB
    
    📄 shape.py 30.4 KB
    
    📄 table.py 14.3 KB
    
    📄 textbox.py 14.1 KB
  - 📄 __init__.py 19.3 KB
  - 📄 constants.py 3.6 KB
  - 📄 formatting.py 16.1 KB
  - 📄 placeholder.py 7.7 KB
- 📁 converter/
  - 📄 __init__.py 1.6 KB
  - 📄 chart.py 10.7 KB
  - 📄 color.py 11.1 KB
  - 📄 constants.py 3.7 KB
  - 📄 elements.py 56.6 KB
  - 📄 pipeline.py 3.4 KB
  - 📄 slide.py 17.7 KB
  - 📄 table.py 11.5 KB
  - 📄 text.py 12.4 KB
  - 📄 xml_helpers.py 19.6 KB
- 📁 diff/
  - 📄 __init__.py 7.4 KB
- 📁 layout/
  - 📄 __init__.py 16.5 KB
  - 📄 grid.py 6.2 KB
- 📁 preview/
  - 📄 __init__.py 3.2 KB
  - 📄 backend.py 2.5 KB
  - 📄 measure.py 5.6 KB
- 📁 reference/
  - 📄 __init__.py 13.9 KB
  - 📄 providers.py 1.9 KB
- 📁 schema/
  - 📄 __init__.py 103 B
  - 📄 defaults.py 2.0 KB
  - 📄 lint.py 14.7 KB
  - 📄 minimal.py 2.4 KB
- 📁 utils/
  - 📄 __init__.py 134 B
  - 📄 effects.py 8.1 KB
  - 📄 image.py 5.5 KB
  - 📄 io.py 535 B
  - 📄 svg.py 6.7 KB
  - 📄 text.py 8.9 KB
- 📄 __init__.py 184 B
- 📄 api.py 16.5 KB
- 📄 config.py 1.1 KB
📁 templates/
- 📄 blank-dark.pptx 38.2 KB
- 📄 blank-light.pptx 31.6 KB
- 📄 README.md 288 B
📄 pyproject.toml 710 B
📄 SKILL.md 1.7 KB
📄 uv.lock 95.1 KB

SKILL.md

---
name: spec-driven-presentation-maker
description: "Generate PowerPoint presentations from JSON. Use when user wants to create slides, proposals, or presentation materials."
---

# PPTX Maker

Generate PowerPoint from JSON using corporate templates.
All paths in this file are relative to this SKILL.md. `cd` to this directory before running commands.

## CLI

```bash
uv run python3 scripts/pptx_builder.py {command} [args]
```

**Critical constraint:** Do NOT make any decisions about slide structure, content, design, or layout before loading the workflow. The workflow files contain the full process including briefing, outline, and art direction. Wait until the workflow is loaded and follow it step by step.

**After loading:** Present the options and ask which to do:

A. New presentation — create slides from scratch
B. Edit existing PPTX — modify a provided file
C. Hand-edit sync — continue from a user-edited PPTX
D. Create style — build a reusable style guide

## Workflow A: New Presentation

When no existing PPTX is provided.
→ Run `uv run python3 scripts/pptx_builder.py workflows create-new-1-briefing` to start. Follow each file's Next Step from there.

## Workflow B: Edit Existing PPTX

When an existing PPTX is provided.
→ Run `uv run python3 scripts/pptx_builder.py workflows edit-existing` to start.

## Workflow C: Hand-Edit Sync

When the user hand-edits the generated PPTX in PowerPoint and then asks for further changes.
→ Run `uv run python3 scripts/pptx_builder.py workflows create-new-4-hand-edit-sync` to start.

## Workflow D: Create Style

When the user wants to create a new reusable style guide.
→ Run `uv run python3 scripts/pptx_builder.py workflows create-style` to start.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

spec-driven-presentation-maker

Directory Structure

SKILL.md

Report

Notice