Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

GordenPPTSkill Skill

Repository ↗

by GordenSun★ 4,1541 skills

Install

What it does

AI-friendly PPT builder skill: 17 hand-polished Chinese PPTX templates + non-destructive text-only editing tools (python-pptx based). Pick a template, write edits.json, build a real .pptx with the layout intact. Personal/research use only.

  • Connects Instruction files the AI reads
  • Account or key No key found in README or SKILL.md
  • Category Coding
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/gordensun-gordenpptskill.svg)](https://mcp.popnx.com/en/skills/gordensun-gordenpptskill)

Use together with

MCP servers that connect the AI to services for the same work

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

by morlutoWidely used↓ 388.7K/wk★ 468.8KUpdated 7 days ago

MCP · Connects a serviceRuns on your computer

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

by fallow-rsWidely used↓ 2.4M/wk★ 5.4KUpdated today

MCP · Connects a serviceRuns on your computer

Desktop Commander

MCP server for terminal commands, file operations, and process management

by wonderwhy-erWidely used↓ 740.3K/wk★ 10.4KUpdated yesterday

MCP · Connects a serviceRuns on your computer

Similar Skills

Same kind of work, ordered like the Skills list

Compared with similar ones
This one
GordenPPTSkill
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
MakerGordenSunmorlutomultica-aiGraphify-Labsharry0703
Skills11111
GitHub stars4,154468,733234,332150,287144,566
Last code changeJun 22, 2026Nov 19, 2026Apr 20, 2026Nov 18, 2026Nov 18, 2026
License–MIT–Apache-2.0MIT

1 skills (instruction sets) by GordenSun that an AI reads and follows · not an MCP server

How a Skill differs from MCP

MCP = the hands

Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.

Skill = the manual

A text file that teaches the AI how to do a task. It connects to nothing.

Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.

Works with

Not stated by the maker · SKILL.md skills work in apps that support Agent Skills, such as Claude Code, Codex and Cursor

Install

Is it safe?

  • Who made it

    GitHub account GordenSun (person), 13 years old

  • Use and upkeep

    ★ 4,154 stars · code last changed Jun 22, 2026

  • Any scripts?

    6 scripts that can run on a computer: scripts/apply_update.py, scripts/build_manifest.py, scripts/build_pptx.py, scripts/check_update.py and 2 more

  • Uses the internet?

    Scripts that go online: scripts/check_update.py, scripts/apply_update.py

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 7d4a61c (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

First: which AI do you use?

Pick your app and this page shows only how to install it there

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the gordenpptskill folder again. The ZIP must have a gorden-ppt-skill folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick gorden-ppt-skill.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Let Claude Code install it

Copy this sentence and paste it into a Claude Code chat

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.claude/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .claude/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Restart Claude Code, then type /GordenPPTSkill or ask for a matching task and Claude picks it up

Checked against official docs Nov 12, 2026 · Source: code.claude.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.claude/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.claude/skills/gordenpptskill
  3. Restart Claude Code, then type /GordenPPTSkill or ask for a matching task and Claude picks it up

Skills you install yourself work in the ChatGPT desktop app, Codex CLI and the Codex IDE extension · ChatGPT on the web and mobile cannot use skills you install yourself, only skills that come with a plugin from the directory

ChatGPT desktop app

The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills

Option 1Let ChatGPT install it

Open Codex in the ChatGPT desktop app and paste this sentence into the chat

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.agents/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .agents/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2Put the folder there yourself

Put the gorden-ppt-skill folder at ~/.agents/skills/gorden-ppt-skill

~ is your home folder ($HOME)

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.agents/skills/gordenpptskill

After installing

  • ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
  • To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
  • Codex picks up newly installed skills by itself; if one does not show up, restart Codex

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

ChatGPT on the web and mobile

Skills you install yourself do not work here; only skills that come with a plugin from the directory

To use this skill with ChatGPT, use the ChatGPT desktop app as above

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

Option 1Let Codex install it

Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.agents/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .agents/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.agents/skills/gordenpptskill
  3. Restart Codex, then ask for a matching task; Codex lists the skill

Option 1Let Cursor install it

Copy this sentence and paste it into a Cursor chat

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.cursor/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .cursor/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

In Cursor’s Agent chat, type / and pick GordenPPTSkill

Checked against official docs Nov 12, 2026 · Source: cursor.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.cursor/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.cursor/skills/gordenpptskill
  3. In Cursor’s Agent chat, type / and pick GordenPPTSkill

Option 1Let the AI install it

For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.claude/skills/gorden-ppt-skill (in Codex use ~/.agents/skills/gorden-ppt-skill, in Cursor ~/.cursor/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .claude/skills/gorden-ppt-skill; in Codex use .agents/skills/gorden-ppt-skill, in Cursor .cursor/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.

View on GitHub ↗

Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026

✓ Commands checked Nov 16, 2026

View the original SKILL.md

The text below comes from the maker’s repo, not from PopNx MCP

7,928 characters · Open the full file on GitHub

---
name: gorden-ppt-skill
description: >-
  用 21 套内置中文 PPT 模板(或用户自带的 .pptx 模板)生成与编辑 PowerPoint 演示文稿:只替换文字、不破坏原排版/配色/字号,内置按文本框尺寸的出框检测与同级标题字号一致校验;也支持完全原创的简洁版式。当用户要"做 / 生成 / 制作 / 编辑一份 PPT / 演示文稿 / 幻灯片 / .pptx",或需要工作汇报、年终与季度总结、述职竞聘、项目复盘、开题答辩、商务提案、教学课件、数据可视化等成品 PPTX 时使用。Use when the user wants to create or edit a PowerPoint / PPT / slides / .pptx deck, pick from built-in templates, or apply their own template without breaking the layout.
---

# gorden-ppt-skill

> **版本** 见同目录 [`VERSION`](./VERSION)。

---

## 🚨 启用本 Skill 后做的第一件事:跑一次自动更新

任何 AI 在本会话**第一次用到这个 Skill 时**,**必须**先把下面这条命令作为它的第一个 tool call:

```bash
python3 scripts/apply_update.py
```

这条命令会自动:
1. 从远端 `update_source`(git+ 仓库)拉取最新 `updates.json`
2. 比对本地 `VERSION` 与远端 `latest_version`
3. 如果有新版本 → 只下载真正变动的文件(增量更新,无 LFS 流量浪费)
4. 如果已是最新 → 几秒内退出,输出 `OK   Nothing to do`

⚠️ 本 Skill **不会自动 push 更新**,必须由 AI 主动 pull。如果跳过这一步,可能在用过期版本,行为、规则、模板都可能与文档不符。

✅ 同一会话内只需做一次,后续 tool call 不必重复检查。

---

> **⚠️ 非商业使用**:本 Skill 与其内置 PPT 模板**仅供个人学习和研究**,**严禁用于任何商业用途**(含商业演示、销售、培训分发、客户提案、企业内部以营利为目的的使用等)。模板素材来自第三方设计师作品,二次商用需要获取原作者授权。

## 何时使用本 Skill

当用户的需求满足下列任何一项就调用本 Skill:

- 需要"做一份 PPT / 演示文稿 / 幻灯片",无论是工作汇报、年终总结、季度复盘、项目提案、述职竞聘、教学课件、开题答辩、读书报告……
- 用户给了文字大纲或一段描述,希望"做成 PPT"
- 用户拿来一份 .pptx 文件,希望"按这个模板做一份新的"
- 用户希望"调整 / 编辑 PPT 的某些文字",且要求"不破坏排版"
- 用户希望对比多个 PPT 模板,选一个合适的

## 更新机制说明

完整的更新工具有两个脚本:

| 脚本 | 干嘛 | 何时用 |
|---|---|---|
| `scripts/apply_update.py` | **检查 + 应用**(一步到位) | **每次启用 Skill 第一件事**(见顶部红框) |
| `scripts/check_update.py` | 仅检查、不应用,列出会变的文件 | 当你只想预览改了什么、不想立即更新时 |

如果只想先看变化再决定要不要升级:

```bash
python3 scripts/check_update.py     # 列出 added / modified / removed
```

`updates.json` 的 `update_source` 已配置为 `git+https://github.com/GordenSun/GordenPPTSkill.git#main`,开箱即用,无需修改。

## 三种模式

收到用户需求后,先判断走哪种模式:

### 模式 A:从内置模板里挑

**默认走这条路。** 21 套内置模板覆盖了绝大多数中文场景。

1. **读 [`templates/INDEX.md`](./templates/INDEX.md)** ——一份精简清单,列出每套模板的风格、主色、适用场景、页数。
2. **匹配用户输入** —— 把用户描述(场景、风格关键词、所需页面类型、颜色偏好)和每个模板的 intro.md 对比。
3. **选模板的决策规则**:
   - **用户已明确指定模板** → 直接用。
   - **你高度确信只有 1 个模板最合适**(场景 + 风格 + 主色都强匹配,且明显优于其它)→ 可直接用,但开工前一句话告诉用户你选了哪个、为什么,给用户一个否决的机会。
   - **其余所有情况(用户没指定,或你不能完全把握哪个最合适)→ 必须让用户来选**:
     - 用 AskQuestion 提供 **正好 3 个**候选模板,每个附上一句话理由(风格 / 适用场景 / 页数),并**把对应的 `templates/<slug>/preview.png` 一并展示**给用户看图决策。
     - 选项里**始终额外带一个「都不满意,换一批」**。用户选它时,再按匹配度给出**另外 3 个**没出现过的候选(同样附预览图)。可反复换,直到用户选定或候选用尽。
     - 候选都用尽仍不满意 → 询问用户更具体的偏好(风格 / 颜色 / 场景),或转模式 C 原创。
   - ⚠️ 不要在没让用户看预览图的情况下,仅凭模糊匹配就自作主张定一个模板。
4. **拿到目标模板后**:
   - 读 `templates/<slug>/intro.md`(高度浓缩,告诉你这个模板的特性)
   - 读 `templates/<slug>/detail.json`(结构化数据,告诉你每页 / 每个文本位的细节)
   - 按 [模式 A 工作流](./references/workflow.md#mode-a) 选页、写 `edits.json`、跑 `build_pptx.py`

### 模式 B:用户自己带 PPT 模板

当用户提供了 .pptx 文件且明确希望以它作模板时:

1. 把用户的 pptx 当作"未知模板"
2. 用 `scripts/render_slides.py` 把每页渲染成 PNG,再用 `python-pptx` 现场探查每页的 shape / paragraph / run 结构(无需额外脚本)
3. 自己看每页(PNG + shape 输出):
   - 推断每页是什么角色(封面 / 目录 / 章节扉页 / 内容页 / 结束 / 模板宣传)
   - 推断每页适合放什么内容
   - 跳过模板宣传 / "稻壳儿" / 感谢下载 之类
4. 按 [模式 B 工作流](./references/custom-template-workflow.md) 用 explicit `address` 写 `edits.json` 选页 + 文字替换
5. **不要修改用户模板原文件**;所有改动写到新的 output.pptx

### 模式 C:完全原创(不基于任何模板)

当用户明确要求"原创设计 / 不用模板 / 简单干净的样式"时:

1. **创建尽量简洁的版式** —— 大量留白、对齐严格、装饰极少
2. 单页元素 ≤ 4 个,避免复杂图形 / 图标群组
3. 字体:英文 Arial / Helvetica;中文 微软雅黑 / 思源黑体;标题加粗即可
4. 主色 1 个 + 灰阶 + 白底;不要拼凑多种风格
5. 用 `python-pptx` 直接代码生成,参考 [`references/original-design-guide.md`](./references/original-design-guide.md)

## 编辑铁律(所有模式通用)

1. **不改排版** —— 只改文字。形状的位置、大小、颜色、字体、字号、行距,都不动。
2. **所有占位文字必须替换** —— 模板里的 "Question 1" / "Vivamus..." / "Key Words Here" / "项目名称" 等占位文本都必须用真实内容替换。一份完成的 PPT 里不应出现任何示例占位词。
3. **`max_chars` 是软性参考,不是硬性上限;严禁用省略号截断** —— detail.json 每个 slot 的 `max_chars` / `chars_per_line` / `max_lines` 是按文本框尺寸估算的容量,**仅供参考**,帮助你把握"这格大概能放多少字"。
   - 优先写**自然、完整、精炼**的文字。略微超出通常没关系(容量已留 20% 余量,PPT 文本框本身也有弹性)。
   - **绝对禁止为了凑数而砍掉后半句、在结尾加 `...` / `…` / `等等` 来硬凑长度** —— 被省略号截断的半句话,比轻微超框难看得多,是最差的结果。
   - 真的太长时,按优先级处理:① 用更精炼的措辞**重写**(真正的概括,不是切断);② 减少要点条数 / 换一个空间更大的版式或页面;③ 实在不行,**宁可让它轻微超出一点,也不要出现省略号**。
   - `build_pptx.py` 的出框检测**只是提示、不阻断**保存。**日常不要加 `--strict`**(它会因超框拒绝保存,从而诱导截断)。`capacity_unknown:true` 的槽测不准,凭目测把握。
4. **数字 / 序号默认不动** —— `editable: false` 的 slot 是装饰性 "01/02/1/2/%" 之类,除非用户明确要求改顺序,否则保持。
5. **图形 / 图表通常无法同步** —— 装饰性的进度条 / 圆环 / 旗帜路径 / 流程箭头是固定形状;改了百分比文字不会改弧长。每个模板 detail.json 里如有这类页面会在 `cautions` 字段列出。
6. **真实数据图表才能改数据** —— 如果某页有 PPT 原生 chart(`shape.has_chart=True`),可以用 `build_pptx.py --chart-data` 同步更新;详见 [`references/chart-editing.md`](./references/chart-editing.md)。
7. **章节名前后呼应** —— 改了目录章节名,对应的分章扉页 + 内容页面包屑文字都要同步改。
8. **封面 / 致谢页按模板能力来,不要硬造** ——
   - 读 `detail.json` 的 `page_roles`,如果 `cover` 数组为空,**直接从第一张内容页开始**,不要拿一张内容页当封面用,更不要从其他模板临时凑一张封面页。
   - 如果 `ending` 数组为空,**直接以最后一张内容页收尾**,不要硬造"感谢聆听"。
   - 同理,`agenda` 空 → 不强加目录;`section_divider` 空 → 不强加分章扉页。
   - 也就是说:**模板有什么角色就用什么角色**,少一个角色就少一页,不要破坏视觉一致性去拼凑。这条规则在 v1.0.3 起对所有模板生效。
9. **同级标题字号必须一致,不要逐处改字号** ——
   - detail.json 顶部有 `type_scale`(字号层级表,level 1 = 最大),每个 slot 标了 `level`。**同一 level 的文字保持模板原字号,不要改字号。**
   - 某处文字偏长时,用**更精炼的措辞重写**来控制长度(见第 3 条),**不要把这一处字号改小**(会破坏同级一致),**也不要截断加省略号**。
   - 选多页拼一份 PPT 时,让各页同 level 的标题用词长度相近,整体才齐整。

## 标准工作流(模式 A)

```bash
# 1. 从 templates/INDEX.md 选定一个模板,例如 minimal-business-summary
TEMPLATE=templates/minimal-business-summary

# 2. 读两个文件
#    - $TEMPLATE/intro.md     -> 模板风格 / 适用场景 / 结构概述
#    - $TEMPLATE/detail.json  -> 每页 / 每个文本位的详细描述

# 3. 自己决定要用哪些页(用 detail.json 的 page.role 和 use_for)
#    生成 edits.json:
#    {
#      "template_slug": "minimal-business-summary",
#      "selected_slides": [1, 2, 3, 5, 7, 9, 10, 12, 13, 14, 16],
#      "edits": [
#        {"slide": 1, "slot_id": "cover_title_cn", "new_text": "2026 年度复盘"},
#        ...
#      ]
#    }

# 4. 跑构建(不要加 --strict:出框检测只作提示,不应阻断;超框宁可轻微超出也别截断加省略号)
python3 scripts/build_pptx.py \
    $TEMPLATE/template.pptx \
    edits.json \
    out/final.pptx \
    --detail $TEMPLATE/detail.json

# 5. (可选)渲染最终 pptx 给用户预览 / 自检(每页一张 PNG)
python3 scripts/render_slides.py out/final.pptx out/renders --dpi 144
```

## 目录结构

```
GordenPPTSkill/
├── SKILL.md               ← 本文件
├── VERSION                ← 当前版本号
├── CHANGELOG.md           ← 人类可读变更日志
├── updates.json           ← 机器可读版本增量索引
├── manifest.json          ← 所有文件的 sha256 与版本归属
├── README.md              ← 仓库概览(用户阅读)
├── scripts/
│   ├── build_pptx.py          # 按 edits.json 选页 + 换字 → 输出 pptx(含出框检测)
│   ├── render_slides.py       # pptx → PDF → 每页 PNG(预览/自检)
│   ├── compute_capacity.py    # 由 template.pptx 计算每个 slot 的容量字段(数据准备)
│   ├── check_update.py        # 检查远端是否有更新
│   ├── apply_update.py        # 增量更新本地文件
│   └── build_manifest.py      # 重建 manifest.json
├── references/
│   ├── workflow.md
│   ├── pptx-edit-schema.md
│   ├── custom-template-workflow.md
│   ├── chart-editing.md
│   └── original-design-guide.md
└── templates/
    ├── INDEX.md
    └── <slug>/
        ├── template.pptx
        ├── intro.md       # 高度浓缩简介
        ├── detail.json    # 详细页面 / slot 数据(含容量字段 + type_scale)
        └── preview.png    # 4 页 2×2 拼接预览图
```

## 关键脚本一句话说明

| 脚本 | 干嘛用 |
|---|---|
| `build_pptx.py` | 按 `edits.json`(选页 + 文字替换)从模板生成最终 pptx;带出框检测,`--strict` 时出框拒绝保存 |
| `render_slides.py` | 把任意 pptx 渲染成每页一张 PNG(用 LibreOffice + pdftoppm),用于预览 / 自检 |
| `compute_capacity.py` | 由 template.pptx 算出每个 slot 的 `chars_per_line/max_lines/max_chars` 等容量字段(自带模板已算好,仅在加新模板时需要) |
| `check_update.py` | 对比本地 VERSION 和远端 updates.json,告诉你要不要更新 |
| `apply_update.py` | 按 updates.json 的 delta 列表只下载变动文件 |
| `build_manifest.py` | 重新计算 manifest.json |

## 字体说明

模板 XML 里大量使用 `微软雅黑`。如果运行环境没有该字体,配合 `~/.config/fontconfig/fonts.conf` 把它别名到本地已安装的字体(推荐顺序:WenQuanYi Micro Hei → DengXian → Noto Sans SC → PingFang SC)。预览图正是用这条 fallback 链渲染的。

最终交给用户的 .pptx 在 PowerPoint / WPS / Keynote 里打开时会自动用宿主机的字体渲染,因此不需要担心字体丢失问题。

## 一些常见误区

- **不要**只改文字不改章节名一致性 —— 改 agenda 必须同步改分章扉页
- **不要**在装饰图上加文字以为是真图表
- **不要**把 lorem ipsum 留在最终 PPT 里
- **不要**为了塞下文字而忽略 `max_chars`
- **不要**修改用户原始模板文件 —— 所有产出都到新文件
- **不要**用本 Skill 做商业项目 —— 见顶部声明

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

From GitHub

GitHub stars
4,154
Maker
GordenSun
License
No license stated This repo states no license. By default the author keeps all rights: ask before you share it or use it commercially.
Last code change
Jun 22, 2026
SKILL.md files in the repo (including translated copies and templates)
1