Metro Presentation Toolkit

A portable Codex marketplace bundle for building formal Chinese PowerPoint decks in rail-transit, higher-education, public-institution, and review-defense scenarios.

This repository packages reusable Codex skills for a two-stage PPT workflow:

1. Plan a dense, source-grounded presentation and generate approved visual targets.
2. Reconstruct those targets into editable PowerPoint objects instead of shipping whole-slide screenshots.

What Is Included

.agents/plugins/marketplace.json
plugins/metro-presentation-toolkit/

The plugin contains two skills:

• metro-presentation-style: creates high-density Chinese deck outlines, style blueprints, imagegen prompt packs, and task workspaces for formal metro/public-institution presentations.
• ppt-visual-replica: rebuilds approved reference images as editable PowerPoint slides through minimum-semantic-unit decomposition.

Use Cases

• Shanghai metro or urban rail project presentations
• University-industry collaboration defense decks
• Municipal review, acceptance, and demonstration-center reports
• Dense Chinese evidence decks with diagrams, timelines, tables, charts, and photo proof
• Image-to-editable-PPT reconstruction when a flat reference image should become selectable PowerPoint objects

Installation

Clone the repository:

git clone https://github.com/eatid/metro-presentation-toolkit-marketplace.git
cd metro-presentation-toolkit-marketplace

Register the marketplace and install the plugin:

codex plugin marketplace add "$(pwd)"
codex plugin add metro-presentation-toolkit@metro-presentation-toolkit

Start a new Codex thread after installation so the bundled skills are loaded.

Quick Start

Ask Codex in Chinese or English:

按轨交汇报风格，把这些材料做成一套可编辑 PPT。

Other useful prompts:

为这份答辩材料生成高密度 PPT 大纲。
把这张参考图重构成可编辑 PowerPoint。
按市级示范中心验收答辩风格改造这套 PPT。

Expected Workflow

The metro-presentation-style skill expects each real PPT task to use a fresh project folder in the current workspace:

<current-workspace>/<date_task_name>/
  资料/
  大纲/
  图片/来源图片/
  图片/视觉目标/
  图片/生成素材/
  资产/
  PPT/
  渲染/
  报告/
  报告/ppt-visual-replica/
  日志/
  脚本/

A typical run produces:

• 大纲/deck-outline.json
• 大纲/style-blueprint.md
• 大纲/slide-briefs.json
• 图片/生成素材/deck_background_base.png
• 图片/视觉目标/slideNN_visual_target.png
• 报告/ppt-visual-replica-decomposition.json
• PPT/*.pptx

Design Principles

• Keep final PPT text, charts, tables, and diagrams editable.
• Treat generated full-slide images as visual targets, not final bitmap slides.
• Use source materials and approved slide copy as the only authority for readable final text.
• Preserve real user-provided evidence assets; do not fabricate certificates, screenshots, logos, or factual proof.
• Use a formal Chinese reporting style rather than a generic startup or consulting deck style.

What Is Not Included

This public package intentionally excludes:

• private historical PPTX samples;
• task-specific generated outputs;
• local backups and temporary files;
• .DS_Store, caches, credentials, and local machine paths.

Bring current-task materials into the task workspace when using the skill.

Repository Layout

plugins/metro-presentation-toolkit/
  .codex-plugin/plugin.json
  skills/
    metro-presentation-style/
      SKILL.md
      references/
      plans/
      scripts/
      examples/
      templates/
    ppt-visual-replica/
      SKILL.md
      scripts/

Updating

Pull the latest changes and reinstall the plugin:

git pull
codex plugin add metro-presentation-toolkit@metro-presentation-toolkit

Then start a new Codex thread.

Notes

• $imagegen is the normal image-generation path when available in Codex.
• The skills may ask for user confirmation before reconstructing a deck when generated visual targets define the deck look.
• No open-source license file is included yet; treat reuse rights as reserved unless a license is added later.