PPT Deliverable#

Use this skill when the final output should be a PowerPoint artifact.

Best-fit cases#

• single-slide strip profile
• teaser or process letter deck
• refreshed deck after number changes
• customer or deal summary slides
• packaging analysis into presentation-ready pages

CN target pre-flight (MANDATORY when target is a Chinese-market entity)#

Before touching any pptxgenjs slide code, check whether the target company is a China-market entity. If the context mentions any of the following triggers:

• Market/regulator: 中国 / A股 / 港股 / 科创板 / 创业板 / 北交所 / 中概股 / H股 / 证监会 / 上交所 / 深交所 / 港交所
• Source systems: 巨潮资讯 / cninfo / Tushare / 天眼查 / 企查查
• Common China-market tickers: *.SH / *.SZ / *.BJ / *.HK

...then you MUST load and follow the cn-client-investigation skill before generating any slides. That skill enforces:

• Rule 1: write Chinese in UTF-8 literal, NEVER as \uXXXX escape sequences — MiniMax-M2.7 has documented character-level drift on long Chinese escapes (e.g. 寒武纪 → 宽厭谛79)
• Rule 2: for company names / section headers / financial line items / investment ratings, require the cn-lexicon.js literal dictionary instead of inline-typing Chinese
• Rule 3: cover pages use English 44pt as hero title + Chinese ≤28pt as subtitle (English ASCII has zero escape-typo risk)
• Rule 4: tier-ordered China-market data sources (Tushare / CNINFO / 交易所 / 天眼查 / FMP)
• Rule 5: every hard number in the analysis.md must have a matching row in data-provenance.md — verified via provenance_verify.py
• Rule 6: no fabrication on missing data — label "数据不可得" / "N/A" instead
• Rule 7: cn_typo_scan.py is a mandatory compile-time gate — your slides/compile.js must be based on references/compile_with_typo_gate.template.js.txt (strip the .txt suffix on copy) so a scan hit blocks the pptx from shipping

For non-CN targets, skip this pre-flight and use the regular ppt-deliverable routing below.

Tooling preference#

Route PPT generation through the host's MiniMax PPT stack. On macmini, that means:

• pptx-generator for create/read flows
• slide-making-skill for single-slide implementation details
• ppt-orchestra-skill for multi-slide planning
• ppt-editing-skill for editing existing decks safely

If that PPT stack is not exposed on the host, fall back to the standard pptx workflow already available in the environment.

Note on removed path (0.1.17) — versions 0.1.13 through 0.1.16 shipped an embedded aigroup-mdtopptx-mcp stdio server that converted markdown to .pptx via pptxgenjs with a banker template derived from the NVIDIA sample. In practice the MiniMax host PPT skill suite produces noticeably better banker decks, so 0.1.17 removed the embedded server to let routing converge on a single good path. Archive of the scripts/mdtopptx/ directory is retained in the repository for reference but is no longer registered in .mcp.json.

Do not treat shell discovery as the source of truth. Avoid which, PATH checks, or binary-name probes for PPT routing because these capabilities may exist only as host skills.

The core rule is:

• ship a real .pptx
• preserve template structure when one exists
• keep slides concise and presentation-native
• prefer editable text/table/chart objects over flattened screenshots

Preferred routing order:

1. host MiniMax PPT skills — pptx-generator, slide-making-skill, ppt-orchestra-skill, ppt-editing-skill
2. environment pptx fallback when the MiniMax stack is not exposed

CN exception (overrides order above): For any company matched by the CN pre-flight above, the pptxgenjs route ( slides/slide-NN.js + node slides/compile.js) is MANDATORY — not optional, not a fallback. The MiniMax PPT stack does not integrate the compile-time typo gate required by cn-client-investigation. Do NOT use python-pptx for slide generation under any circumstances; it produces unthemed white-background slides. See cn-client-investigation/SKILL.md Phase 4 for the required steps.

CN deck-numbers flow (v0.9.0+): Before writing slides/slide-NN.js, run extract_deck_numbers.py <deliverable_dir> to emit deck-numbers.json. Each slide module should import numbers from that lookup rather than re-typing values from analysis.md prose. slide_data_audit.py (Gate 2b) remains the post-compile enforcement — every number on a slide must map to a provenance row. Combined with raw_data_check.py (Gate 3c), this closes the loop raw-data/*.json → data-provenance.md → deck-numbers.json → slides/*.js → pptx.

Workflow#

Step 1: Decide whether this is create vs refresh#

Use the smallest path that matches the job:

• new deck / new slide
• refresh an existing deck
• fill a template

Step 2: Start from existing plugin skills#

Prefer these building blocks:

• strip-profile
• teaser
• pitch-deck
• deck-refresh
• process-letter
• competitive-analysis
• customer-analysis-pack

If the user already has source tables in Excel or text in Word/markdown, consume those as inputs rather than recreating the analysis.

If the source is already markdown or markdown-like analysis output, feed it to the host's MiniMax PPT skills ( pptx-generator / slide-making-skill) rather than trying to script the conversion manually — MiniMax preserves banker-style layout far better than a hand-rolled pptxgenjs pipeline.

Step 3: Build the deck#

Requirements:

• use real slide structure, not giant paragraph dumps
• keep numbers synced with underlying models
• match the provided template or established banker style
• use tables/charts where they communicate better than prose
• keep the output editable in PowerPoint / Keynote
• do not stop just because no same-named PPT executable exists in the shell

Step 4: Review before delivery#

Check:

• no text overflow
• slide titles are meaningful
• numbers and dates are internally consistent
• all placeholders are removed

If the user also needs a PDF review copy, generate the PPT first, then hand off to pdf-deliverable.

Output standard#

Deliver:

1. a .pptx
2. a quick description of slide coverage
3. any data points that still need verification before external use

Quality checklist#

• final artifact is a real .pptx
• the final artifact remains editable rather than being flattened into image-only slides
• slides are presentation-ready, not document pages pasted into PowerPoint
• formatting is consistent with the source template or banker style
• charts/tables reflect current numbers
• no placeholder or draft scaffolding remains