skill
pptx-batch-editor
PowerPoint/PPTX batch multi-slide editor Skill for Codex & Claude: replace, align, resize, preserve templates, validate. PPT 批量多页修改、自动对齐与模板保真。
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/KayZhongyi/pptx-batch-editor itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 28, 2026PPTX Batch Editor
English
PPTX Batch Editor is a PowerPoint Skill for Codex and Claude. It is built for PPT/PPTX batch editing and consistent changes across multiple slides: inspect the deck, compile a validated recipe, apply the edits, and check the rendered result.
It is designed for editing existing presentations and building from a supplied PowerPoint template. It does not flatten editable slides into screenshots.
What It Handles
| Input | What it does | Result |
|---|---|---|
| Existing PPTX + edit request | Inventories objects, builds a recipe, applies and verifies batch edits | A new editable PPTX; the source is preserved |
| Finished template + new content or assets | Maps each output slide to a template slide and edits inherited objects | A new deck that keeps the template's visual system |
| PPTX + layout problems | Diagnoses alignment, spacing, overlap, and size outliers before editing | Corrected alignment, distribution, position, or size |
| Images + content only | Routes creation to the host presentation capability | Asset mapping, design rules, and QA checks |
Core Advantages
| Advantage | Why it matters |
|---|---|
| Multi-slide batch editing | Replace logos, titles, footers, images, or repeated objects without editing every slide by hand. |
| Template preservation | Reuse original slides, masters, layouts, charts, and editable objects instead of rebuilding a lookalike deck. |
| Controlled scope | Every operation uses a stable selector and an expected match count. Unexpected matches stop the operation. |
| Layout diagnostics | Detect near-misalignment, uneven spacing, overlap, and size outliers before applying a fix. |
| Asset fidelity | Keep logos, screenshots, evidence figures, and product images faithful to the supplied files. |
| Verification loop | Inventory before editing, render after editing, then check structure, crop, overflow, and overlap. |
| Reusable recipes | Revalidate and replay a successful edit on a newer version of the same deck. |
| Zero-dependency helpers | The bundled inspection and validation scripts use only the Python standard library. |
Quick Start
Codex:
git clone https://github.com/KayZhongyi/pptx-batch-editor.git
mkdir -p ~/.agents/skills
cp -R pptx-batch-editor/pptx-batch-editor ~/.agents/skills/pptx-batch-editor
Claude Code:
git clone https://github.com/KayZhongyi/pptx-batch-editor.git
mkdir -p ~/.claude/skills
cp -R pptx-batch-editor/pptx-batch-editor ~/.claude/skills/pptx-batch-editor
Claude web or Desktop: download and upload the universal ZIP.
Then describe the task:
Use /absolute/path/source.pptx:
1. Replace every confirmed old logo.
2. Left-align titles that use the same layout.
3. Preserve the source and write /absolute/path/updated.pptx.
4. Run structural and visual checks before delivery.
Runtime Modes
| Mode | Available capabilities |
|---|---|
| Codex or Claude with presentation support | Template-driven builds, object-level edits, asset placement, slide duplication, rendering, and visual QA |
| Standalone bundled scripts | Read-only inventory, geometry diagnostics, recipe validation, template-plan validation, and exact same-format repeated-image replacement |
Full editing uses the presentation capability available in Codex or Claude. In a local workflow, a working PowerPoint installation lets you open, review, and continue editing the output.
Safety Workflow
- Keep the source and output paths different.
- Inventory slides, layouts, masters, objects, and repeated media.
- Require a stable selector and
expected_matchesfor every operation. - Apply edits to a copy of the deck.
- Render and inspect every changed slide.
- Repair uncertain results or stop and report them.
Included Tools
| Tool | Purpose |
|---|---|
pptx_inventory.py | Inspect objects, layouts, masters, and repeated media hashes |
analyze_geometry.py | Diagnose alignment, spacing, overlap, and size outliers |
validate_recipe.py | Validate edit recipes before a file is changed |
replace_repeated_image.py | Replace confirmed same-format repeated media by SHA-256 |
validate_template_plan.py | Validate template-slide mapping and asset usage |
See the public demo, example recipes, and the complete Skill instructions.
Validation
python3 -m py_compile pptx-batch-editor/scripts/*.py
python3 pptx-batch-editor/scripts/validate_recipe.py examples/logo-swap.recipe.json
python3 pptx-batch-editor/scripts/validate_recipe.py examples/geometry-tidy.recipe.json
python3 pptx-batch-editor/scripts/validate_template_plan.py pptx-batch-editor/assets/template-driven-build.plan.example.json
python3 -m unittest discover -s tests -v
python3 scripts/build_dist.py --check
CI validates the scripts, recipes, template plan, and test suite. A passing CI run does not replace visual inspection in PowerPoint.
License
MIT. See LICENSE. The repository does not bundle customer decks, paid templates, commercial fonts, or unlicensed visual assets.
中文
PPTX Batch Editor 是一个给 Codex 和 Claude 使用的 PowerPoint Skill，面向 PPT/PPTX 批量多页修改：先清点现有文件，把自然语言要求转换成可校验的编辑配方，再批量执行修改并检查渲染结果。
它适合修改已有 PPT，也可以根据用户提供的成品模板制作新 PPT。页面仍然可编辑，不会被拍平成整页图片。
能处理什么
| 你提供 | 它会做 | 你拿到 |
|---|---|---|
| 现有 PPTX + 修改要求 | 清点对象，生成配方，批量修改并验证 | 新的编辑好的PPTX，保留源文件 |
| 成品模板 + 新内容或素材 | 把每张输出页映射到模板页，再修改继承对象 | 保留模板视觉系统的新 PPT |
| PPTX + 排版问题 | 先诊断对齐、间距、重叠和尺寸异常，再执行修改 | 完成对齐、分布、移动或缩放的页面 |
| 只有图片和内容 | 交给宿主演示文稿能力新建 PPT | 素材映射、设计规则和 QA 检查 |
核心优势
| 优势 | 对用户的价值 |
|---|---|
| 批量修改多页 | 一次处理多页中的 Logo、标题、页脚、图片或重复对象，不需要逐页修改。 |
| 保留模板 | 复用原始页面、母版、版式、图表和可编辑对象，不重新画一套相似页面。 |
| 修改范围可控 | 每个操作都有稳定选择器和预期匹配数量，匹配异常就停止。 |
| 自动排版诊断 | 修改前发现近似错位、间距不均、重叠和尺寸异常。 |
| 素材保持原样 | Logo、截图、数据图和产品图不会被当成装饰图重画。 |
| 修改后可验收 | 修改前先清点，修改后检查结构、裁剪、溢出和重叠。 |
| 配方可以复用 | 在新版 PPT 上重新校验后，可以重复执行之前的修改。 |
| 内置脚本零依赖 | 清点、诊断和校验脚本只使用 Python 标准库。 |
快速开始
Codex：
git clone https://github.com/KayZhongyi/pptx-batch-editor.git
mkdir -p ~/.agents/skills
cp -R pptx-batch-editor/pptx-batch-editor ~/.agents/skills/pptx-batch-editor
Claude Code：
git clone https://github.com/KayZhongyi/pptx-batch-editor.git
mkdir -p ~/.claude/skills
cp -R pptx-batch-editor/pptx-batch-editor ~/.claude/skills/pptx-batch-editor
Claude 网页版或 Desktop：下载并上传通用 ZIP。
安装后直接描述任务：
处理 /absolute/path/source.pptx：
1. 替换所有已确认的旧 Logo。
2. 统一同版式页面的标题左对齐。
3. 保留源文件，输出 /absolute/path/updated.pptx。
4. 交付前完成结构和视觉检查。
运行模式
| 模式 | 可以做什么 |
|---|---|
| Codex 或 Claude 提供演示文稿能力 | 根据模板制作、对象级修改、放置素材、复制页面、渲染和视觉检查 |
| 单独运行内置脚本 | 只读清点、几何诊断、配方验证、模板计划验证和精确的同格式重复图片替换 |
完整编辑由 Codex 或 Claude 当前可用的演示文稿能力执行。本地电脑装有并能正常使用 PowerPoint，就可以打开、检查并继续编辑输出文件。
安全流程
- 源文件和输出文件使用不同路径。
- 先清点页面、版式、母版、对象和重复素材。
- 每个操作必须有稳定选择器和
expected_matches。 - 在 PPT 副本上执行修改。
- 渲染并检查所有修改过的页面。
- 无法确认的结果继续修复，或者停止并说明原因。
内置工具
| 工具 | 用途 |
|---|---|
pptx_inventory.py | 清点对象、版式、母版和重复媒体哈希 |
analyze_geometry.py | 诊断对齐、间距、重叠和尺寸异常 |
validate_recipe.py | 修改文件前校验编辑配方 |
replace_repeated_image.py | 按 SHA-256 替换确认过的同格式重复图片 |
validate_template_plan.py | 校验模板页面映射和素材使用 |
本地校验
python3 -m py_compile pptx-batch-editor/scripts/*.py
python3 pptx-batch-editor/scripts/validate_recipe.py examples/logo-swap.recipe.json
python3 pptx-batch-editor/scripts/validate_recipe.py examples/geometry-tidy.recipe.json
python3 pptx-batch-editor/scripts/validate_template_plan.py pptx-batch-editor/assets/template-driven-build.plan.example.json
python3 -m unittest discover -s tests -v
python3 scripts/build_dist.py --check
CI 会检查脚本、示例配方、模板计划和测试套件。CI 通过不代表视觉验收完成，最终效果仍需要使用 PowerPoint 检查。
开源许可
MIT，详见 LICENSE。仓库不包含客户 PPT、付费模板、商业字体或没有明确许可的视觉素材。