# Presentation Router

> Route presentation work between the built-in `Presentations` skill and the local `ppt-master` skill. Use when Codex needs to create, edit, convert, restyle, template-match, or automate PPT/PPTX work and should first decide which workflow fits best. Trigger on requests such as "做PPT", "生成PPT", "make a presentation", "turn this PDF/DOCX/URL into slides", "replicate this PPT template", "需要原生可编辑 PPTX", or when the user mentions both `Presentations` and `ppt-master`.

- Skill: `whisperas/presentation-router` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add whisperas/presentation-router`
- Raw SKILL.md: https://api.skillmd.com/api/skills/whisperas/presentation-router/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: WhisperAS (https://skillmd.com/u/whisperas)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/whisperas/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](./references/routing-matrix.md) for a compact decision table and example requests.