Presentation Router

Presentation Router

Overview

Pick exactly one upstream workflow before doing substantive presentation work. Prefer Presentations for premium narrative decks and prefer ppt-master for document-to-PPT pipelines, template replication, and locally scripted PPTX export.

Routing Rules

Read this file first. Then choose one path:

• Presentations Use the installed built-in Presentations skill from the current Codex environment.
• ppt-master Use the installed local ppt-master skill when it is present.

Do not run both full workflows by default. Use a hybrid flow only if the user explicitly asks for it.

Choose Presentations

Route to Presentations when the request is primarily about story quality, executive polish, design-system rigor, or beating a reference deck.

Strong indicators:

• board, investor, strategy, finance, product, operating review, or analytics deck
• "beat this reference deck", "做得高级一点", "更像咨询/投行/编辑部风格"
• native Google Slides delivery
• targeted edits inside an already curated executive deck
• cases where narrative, contact-sheet rhythm, and rendered QA matter more than bulk source conversion

When this path wins, read the Presentations skill and follow it end to end.

Choose ppt-master

Route to ppt-master when the request is primarily about turning source material into an editable PPTX through its local pipeline.

Strong indicators:

• convert PDF, DOCX, URL, Markdown, or mixed source files into slides
• "做成原生可编辑 PPTX", "根据这堆资料自动出 PPT"
• replicate or derive a template from an existing .pptx
• use live preview, browser annotations, animations, narration, or video export
• preserve a local scripted workflow with exported files under the project
• the user explicitly says ppt-master

When this path wins, read the installed ppt-master skill and follow its serial pipeline. If ppt-master is not installed in the current environment, stop and tell the user that this route is unavailable until the skill is installed.

Tie-Breakers

If both skills seem plausible, break ties in this order:

1. If the user explicitly names one skill, honor that choice.
2. If the user needs document-to-deck conversion or template replication, choose ppt-master.
3. If the user needs premium storytelling or to beat a strong reference, choose Presentations.
4. If the user needs native Google Slides as the final deliverable, choose Presentations.
5. If the request is still ambiguous, state the assumption in one short sentence and proceed with the more conservative fit.

Local Environment Notes

On Windows machines:

• Its Python commands in docs often use python3; use python here unless python3 is available.
• If GitHub downloads fail, prefer the domestic mirror https://atomgit.com/hugohe3/ppt-master.git.
• When installing Python packages for ppt-master, prefer a domestic PyPI mirror such as https://pypi.tuna.tsinghua.edu.cn/simple.

Response Pattern

Before entering the upstream workflow, briefly say which route you chose and why in one or two sentences. Then continue directly with the chosen skill instead of lingering in meta discussion.

Reference

See routing-matrix.md for a compact decision table and example requests.