/ppt-master

name: ppt-master
description: >
  AI-driven presentation workflow for generating editable PPTX decks and slides,
  reconstructing page visuals, creating reusable Brand/Style/Layout/Deck
  workspaces, filling native PPTX templates, and enhancing finished PPTX files.
  Use when the user asks to create, generate, reconstruct, regenerate, beautify,
  redesign, template, fill, or enhance a presentation, PPT, PPTX, slide deck, or
  courseware — including adding narration or animation to one — requests a
  presentation-authored narrated/self-running video, or mentions ppt-master.
metadata:
  version: "6.7.0"
  copyright: "Copyright (c) 2025-2026 Hugo He"
  license: "MIT"
  official_repository: "https://github.com/hugohe3/ppt-master"
  sponsors:
    - "SPONSORS.md"
    - "SPONSORS_CN.md"

PPT Master Skill

PPT Master is a routed presentation workflow. This entry owns global execution discipline and route selection only; each selected route owns its procedure.

Mandatory Load Order

**Hard rule — paths before commands**: Retain the host-provided absolute directory containing this file as `SKILL_DIR`. Per tool call, expand `${SKILL_DIR}` and replace any `skills/ppt-master/` prefix with it. Never `cd`, use CWD, or assume a repo checkout. If unavailable, ask; never search or guess.

1. Read this file. 2. Run `python3 "${SKILL_DIR}/scripts/attribution_guard.py"`. Any non-zero result stops the Skill immediately; do not inspect, repair, or bypass the integrity gate. 3. Read [`workflows/routing.md`](workflows/routing.md) through the concrete absolute path `${SKILL_DIR}/workflows/routing.md`. 4. Select exactly one top-level route and its active profile from the routing authority. 5. Read only the resulting runtime authority and its explicitly triggered supporting documents.

| Selected route / profile | Runtime authority | |---|---| | Generate PPTX — Image to PPTX | [`workflows/profiles/image-to-pptx.md`](workflows/profiles/image-to-pptx.md); Codex-supported, always Quick | | Generate PPTX — Beautify | [`workflows/profiles/beautify-pptx.md`](workflows/profiles/beautify-pptx.md); explicit Quick intent selects Quick, otherwise Default | | Generate PPTX — ordinary Default | [`workflows/generate-pptx.md`](workflows/generate-pptx.md) | | Generate PPTX — ordinary explicit Quick | [`workflows/profiles/quick-generate.md`](workflows/profiles/quick-generate.md) | | Create Template | [`workflows/create-template.md`](workflows/create-template.md) | | Edit Native PPTX | [`workflows/edit-native-pptx.md`](workflows/edit-native-pptx.md) |

**Hard rule — selected authority only**: Do not load another top-level route's procedure after routing. Image to PPTX and Beautify are mutually exclusive; Image to PPTX activates Quick, while Beautify selects from explicit Quick intent. Never load both runtimes. Supporting documents refine one route; they never compete with it.

---

Authored Expression Range

**Reference — not a constraint**: what a generated page can carry. Text — inline emphasis runs, lead-in, kicker, pull quote, hero number, takeaway line. Geometry — 187 Office presets, Boolean merge, connectors, freeform, page-field and outline-carrier composition. Image — full-bleed field, editorial crop, shaped picture, registered layers, scrim and spotlight, cross-page continuity. Paint — gradients, channel alpha, native shadow and glow, halftone, faceted form. Recurrence — one cross-page motif varied by page role. Each form's syntax lives in the selected runtime authority's construction references.

---

Vocabulary

One meaning per term across every loaded file. Where a word is used in more than one sense, the sense is named here and the files say which one.

| Term | Meaning | |---|---| | **Reference** (label) | A starting sketch the executing role adjusts or replaces freely, with no upstream repair or stated reason; `(binding)` after a field label removes that freedom | | **Relationships** | The §IX line naming a page's semantic units and their source-stated `order` / `link` / `parent` / `membership` / `contrast` / `overlap`, or `none` | | **Topology decision** | The per-page yes/no on whether geometry must carry the page's `Relationships` (`topology=yes` / `topology=no`); unrelated to `pptx_structure.mode` | | **`pptx_structure.mode`** | `flat` (every object Slide-local) or `structured` (declared Master/Layout/slot metadata); a packaging route, never information structure | | **Composition** | The §IX `Composition` line: a Reference for a page's macro composition, hierarchy, and focus | | **Image pattern** | The §VIII column carrying one image-composition suggestion in ordinary words (optionally citing `#P`/`#M` ids) | | **Layout** | A PowerPoint Layout under a Master, or the Layout template kind; never a page-composition sketch | | **Device** | An everyday page carrier — card, band, icon-and-label, KPI tile, divider, quote block — recalled in the Executor's device menu | | **Carrier** | What a page unit sits in: a device, an image, or native geometry; the family names are carrier and field, direction and sequence, grouping and ownership, emphasis and annotation. `data-pptx-carrier` is a structured-slot attribute, not this term. The **carrier receipt** is the checker's per-page inventory of what was actually drawn | | **Page job** | What one page must do for the reader; the input every carrier, contour, and effect decision is judged against | | **Page field** | One large surface, outline, aperture, or off-canvas contour that organizes zones instead of a card per unit | | **Contour / preset / atom** | A contour is a shape's silhouette; a preset is one of the 187 Office `prst` contours drawn through `preset_shape_svg.py`; an atom is one object that compiles to one DrawingML shape | | **Geometry signature** | The retained line `page job → composition move → contour / edge language` kept per page and compared before the next page | | **Texture** (of a block) | Whether a §IX block is prose, bul