Local-first + quality-checked delivery for Chinese office users: turn PDFs, Word docs, PPTX decks, spreadsheets, URLs, and rough notes into Agent-ready presentation projects, then produce editable PowerPoint decks or magazine-style Web Decks locally.
v2.5.0 · English · 中文 README · Docs · Agent Bridge · Agent Skill
Open Web Experience · Benchmark Wall · Quality Workbench · Skill Market · Completion Audit
v2.5.0 Notes · 60-second quickstart · Use as Agent Skill · Discussions
For a first run, copy this and keep every source file on your own machine:
git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git
cd ultimate-ppt-master-skill
npm run setup
npm run doctor
npm run bridgeThen open the Web Experience and choose the route that matches how much local setup you want today.
| Mode | What to do first | What you get |
|---|---|---|
| No Bridge | Open public demos and the Benchmark Wall. | See real synthetic cases, covers, sources, and quality reports before installing anything. |
| Bridge online | Pick a Chinese office preset, paste a goal or upload local files, then click Send to Bridge. | A local handoff folder with the brief, source material, manifest, preview, quality checklist, quality-report.json, and Agent commands. |
First click path:
| Step | Click or action | Result |
|---|---|---|
| 1 | Open Web Experience | Start from the product UI instead of reading architecture first. |
| 2 | Choose a preset | Select business review, consulting, training/defense, pitch, or trend deck. |
| 3 | Paste a goal or add files | Keep source material local and make the task explicit. |
| 4 | Send to Bridge | Write a local handoff contract when the connector is running. |
| 5 | Hand off to Agent | Let Codex, Claude Code, Hermes, OpenClaw, or another local agent produce and review. |
| First scenario | Best default |
|---|---|
| Business review, weekly update, monthly report, or quarterly review | Executive Business Review |
| Consulting proposal, client recommendation, diagnosis, or decision memo | Consulting Proposal |
| Training courseware or academic defense | Training Courseware / Academic Defense |
| Product pitch or tech trend showcase | Product Pitch / Tech Trend Web Deck |
These are public synthetic proof packs: input source, selected preset, generated output, screenshot cover, and quality report are all committed so users can judge the workflow before installing anything.
| Case | Fits | Proof |
|---|---|---|
| Executive Business Review | Operations review, CEO/department update, KPI story | Demo · Source · Quality report |
| Consulting Proposal | Client diagnosis, transformation proposal, decision memo | Demo · Source · Quality report |
| Product Pitch | Launch story, demo day, stakeholder buy-in | Demo · Source · Quality report |
| Tech Trend Web Deck | Public trend briefing, conference talk, thought leadership | Demo · Source · Quality report |
| If you need... | Ultimate PPT Master gives you... |
|---|---|
| An AI presentation generator that does not hide your source files | A local-first Web Experience plus Bridge handoff folder. |
| Editable PowerPoint output, not screenshots pasted into slides | A PPTX-oriented Agent Skill path with quality checks. |
| Better first drafts from messy PDFs, Word docs, PPTX, URLs, and notes | Stable packs, source skeletons, manifests, QA checklists, and quality reports. |
| Web-native, magazine-style decks for demos or reports | A Web Deck route with browser previews and shareable HTML output. |
Ultimate PPT Master is a local-first AI presentation hub. It gives non-technical users a friendly web page, then gives power users a real local handoff folder that Codex, Claude Code, Hermes, OpenClaw, or another agent can continue from.
It is designed as a practical fusion layer around two strong routes:
- the editable PPTX route inspired by Hugo He's PPT Master direction;
- the high-impact single-file Web Deck route inspired by op7418 / Guizang-style presentation skills.
The goal is simple: the web page should make the workflow easy to understand; the local Skill should keep the production quality high.
v2.5.0 turns Ultimate PPT Master into a PPT quality workbench for Chinese office users. It keeps the local-first Web + Bridge + Skill architecture and improves first use, preset quality, visual review, sample proof, and delivery gates.
This release focuses on practical office delivery:
- Business Review and Consulting Proposal stay as the first default paths; Training Courseware and Academic Defense move ahead of showcase decks in the Web preset menu.
- Stable packs now declare
userLevel,qualityProfile,proofArtifacts, andnotForso users can see who a preset is for and where it does not fit. - Design Doctor makes visual review understandable: SVG checks, browser review,
workflows/visual-review.md,quality-report.json, and a Chinese summary are part of the handoff contract. - Bridge / handoff kits now preserve
qualityProfile,expectedArtifacts, andreviewCommandsinmanifest.jsonandproject-brief.json. scripts/audit_quality_proofs.pyverifies stable proof artifacts before publishing.
- The web page is no longer just a form. The first screen now shows the current task, next step, quality status, and delivery gates.
- Presets are no longer vague examples. A stable pack must have a public synthetic source, generated output, screenshot, quality report, and suitability boundary.
- The Agent gets more than a prompt. It receives a contract that says what should be produced and how to check it.
- Design Doctor reports first and repairs only when the user explicitly asks.
The public proof surface is now a product feature, not a footnote. Open the Benchmark Wall to see the current "input -> preset -> output -> review" chain before you run the project locally.
Each proof pack includes:
source.sanitized.md: synthetic source material that can be inspected publicly;- generated demo output: Web Deck or starter output for the selected preset;
- screenshot or cover asset for quick visual judgment;
quality-report.json: machine-readable review result;- Design Doctor scorecard: report-only visual review with recommended fixes.
Design Doctor is intentionally report-first. It combines SVG checks, browser visual review, workflows/visual-review.md, quality-report.json, and a plain-language summary; automatic SVG repair only happens when the user explicitly asks for it.
Read the benchmark note: Quality Workbench v2.5. Review the completion evidence: Completion Audit. Preset catalog: templates/presets.
The next growth path is not only GitHub Pages. The repository is now ready to be described as an installable Agent Skill instead of only a code repo.
Marketplace distribution assets:
agents/openai.yaml: OpenAI/Codex-style skill metadata and invocation examples;agents/marketplace-listing.json: structured listing contract for marketplace review;assets/skill-market/*: icon and card artwork for listing surfaces;- public benchmark packs: proof that the skill can produce quality-checked outputs;
npm run audit:market: machine check for marketplace metadata, links, and assets.
Copyable marketplace prompt:
Use $ultimate-ppt-master to turn my source material into a quality-checked PPTX or Web Deck with a visual review report.
Read the checklist: Skill Market Distribution. Chinese checklist: Skill 市场分发.
You can. For expert users, direct Skill install is still the fastest path.
Ultimate PPT Master exists for the moment before that: when the user has files, a rough goal, uncertain model setup, and no clear idea whether the job should become editable PPTX, a Web Deck, or both.
The product adds value by:
- turning a vague request into a structured brief;
- packaging real source files into a local handoff folder;
- showing Bridge, Agent, and provider readiness before production;
- generating an engine plan, quality checklist, and quality report;
- preserving the original upstream quality routes instead of replacing them with a weaker web-only generator.
Read the deeper positioning note: Product Positioning.
This project is moving quickly. If you already installed it, update before producing serious client or team-facing material.
Update a local clone:
cd ultimate-ppt-master-skill
npm run updateUpdate the Codex Skill install:
bash -lc 'set -e; dir="$HOME/.codex/skills/ultimate-ppt-master"; if [ -d "$dir/.git" ]; then git -C "$dir" pull --ff-only; else git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git "$dir"; fi; cd "$dir"; npm run setup'Update a generic Agent Skill install:
bash -lc 'set -e; dir="$HOME/agent-skills/ultimate-ppt-master"; if [ -d "$dir/.git" ]; then git -C "$dir" pull --ff-only; else mkdir -p "$HOME/agent-skills"; git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git "$dir"; fi; cd "$dir"; npm run setup'Or ask Codex:
Update ~/.codex/skills/ultimate-ppt-master to the latest GitHub version, run npm run setup, then use the README demo to confirm it works.
This public sample shows what users should provide and what they get back:
| What you provide | What it produces |
|---|---|
A sanitized source.md with topic, public references, narrative, slide outline, and constraints. |
A self-contained Web Deck plus a handoff structure that a local Agent can continue into PPTX / Web Deck production. |
| A clear Agent prompt with audience, output route, and quality requirements. | Reproducible production files such as agent-prompt.md, engine-plan.md, and quality-checklist.md. |
Input material excerpt:
Topic: Agentic Developer Stack 2026
Goal: use a non-sensitive tech trend to explain why the web page is the front door and the Skill is the production engine.
Sources: Google I/O 2026 developer highlights, Google Developers Blog, and public technology coverage.
Output: an 11-slide magazine-style Web Deck, with a handoff path ready for editable PPTX production.
Example Agent prompt:
Use $ultimate-ppt-master with examples/agentic-developer-tools-2026/source.sanitized.md.
Create a polished magazine-style Web Deck for GitHub Pages and keep the handoff ready for an editable PPTX route.
Verify layout, mobile readability, source references, and final exported files before delivery.
Open the full sample:
The Web Experience is the public front door. It can run from GitHub Pages without a backend, account, model host, or API key storage.
It helps users:
- import
.md,.txt,.pdf,.docx,.pptx,.xlsx, URLs, or pasted text; - choose scenario, audience, output route, style, language, target agent, and model preference;
- see whether each source is browser-readable, locally parsed, or preserved as an attachment;
- generate an Agent handoff prompt and download a
source.mdtemplate; - preview a rough
preview-web-deck.html; - download
handoff-kit.zipwhen Bridge is offline; - send the same project to the local Bridge when Bridge is online;
- jump directly to Skill installation instructions.
Open it here:
https://kdnsna.github.io/ultimate-ppt-master-skill/
For local web development:
npm --prefix apps/web install
npm run dev:webBuild the GitHub Pages artifact:
npm run build:webBridge turns the static web page into a local production console.
git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git
cd ultimate-ppt-master-skill
npm run setup
npm run bridgeBridge writes handoff projects under:
~/UltimatePPTMaster/handoffs/
Safety defaults:
- binds only to
127.0.0.1; - reads provider config from environment variables, repo
.env, or~/.ppt-master/.env; - returns provider readiness and model names, never API key values;
- parses source files locally through
scripts/source_to_md/*; - does not launch an Agent unless you explicitly opt in.
Optional advanced launch mode:
npm run bridge -- --allow-launchFull guide: Agent Connect Bridge.
Every handoff project is meant to be understandable by both humans and agents:
source.md: clean fallback source;extracted-source.md: locally parsed source text when available;attachments/: original files preserved for the Agent;manifest.json: parse status, source metadata, and suggested commands;agent-prompt.md: ready-to-copy Agent prompt;project-brief.json: structured scenario, audience, style, and output settings;engine-plan.md: PPTX / Web Deck production plan;quality-checklist.md: review checklist before final delivery;quality-report.json: Design Doctor and delivery-gate result;preview-web-deck.html: browser-local rough preview;README.md: handoff folder instructions.
Use the Skill route when quality matters more than the fastest first click. This is the route for Codex, Claude Code, Hermes, OpenClaw, Cursor-style IDEs, and other local agents that can read files and run scripts.
git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git ~/.codex/skills/ultimate-ppt-master
cd ~/.codex/skills/ultimate-ppt-master
npm run setupAsk:
Use $ultimate-ppt-master to turn reports/q3-review.pdf into a 12-slide editable PPTX for an executive meeting. Verify the deck before delivery.
mkdir -p ~/agent-skills
git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git ~/agent-skills/ultimate-ppt-master
cd ~/agent-skills/ultimate-ppt-master
npm run setupAgent prompt:
Read ~/agent-skills/ultimate-ppt-master/AGENTS.md and follow SKILL.md.
Use that repository path as SKILL_DIR.
Turn the provided source material into an editable PPTX and preview the result before delivery.
Full guide: Agent Setup.
| Output | Best for | Production route |
|---|---|---|
Editable PowerPoint (.pptx) |
Business reports, consulting proposals, training decks, investor updates, and review-heavy work. | Agent Skill with local files, scripts, preview, repair, and export checks. |
Magazine Web Deck (index.html) |
Launches, demo days, product stories, keynotes, and visually rich sharing. | Web Experience preview first, then Skill for final polish and QA. |
| Agent Handoff Project | Users who already have Codex, Claude Code, Hermes, OpenClaw, Cursor, Cline, Roo, or Windsurf. | Bridge-generated folder or handoff-kit.zip. |
Public sanitized demos:
- Executive Business Review Starter
- Consulting Proposal Starter
- Product Pitch Starter
- Tech Trend Web Deck Starter
- Agentic Developer Stack 2026
- Desktop Cultural Tourism Demo
| Path | Use it when | Start |
|---|---|---|
| Open Web Experience | You want the fastest way to understand the project and build a prompt. | Open Web Experience |
| Web + Bridge | You want real file intake without uploading source material to a hosted service. | Run npm run bridge, then send from the web page. |
| Agent Skill | You already work inside Codex, Claude Code, Hermes, OpenClaw, Cursor, Cline, Roo, or Windsurf. | Agent Setup |
| Web + Skill | Recommended production flow: prepare the handoff kit visually, then let the agent finish it locally. | Use Web Experience, then Bridge or handoff-kit.zip. |
| Desktop Later | You want advanced local preview or future signed desktop packaging. | Quickstart Desktop |
The Tauri desktop app remains in apps/desktop, but it is no longer the first promotion path. Signing, notarization, Homebrew distribution, and native packaging are now release-maintenance work.
Developer preview:
git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git
cd ultimate-ppt-master-skill
npm run setup
npm run desktopMaintenance references:
| Need | Guide |
|---|---|
| Use the static online front door | Web Experience |
| Connect the web page to local files and Agents | Agent Connect Bridge |
| Install and invoke the Skill | Agent Setup |
| Pick Web vs Skill vs Desktop Later | Choosing a Workflow |
| Configure provider keys locally | Model and Provider Setup |
| Understand why this exists beside direct Skill install | Product Positioning |
| See the next content/template direction | Next Roadmap - Content and Template Presets |
| Review v2.5.0 release focus | Release Notes - v2.5.0 |
| Review the quality proof matrix | Quality Workbench v2.5 |
| Browse public proof packs | Benchmark Wall |
| Prepare marketplace or agent-directory distribution | Skill Market Distribution |
| Verify the v2.5 quality workbench is complete | Completion Audit |
| Review GitHub technology signals | GitHub Technology Scan - May 2026 |
| Review the local upstream benchmark | Upstream Benchmark - May 2026 |
| Debug setup, extraction, output, provider, Tauri, or agent loading issues | Troubleshooting |
| Release, Pages, Homebrew, signing, privacy, and maintenance | Release and Maintenance |
Maintainers should keep the README promise tied to executable checks:
npm run doctor
npm run audit:presets
npm run audit:quality
npm run audit:market
npm run test:node
npm run test:worker
npm run build:web
npm run build:desktop
git diff --checkThe latest push-prep pass also verified the Web homepage, Benchmark Wall, and four public proof decks at desktop and mobile widths.
- Reworked the Web first screen into a quality workbench with task preview, next step, and quality status.
- Promoted the four current packs to
stable-packwith quality metadata and proof artifacts. - Added Design Doctor entry points and
quality-report.jsonto handoff kits. - Added quality proof audit coverage with
npm run audit:quality. - Added marketplace readiness coverage with
npm run audit:market. - Strengthened Bridge manifest and project brief contracts for local Agent execution.
See UPSTREAM_SYNC.md for upstream baselines and adaptation policy.
AI presentation hub: source files in, local Agent handoff out, editable PPTX and magazine Web Decks delivered.
AI 演示生产中枢：资料进来，本地 Agent 接手，输出可编辑 PPTX / 杂志风网页演示。
MIT. See LICENSE.