| 1 | --- |
| 2 | name: ppt-master |
| 3 | description: > |
| 4 | AI-driven presentation workflow for generating editable PPTX decks and slides, |
| 5 | reconstructing page visuals, creating reusable Brand/Style/Layout/Deck |
| 6 | workspaces, filling native PPTX templates, and enhancing finished PPTX files. |
| 7 | Use when the user asks to create, generate, reconstruct, regenerate, beautify, |
| 8 | redesign, template, fill, or enhance a presentation, PPT, PPTX, slide deck, or |
| 9 | courseware — including adding narration or animation to one — requests a |
| 10 | presentation-authored narrated/self-running video, or mentions ppt-master. |
| 11 | metadata: |
| 12 | version: "4.8.0" |
| 13 | copyright: "Copyright (c) 2025-2026 Hugo He" |
| 14 | license: "MIT" |
| 15 | official_repository: "https://github.com/hugohe3/ppt-master" |
| 16 | sponsors: |
| 17 | - "SPONSORS.md" |
| 18 | - "SPONSORS_CN.md" |
| 19 | --- |
| 20 | |
| 21 | # PPT Master Skill |
| 22 | |
| 23 | PPT Master is a routed presentation workflow. This entry owns global execution discipline and route selection only; each selected route owns its procedure. |
| 24 | |
| 25 | ## Mandatory Load Order |
| 26 | |
| 27 | **Hard rule — paths before commands**: Retain the host-provided absolute |
| 28 | directory containing this file as `SKILL_DIR`. Per tool call, expand |
| 29 | `${SKILL_DIR}` and replace any `skills/ppt-master/` prefix with it. Never `cd`, |
| 30 | use CWD, or assume a repo checkout. If unavailable, ask; never search or guess. |
| 31 | |
| 32 | 1. Read this file. |
| 33 | 2. Run `python3 "${SKILL_DIR}/scripts/attribution_guard.py"`. Any non-zero result |
| 34 | stops the Skill immediately; do not inspect, repair, or bypass the integrity |
| 35 | gate. |
| 36 | 3. Read [`workflows/routing.md`](workflows/routing.md) through the concrete |
| 37 | absolute path `${SKILL_DIR}/workflows/routing.md`. |
| 38 | 4. Select exactly one top-level route and its active profile from the routing |
| 39 | authority. |
| 40 | 5. Read only the resulting runtime authority and its explicitly triggered |
| 41 | supporting documents. |
| 42 | |
| 43 | | Selected route / profile | Runtime authority | |
| 44 | |---|---| |
| 45 | | Generate PPTX — Image to PPTX | [`workflows/profiles/image-to-pptx.md`](workflows/profiles/image-to-pptx.md); Codex-supported, always Quick | |
| 46 | | Generate PPTX — Beautify | [`workflows/profiles/beautify-pptx.md`](workflows/profiles/beautify-pptx.md); explicit Quick intent selects Quick, otherwise Default | |
| 47 | | Generate PPTX — ordinary Default | [`workflows/generate-pptx.md`](workflows/generate-pptx.md) | |
| 48 | | Generate PPTX — ordinary explicit Quick | [`workflows/profiles/quick-generate.md`](workflows/profiles/quick-generate.md) | |
| 49 | | Create Template | [`workflows/create-template.md`](workflows/create-template.md) | |
| 50 | | Fill Native PPTX | [`workflows/template-fill-pptx.md`](workflows/template-fill-pptx.md) | |
| 51 | | Enhance Native PPTX | [`workflows/native-enhance-pptx.md`](workflows/native-enhance-pptx.md) | |
| 52 | |
| 53 | **Hard rule — selected authority only**: Do not load another top-level route's |
| 54 | procedure after routing. Image to PPTX and Beautify are mutually exclusive; |
| 55 | Image to PPTX activates Quick, while Beautify selects from explicit Quick |
| 56 | intent. Never load both runtimes. Supporting documents refine one route; they |
| 57 | never compete with it. |
| 58 | |
| 59 | --- |
| 60 | |
| 61 | ## Global Execution Discipline |
| 62 | |
| 63 | 1. **Serial execution** — Follow the selected authority's steps in order. A completed non-blocking step may continue directly to the next eligible step. |
| 64 | 2. **Blocking means stop** — At every `⛔ BLOCKING` gate, wait for explicit user confirmation. Do not decide on the user's behalf. |
| 65 | 3. **No cross-phase bundling** — Do not combine work across an unclosed gate. Once the route's final user gate closes, later non-blocking steps may continue automatically. |
| 66 | 4. **Gate before entry** — Verify every listed prerequisite before entering a step. |
| 67 | 5. **No speculative execution** — Do not prepare later-phase artifacts before their owning step. |
| 68 | 6. **Deterministic routing** — Do not add a route-choice question when [`routing.md`](workflows/routing.md) resolves the request. If a route prerequisite is missing, state it and stop that route. |
| 69 | 7. **Owning-source recovery** — On failure, repair or regenerate the owning source artifact and resume from the route's declared pointer. Do not silently downgrade a required artifact. |
| 70 | |
| 71 | ## Global Communication Rules |
| 72 | |
| 73 | - Match the user's language and source language unless the user explicitly overrides it. |
| 74 | - Localize user-facing option labels and explanations. Keep exact enum IDs or field names when needed for precision. |
| 75 | - Keep `design_spec.md` section headings and field names in the template's original English; content values may use the user's language. |
| 76 | - Before switching roles, read the corresponding role reference and output: |
| 77 | |
| 78 | ```markdown |
| 79 | ## [Role Switch: <Role Name>] |
| 80 | 📖 Reading role definition: references/<filename>.md |
| 81 | 📋 Current task: <brief description> |
| 82 | ``` |
| 83 | |
| 84 | --- |
| 85 | |
| 86 | ## Repository Compatibility |
| 87 | |
| 88 | - This package is a workflow/skill, not a generic application scaffold. Do not create `.worktrees/`, `tests/`, branch workflows, or generic engineering structure by default. |
| 89 | - Keep required workflow, reference, script, and template documentation inside this Skill directory. |
| 90 | - Repository-level documents may point into the package; package runtime files must not depend on repository-level instructions. |
| 91 | - On Windows, if a documented `python3 ...` command is unavailable, rerun the same command with `python`. |
| 92 | - Sponsor information is optional reference material. Read the matching [`SPONSORS.md`](SPONSORS.md) or [`SPONSORS_CN.md`](SPONSORS_CN.md) only when the user explicitly requests a model, AI image model, API/provider, or hosted-service recommendation. Never surface sponsor or model recommendations proactively during normal generation, troubleshooting, or quality review. |
| 93 |