AGENT SKILL

ppt-master

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.

License 许可
MIT
最近更新
2026-11-06
Stars
★ 0
Forks
0

01 前言 Front Matter

name
ppt-master
metadata
{ "license": "MIT", "version": "5.1.0", "sponsors": [ "SPONSORS.md", "SPONSORS_CN.md" ], "copyright": "Copyright (c) 2025-2026 Hugo He", "official_repository": "https://github.com/hugohe3/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.

02 资源文件 500

03 SKILL.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 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; Codex-supported, always Quick
Generate PPTX — Beautify workflows/profiles/beautify-pptx.md; explicit Quick intent selects Quick, otherwise Default
Generate PPTX — ordinary Default workflows/generate-pptx.md
Generate PPTX — ordinary explicit Quick workflows/profiles/quick-generate.md
Create Template workflows/create-template.md
Edit Native PPTX 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.


Global Execution Discipline

  1. Serial execution — Follow the selected authority's steps in order. A completed non-blocking step may continue directly to the next eligible step.
  2. Blocking means stop — At every ⛔ BLOCKING gate, wait for explicit user confirmation. Do not decide on the user's behalf.
  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.
  4. Gate before entry — Verify every listed prerequisite before entering a step.
  5. No speculative execution — Do not prepare later-phase artifacts before their owning step.
  6. Deterministic routing — Do not add a route-choice question when routing.md resolves the request. If a route prerequisite is missing, state it and stop that route.
  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.

Global Communication Rules

  • Match the user's language and source language unless the user explicitly overrides it.
  • Localize user-facing option labels and explanations. Keep exact enum IDs or field names when needed for precision.
  • Keep design_spec.md section headings and field names in the template's original English; content values may use the user's language.
  • Before switching roles, read the corresponding role reference and output:
## [Role Switch: <Role Name>]
📖 Reading role definition: references/<filename>.md
📋 Current task: <brief description>

Repository Compatibility

  • This package is a workflow/skill, not a generic application scaffold. Do not create .worktrees/, tests/, branch workflows, or generic engineering structure by default.
  • Keep required workflow, reference, script, and template documentation inside this Skill directory.
  • Repository-level documents may point into the package; package runtime files must not depend on repository-level instructions.
  • On Windows, if a documented python3 ... command is unavailable, rerun the same command with python.
  • Sponsor information is optional reference material. Read the matching SPONSORS.md or 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.

04 同仓库更多 Skills